google-cloud-billing-v1 0.9.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 856c3ca9b9647e26eba95fc0d8f99b750380342f8304c3203e8b6d684cb18e8a
-  data.tar.gz: d8c0a830ca6e37e97365452a6dff04da711604e90a72f75263a2ce0763181fea
+  metadata.gz: 8af908c3f6293aa7458e5ffaff9cf50e53d60397c67179946cd57ed54df9d7d8
+  data.tar.gz: bab2cf3bf6aec0c15bab4204d020f359a659a1b4b19e12cca07c0a8fefb1f646
 SHA512:
-  metadata.gz: cf656ef864cfd5f6dab20f0fc31b4c0114bcc84b4a75f0af602927b546567b165da0056508fd2e61484c196b4477a7816dd11a72b96ee9c3cdbc61271c7b9f5c
-  data.tar.gz: 1a44b28bbe34b8716744c664343ff41c7e6cb6dee9436e532c3c3e65d99c7f65a6722bd539859ac9aa097cafbcee3fccdaf670637dfa15f0d12d092490265239
+  metadata.gz: 772e1df0b42de029c3a04e36d5c45badf62f88379c0781938b482891b78c1fab678e056e70e93c9d46ebf97155e64192c048c6a62a70673ba1d11a4556e476c1
+  data.tar.gz: 9958ebb1b3676ffaac5a5411c33ea060230238cb804e1102a9e876f8b8abe3a9ae9da3d2545e3f11c941f27cc9abf51512d3c0c5c102966083f69ea8b2ae845e

data/AUTHENTICATION.md

@@ -114,7 +114,7 @@ credentials are discovered.
 To configure your system for this, simply:
 
 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
-2. Authenticate using OAuth 2.0 `$ gcloud auth login`
+2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
 3. Write code as if already authenticated.
 
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK

data/README.md

@@ -1,6 +1,6 @@
 # Ruby Client for the Billing V1 API
 
-API Client library for the Billing V1 API
+Allows developers to manage billing for their Google Cloud Platform projects programmatically.
 
 Allows developers to manage billing for their Google Cloud Platform projects programmatically.
 
@@ -46,7 +46,7 @@ for general usage information.
 ## Enabling Logging
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
-The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
+The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
 or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
 that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
 and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.

data/lib/google/cloud/billing/v1/cloud_billing/client.rb

@@ -27,7 +27,8 @@ module Google
           ##
           # Client for the CloudBilling service.
           #
-          # Retrieves GCP Console billing accounts and associates them with projects.
+          # Retrieves the Google Cloud Console billing accounts and associates them with
+          # projects.
           #
           class Client
             include Paths
@@ -212,8 +213,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The resource name of the billing account to retrieve. For example,
-            #     `billingAccounts/012345-567890-ABCDEF`.
+            #     Required. The resource name of the billing account to retrieve. For
+            #     example, `billingAccounts/012345-567890-ABCDEF`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Billing::V1::BillingAccount]
@@ -334,13 +335,11 @@ module Google
             #   # Call the list_billing_accounts method.
             #   result = client.list_billing_accounts request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::Billing::V1::BillingAccount.
-            #     p response
+            #     p item
             #   end
             #
             def list_billing_accounts request, options = nil
@@ -403,7 +402,8 @@ module Google
             #   @param name [::String]
             #     Required. The name of the billing account resource to be updated.
             #   @param account [::Google::Cloud::Billing::V1::BillingAccount, ::Hash]
-            #     Required. The billing account resource to replace the resource on the server.
+            #     Required. The billing account resource to replace the resource on the
+            #     server.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     The update mask applied to the resource.
             #     Only "display_name" is currently supported.
@@ -473,15 +473,20 @@ module Google
             end
 
             ##
-            # Creates a billing account.
-            # This method can only be used to create
-            # [billing subaccounts](https://cloud.google.com/billing/docs/concepts)
-            # by GCP resellers.
+            # This method creates [billing
+            # subaccounts](https://cloud.google.com/billing/docs/concepts#subaccounts).
+            #
+            # Google Cloud resellers should use the
+            # Channel Services APIs,
+            # [accounts.customers.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers/create)
+            # and
+            # [accounts.customers.entitlements.create](https://cloud.google.com/channel/docs/reference/rest/v1/accounts.customers.entitlements/create).
+            #
             # When creating a subaccount, the current authenticated user must have the
-            # `billing.accounts.update` IAM permission on the master account, which is
+            # `billing.accounts.update` IAM permission on the parent account, which is
             # typically given to billing account
             # [administrators](https://cloud.google.com/billing/docs/how-to/billing-access).
-            # This method will return an error if the master account has not been
+            # This method will return an error if the parent account has not been
             # provisioned as a reseller account.
             #
             # @overload create_billing_account(request, options = nil)
@@ -502,7 +507,7 @@ module Google
             #   @param billing_account [::Google::Cloud::Billing::V1::BillingAccount, ::Hash]
             #     Required. The billing account resource to create.
             #     Currently CreateBillingAccount only supports subaccount creation, so
-            #     any created billing accounts must be under a provided master billing
+            #     any created billing accounts must be under a provided parent billing
             #     account.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -583,8 +588,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The resource name of the billing account associated with the projects that
-            #     you want to list. For example, `billingAccounts/012345-567890-ABCDEF`.
+            #     Required. The resource name of the billing account associated with the
+            #     projects that you want to list. For example,
+            #     `billingAccounts/012345-567890-ABCDEF`.
             #   @param page_size [::Integer]
             #     Requested page size. The maximum page size is 100; this is also the
             #     default.
@@ -613,13 +619,11 @@ module Google
             #   # Call the list_project_billing_info method.
             #   result = client.list_project_billing_info request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::Billing::V1::ProjectBillingInfo.
-            #     p response
+            #     p item
             #   end
             #
             def list_project_billing_info request, options = nil
@@ -666,9 +670,10 @@ module Google
 
             ##
             # Gets the billing information for a project. The current authenticated user
-            # must have [permission to view the
-            # project](https://cloud.google.com/docs/permissions-overview#h.bgs0oxofvnoo
-            # ).
+            # must have the `resourcemanager.projects.get` permission for the project,
+            # which can be granted by assigning the [Project
+            # Viewer](https://cloud.google.com/iam/docs/understanding-roles#predefined_roles)
+            # role.
             #
             # @overload get_project_billing_info(request, options = nil)
             #   Pass arguments to `get_project_billing_info` via a request object, either of type
@@ -763,7 +768,7 @@ module Google
             # usage charges.
             #
             # *Note:* Incurred charges that have not yet been reported in the transaction
-            # history of the GCP Console might be billed to the new billing
+            # history of the Google Cloud Console might be billed to the new billing
             # account, even if the charge occurred before the new billing account was
             # assigned to the project.
             #
@@ -802,8 +807,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The resource name of the project associated with the billing information
-            #     that you want to update. For example, `projects/tokyo-rain-123`.
+            #     Required. The resource name of the project associated with the billing
+            #     information that you want to update. For example,
+            #     `projects/tokyo-rain-123`.
             #   @param project_billing_info [::Google::Cloud::Billing::V1::ProjectBillingInfo, ::Hash]
             #     The new billing information for the project. Read-only fields are ignored;
             #     thus, you can leave empty all fields except `billing_account_name`.

data/lib/google/cloud/billing/v1/cloud_billing/credentials.rb

@@ -26,6 +26,8 @@ module Google
           # Credentials for the CloudBilling API.
           class Credentials < ::Google::Auth::Credentials
             self.scope = [
+              "https://www.googleapis.com/auth/cloud-billing",
+              "https://www.googleapis.com/auth/cloud-billing.readonly",
               "https://www.googleapis.com/auth/cloud-platform"
             ]
             self.env_vars = [