google-cloud-billing-v1 0.10.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d5d09e6b80c1c7253a34912a55c87335062a3c7f8934ca0330c1fc8bb170aafc
-  data.tar.gz: 7c9acff077fcee48d8e581ce50cf74404d27b0f7ad846491fc24131c6a455477
+  metadata.gz: 75169da47651b8aaf8c1566b0ce1c858d3dcb893d4c7b7eaad691a27c1ec67cc
+  data.tar.gz: 8e7512b59892b697d879c444c718e0aebe07094170cbe57109baaab692b0f3c5
 SHA512:
-  metadata.gz: f906aa45ca02904e554c00c7d21f4112c04cebfb4ad23a7664d962941a74412d97e88c2c384114ce06aac6ecc672d3ae0aaa2b41d312e00ce81b8eb6441b0758
-  data.tar.gz: 8604f25706da081b7e0e8b5afb8f185d0d5643db636b952e88f8469bbf4dd02592b74c85730ff4c968300b824195fd66e60b1a0853214b76890987da6bab3bde
+  metadata.gz: d86b0238a45b3b93548827e25839c72fcaa05ad3d7c75953a48fbceb1d08f140af1fc5994259dccb63be22c25032136cd06c129e989afb73afa4ce54d5540350
+  data.tar.gz: 611b877e54c057bdfb756c254543388371085a995dc0af57f984f85998b4f9877ce342f1123694e055a985bedb21a720ffbd8fbb742f6d387a0bdeb31d23590c

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,8 +46,8 @@ 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,
-or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
+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://cloud.google.com/ruby/docs/reference/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

@@ -171,7 +171,7 @@ module Google
               credentials = @config.credentials
               # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
@@ -213,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]
@@ -335,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
@@ -404,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.
@@ -589,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.
@@ -619,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
@@ -809,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`.
@@ -1203,9 +1202,9 @@ module Google
             #    *  (`String`) The path to a service account key file in JSON format
             #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
+            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
+            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials
@@ -1247,7 +1246,9 @@ module Google
             class Configuration
               extend ::Gapic::Config
 
-              config_attr :endpoint,      "cloudbilling.googleapis.com", ::String
+              DEFAULT_ENDPOINT = "cloudbilling.googleapis.com"
+
+              config_attr :endpoint,      DEFAULT_ENDPOINT, ::String
               config_attr :credentials,   nil do |value|
                 allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC