google-cloud-billing-budgets-v1beta1 0.6.1 → 0.6.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8da1c6e522919f540f03478792a3fb9db1205782459a58d5943d48905daa1f5e
-  data.tar.gz: 1471a2a295b72ce71dd908bdda9706dca141cc8c132a55c98e8c9b8e328575fa
+  metadata.gz: 2f0a019923807b193b37f5a0e7a94e97f54e2bbc89c9ce752c43e8fbcd6d9160
+  data.tar.gz: a8379506fdfb24b54eccf0565d2f99afa0024887335b3d8817fd00936bddf223
 SHA512:
-  metadata.gz: a8087e67aad748be0993aff6bcd41da358fc6b814c0a80c7c2f0b8d7266a2c04d940ee6c073753b96c684dcfb57aecca738a4e0a81c793a02361580cc93d67b7
-  data.tar.gz: 54a15527a75427d488c9ea3fbd774e065c44fd6a545948dbe76a29157cfa72ccabd89ef8932cab0aed836c2a742e9ab8de5bf02c11870a69502bc42694cec8a7
+  metadata.gz: 5b9a2259f7f81933a6421e1503bef5e27a2e30067446ec95fd2b880f786e030efd570d09e91c44b0675462026600295d4a36d1b9ddea6f764af9d1a14b3c57e5
+  data.tar.gz: 8d5a140112dbd81ed42b2d635345cefb630a711c8eed9317e1988e64684e6a34ed1329aee026d3b651c316bc9030b148ccf3e17323ef96492b37918bec1aeb9b

data/.yardopts

@@ -1,5 +1,5 @@
 --no-private
---title=Billing Budgets V1beta1 API
+--title="Billing Budgets V1beta1 API"
 --exclude _pb\.rb$
 --markup markdown
 --markup-provider redcarpet

data/AUTHENTICATION.md

@@ -120,15 +120,6 @@ To configure your system for this, simply:
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
 *should* only be used during development.
 
-[gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
-[dev-console]: https://console.cloud.google.com/project
-
-[enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
-
-[create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
-[create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
-[reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
-
 ## Creating a Service Account
 
 Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
 [Google Cloud Platform environments](#google-cloud-platform-environments), you
 need a Google Developers service account.
 
-1. Visit the [Google Developers Console][dev-console].
+1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
 2. Create a new project or click on an existing project.
-3. Activate the slide-out navigation tray and select **API Manager**. From
+3. Activate the menu in the upper left and select **APIs & Services**. From
    here, you will enable the APIs that your application requires.
 
-   ![Enable the APIs that your application requires][enable-apis]
-
    *Note: You may need to enable billing in order to use these services.*
 
 4. Select **Credentials** from the side navigation.
 
-   You should see a screen like one of the following.
-
-   ![Create a new service account][create-new-service-account]
-
-   ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
-
-   Find the "Add credentials" drop down and select "Service account" to be
-   guided through downloading a new JSON key file.
+   Find the "Create credentials" drop down near the top of the page, and select
+   "Service account" to be guided through downloading a new JSON key file.
 
    If you want to re-use an existing service account, you can easily generate a
-   new key file. Just select the account you wish to re-use, and click "Generate
-   new JSON key":
-
-   ![Re-use an existing service account][reuse-service-account]
+   new key file. Just select the account you wish to re-use, click the pencil
+   tool on the right side to edit the service account, select the **Keys** tab,
+   and then select **Add Key**.
 
    The key file you download will be used by this library to authenticate API
    requests and should be stored in a secure location.

data/README.md

@@ -37,7 +37,7 @@ request = ::Google::Cloud::Billing::Budgets::V1beta1::CreateBudgetRequest.new #
 response = client.create_budget request
 ```
 
-View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-billing-budgets-v1beta1/latest)
+View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-billing-budgets-v1beta1/latest)
 for class and method documentation.
 
 See also the [Product Documentation](https://cloud.google.com/billing/docs/how-to/budget-api-overview)

data/lib/google/cloud/billing/budgets/v1beta1/budget_model_pb.rb

@@ -1,13 +1,13 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/billing/budgets/v1beta1/budget_model.proto
 
-require 'google/protobuf'
-
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/protobuf/struct_pb'
 require 'google/type/date_pb'
 require 'google/type/money_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/billing/budgets/v1beta1/budget_model.proto", :syntax => :proto3) do
     add_message "google.cloud.billing.budgets.v1beta1.Budget" do

data/lib/google/cloud/billing/budgets/v1beta1/budget_service/client.rb

@@ -43,13 +43,12 @@ module Google
               # See {::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client::Configuration}
               # for a description of the configuration fields.
               #
-              # ## Example
+              # @example
               #
-              # To modify the configuration for all BudgetService clients:
-              #
-              #     ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Modify the configuration for all BudgetService clients
+              #   ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the Client client.
               # @yieldparam config [Client::Configuration]
@@ -118,19 +117,15 @@ module Google
               ##
               # Create a new BudgetService client object.
               #
-              # ## Examples
-              #
-              # To create a new BudgetService client with the default
-              # configuration:
-              #
-              #     client = ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new
+              # @example
               #
-              # To create a new BudgetService client with a custom
-              # configuration:
+              #   # Create a client using the default configuration
+              #   client = ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new
               #
-              #     client = ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Create a client using a custom configuration
+              #   client = ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the BudgetService client.
               # @yieldparam config [Client::Configuration]
@@ -150,10 +145,9 @@ module Google
 
                 # Create credentials
                 credentials = @config.credentials
-                # Use self-signed JWT if the scope and endpoint are unchanged from default,
+                # 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.scope == Client.configure.scope &&
-                                         @config.endpoint == Client.configure.endpoint &&
+                enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                                          !@config.endpoint.split(".").first.include?("-")
                 credentials ||= Credentials.default scope: @config.scope,
                                                     enable_self_signed_jwt: enable_self_signed_jwt
@@ -176,7 +170,7 @@ module Google
 
               ##
               # Creates a new budget. See
-              # <a href="https://cloud.google.com/billing/quotas">Quotas and limits</a>
+              # [Quotas and limits](https://cloud.google.com/billing/quotas)
               # for more information on the limits of the number of budgets you can create.
               #
               # @overload create_budget(request, options = nil)
@@ -208,6 +202,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/billing/budgets/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Billing::Budgets::V1beta1::CreateBudgetRequest.new
+              #
+              #   # Call the create_budget method.
+              #   result = client.create_budget request
+              #
+              #   # The returned object is of type Google::Cloud::Billing::Budgets::V1beta1::Budget.
+              #   p result
+              #
               def create_budget request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -225,16 +234,20 @@ module Google
                   gapic_version: ::Google::Cloud::Billing::Budgets::V1beta1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "parent" => request.parent
-                }
+                header_params = {}
+                if request.parent
+                  header_params["parent"] = request.parent
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
                 options.apply_defaults timeout:      @config.rpcs.create_budget.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.create_budget.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @budget_service_stub.call_rpc :create_budget, request, options: options do |response, operation|
@@ -286,6 +299,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/billing/budgets/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Billing::Budgets::V1beta1::UpdateBudgetRequest.new
+              #
+              #   # Call the update_budget method.
+              #   result = client.update_budget request
+              #
+              #   # The returned object is of type Google::Cloud::Billing::Budgets::V1beta1::Budget.
+              #   p result
+              #
               def update_budget request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -303,16 +331,20 @@ module Google
                   gapic_version: ::Google::Cloud::Billing::Budgets::V1beta1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "budget.name" => request.budget.name
-                }
+                header_params = {}
+                if request.budget&.name
+                  header_params["budget.name"] = request.budget.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
                 options.apply_defaults timeout:      @config.rpcs.update_budget.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.update_budget.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @budget_service_stub.call_rpc :update_budget, request, options: options do |response, operation|
@@ -358,6 +390,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/billing/budgets/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Billing::Budgets::V1beta1::GetBudgetRequest.new
+              #
+              #   # Call the get_budget method.
+              #   result = client.get_budget request
+              #
+              #   # The returned object is of type Google::Cloud::Billing::Budgets::V1beta1::Budget.
+              #   p result
+              #
               def get_budget request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -375,16 +422,20 @@ module Google
                   gapic_version: ::Google::Cloud::Billing::Budgets::V1beta1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "name" => request.name
-                }
+                header_params = {}
+                if request.name
+                  header_params["name"] = request.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
                 options.apply_defaults timeout:      @config.rpcs.get_budget.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.get_budget.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @budget_service_stub.call_rpc :get_budget, request, options: options do |response, operation|
@@ -437,6 +488,27 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/billing/budgets/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Billing::Budgets::V1beta1::ListBudgetsRequest.new
+              #
+              #   # Call the list_budgets method.
+              #   result = client.list_budgets 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|
+              #     # Each element is of type ::Google::Cloud::Billing::Budgets::V1beta1::Budget.
+              #     p response
+              #   end
+              #
               def list_budgets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -454,16 +526,20 @@ module Google
                   gapic_version: ::Google::Cloud::Billing::Budgets::V1beta1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "parent" => request.parent
-                }
+                header_params = {}
+                if request.parent
+                  header_params["parent"] = request.parent
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
                 options.apply_defaults timeout:      @config.rpcs.list_budgets.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.list_budgets.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @budget_service_stub.call_rpc :list_budgets, request, options: options do |response, operation|
@@ -505,6 +581,21 @@ module Google
               #
               # @raise [::Google::Cloud::Error] if the RPC is aborted.
               #
+              # @example Basic example
+              #   require "google/cloud/billing/budgets/v1beta1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Billing::Budgets::V1beta1::DeleteBudgetRequest.new
+              #
+              #   # Call the delete_budget method.
+              #   result = client.delete_budget request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_budget request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -522,16 +613,20 @@ module Google
                   gapic_version: ::Google::Cloud::Billing::Budgets::V1beta1::VERSION
                 metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-                header_params = {
-                  "name" => request.name
-                }
+                header_params = {}
+                if request.name
+                  header_params["name"] = request.name
+                end
+
                 request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
                 metadata[:"x-goog-request-params"] ||= request_params_header
 
                 options.apply_defaults timeout:      @config.rpcs.delete_budget.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.delete_budget.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @budget_service_stub.call_rpc :delete_budget, request, options: options do |response, operation|
@@ -555,22 +650,21 @@ module Google
               # Configuration can be applied globally to all clients, or to a single client
               # on construction.
               #
-              # # Examples
-              #
-              # To modify the global config, setting the timeout for create_budget
-              # to 20 seconds, and all remaining timeouts to 10 seconds:
-              #
-              #     ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.create_budget.timeout = 20.0
-              #     end
-              #
-              # To apply the above configuration only to a new client:
-              #
-              #     client = ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.create_budget.timeout = 20.0
-              #     end
+              # @example
+              #
+              #   # Modify the global config, setting the timeout for
+              #   # create_budget to 20 seconds,
+              #   # and all remaining timeouts to 10 seconds.
+              #   ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.create_budget.timeout = 20.0
+              #   end
+              #
+              #   # Apply the above configuration only to a new client.
+              #   client = ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.create_budget.timeout = 20.0
+              #   end
               #
               # @!attribute [rw] endpoint
               #   The hostname or hostname:port of the service endpoint.

data/lib/google/cloud/billing/budgets/v1beta1/budget_service_pb.rb

@@ -1,8 +1,6 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/billing/budgets/v1beta1/budget_service.proto
 
-require 'google/protobuf'
-
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -10,6 +8,8 @@ require 'google/api/resource_pb'
 require 'google/cloud/billing/budgets/v1beta1/budget_model_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
+require 'google/protobuf'
+
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/billing/budgets/v1beta1/budget_service.proto", :syntax => :proto3) do
     add_message "google.cloud.billing.budgets.v1beta1.CreateBudgetRequest" do

data/lib/google/cloud/billing/budgets/v1beta1/budget_service_services_pb.rb

@@ -29,14 +29,14 @@ module Google
             # budget plan and rules to execute as we track spend against that plan.
             class Service
 
-              include GRPC::GenericService
+              include ::GRPC::GenericService
 
               self.marshal_class_method = :encode
               self.unmarshal_class_method = :decode
               self.service_name = 'google.cloud.billing.budgets.v1beta1.BudgetService'
 
               # Creates a new budget. See
-              # <a href="https://cloud.google.com/billing/quotas">Quotas and limits</a>
+              # [Quotas and limits](https://cloud.google.com/billing/quotas)
               # for more information on the limits of the number of budgets you can create.
               rpc :CreateBudget, ::Google::Cloud::Billing::Budgets::V1beta1::CreateBudgetRequest, ::Google::Cloud::Billing::Budgets::V1beta1::Budget
               # Updates a budget and returns the updated budget.

data/lib/google/cloud/billing/budgets/v1beta1/version.rb

@@ -22,7 +22,7 @@ module Google
     module Billing
       module Budgets
         module V1beta1
-          VERSION = "0.6.1"
+          VERSION = "0.6.5"
         end
       end
     end

data/proto_docs/google/api/resource.rb

@@ -33,11 +33,7 @@ module Google
     #       // For Kubernetes resources, the format is {api group}/{kind}.
     #       option (google.api.resource) = {
     #         type: "pubsub.googleapis.com/Topic"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
+    #         pattern: "projects/{project}/topics/{topic}"
     #       };
     #     }
     #
@@ -45,10 +41,7 @@ module Google
     #
     #     resources:
     #     - type: "pubsub.googleapis.com/Topic"
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
+    #       pattern: "projects/{project}/topics/{topic}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -58,26 +51,10 @@ module Google
     #     message LogEntry {
     #       option (google.api.resource) = {
     #         type: "logging.googleapis.com/LogEntry"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #         }
+    #         pattern: "projects/{project}/logs/{log}"
+    #         pattern: "folders/{folder}/logs/{log}"
+    #         pattern: "organizations/{organization}/logs/{log}"
+    #         pattern: "billingAccounts/{billing_account}/logs/{log}"
     #       };
     #     }
     #
@@ -85,48 +62,10 @@ module Google
     #
     #     resources:
     #     - type: 'logging.googleapis.com/LogEntry'
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         - pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         - pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         - pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #
-    # For flexible resources, the resource name doesn't contain parent names, but
-    # the resource itself has parents for policy evaluation.
-    #
-    # Example:
-    #
-    #     message Shelf {
-    #       option (google.api.resource) = {
-    #         type: "library.googleapis.com/Shelf"
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #         }
-    #       };
-    #     }
-    #
-    # The ResourceDescriptor Yaml config will look like:
-    #
-    #     resources:
-    #     - type: 'library.googleapis.com/Shelf'
-    #       name_descriptor:
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #       pattern: "projects/{project}/logs/{log}"
+    #       pattern: "folders/{folder}/logs/{log}"
+    #       pattern: "organizations/{organization}/logs/{log}"
+    #       pattern: "billingAccounts/{billing_account}/logs/{log}"
     # @!attribute [rw] type
     #   @return [::String]
     #     The resource type. It must be in the format of

data/proto_docs/google/cloud/billing/budgets/v1beta1/budget_model.rb

@@ -38,9 +38,9 @@ module Google
           #     Validation: <= 60 chars.
           # @!attribute [rw] budget_filter
           #   @return [::Google::Cloud::Billing::Budgets::V1beta1::Filter]
-          #     Optional. Filters that define which resources are used to compute the
-          #     actual spend against the budget amount, such as projects, services, and the
-          #     budget's time period, as well as other filters.
+          #     Optional. Filters that define which resources are used to compute the actual spend
+          #     against the budget amount, such as projects, services, and the budget's
+          #     time period, as well as other filters.
           # @!attribute [rw] amount
           #   @return [::Google::Cloud::Billing::Budgets::V1beta1::BudgetAmount]
           #     Required. Budgeted amount.
@@ -48,10 +48,13 @@ module Google
           #   @return [::Array<::Google::Cloud::Billing::Budgets::V1beta1::ThresholdRule>]
           #     Optional. Rules that trigger alerts (notifications of thresholds
           #     being crossed) when spend exceeds the specified percentages of the budget.
+          #
+          #     Optional for `pubsubTopic` notifications.
+          #
+          #     Required if using email notifications.
           # @!attribute [rw] all_updates_rule
           #   @return [::Google::Cloud::Billing::Budgets::V1beta1::AllUpdatesRule]
-          #     Optional. Rules to apply to notifications sent based on budget spend and
-          #     thresholds.
+          #     Optional. Rules to apply to notifications sent based on budget spend and thresholds.
           # @!attribute [rw] etag
           #   @return [::String]
           #     Optional. Etag to validate that the object is unchanged for a
@@ -74,35 +77,47 @@ module Google
           #   @return [::Google::Cloud::Billing::Budgets::V1beta1::LastPeriodAmount]
           #     Use the last period's actual spend as the budget for the present period.
           #     LastPeriodAmount can only be set when the budget's time period is a
-          #     {::Google::Cloud::Billing::Budgets::V1beta1::Filter#calendar_period Filter.calendar_period}.
-          #     It cannot be set in combination with
+          #     {::Google::Cloud::Billing::Budgets::V1beta1::Filter#calendar_period Filter.calendar_period}. It cannot be set in combination with
           #     {::Google::Cloud::Billing::Budgets::V1beta1::Filter#custom_period Filter.custom_period}.
           class BudgetAmount
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # Describes a budget amount targeted to the last
-          # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#calendar_period Filter.calendar_period}
+          # Describes a budget amount targeted to the last {::Google::Cloud::Billing::Budgets::V1beta1::Filter#calendar_period Filter.calendar_period}
           # spend. At this time, the amount is automatically 100% of the last calendar
           # period's spend; that is, there are no other options yet.
           # Future configuration options will be described here (for example, configuring
           # a percentage of last period's spend).
           # LastPeriodAmount cannot be set for a budget configured with
-          # a
-          # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#custom_period Filter.custom_period}.
+          # a {::Google::Cloud::Billing::Budgets::V1beta1::Filter#custom_period Filter.custom_period}.
           class LastPeriodAmount
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # ThresholdRule contains a definition of a threshold which triggers
-          # an alert (a notification of a threshold being crossed) to be sent when
-          # spend goes above the specified amount.
-          # Alerts are automatically e-mailed to users with the Billing Account
-          # Administrator role or the Billing Account User role.
-          # The thresholds here have no effect on notifications sent to anything
-          # configured under `Budget.all_updates_rule`.
+          # ThresholdRule contains the definition of a threshold. Threshold rules define
+          # the triggering events used to generate a budget notification email. When a
+          # threshold is crossed (spend exceeds the specified percentages of the
+          # budget), budget alert emails are sent to the email recipients you specify
+          # in the
+          # [NotificationsRule](#notificationsrule).
+          #
+          # Threshold rules also affect the fields included in the
+          # [JSON data
+          # object](https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification_format)
+          # sent to a Pub/Sub topic.
+          #
+          # Threshold rules are _required_ if using email notifications.
+          #
+          # Threshold rules are _optional_ if only setting a
+          # [`pubsubTopic` NotificationsRule](#NotificationsRule),
+          # unless you want your JSON data object to include data about the thresholds
+          # you set.
+          #
+          # For more information, see
+          # [set budget threshold rules and
+          # actions](https://cloud.google.com/billing/docs/how-to/budgets#budget-actions).
           # @!attribute [rw] threshold_percent
           #   @return [::Float]
           #     Required. Send an alert when this threshold is exceeded.
@@ -127,8 +142,7 @@ module Google
               # Use forecasted spend for the period as the basis for comparison against
               # the threshold.
               # FORECASTED_SPEND can only be set when the budget's time period is a
-              # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#calendar_period Filter.calendar_period}.
-              # It cannot be set in combination with
+              # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#calendar_period Filter.calendar_period}.  It cannot be set in combination with
               # {::Google::Cloud::Billing::Budgets::V1beta1::Filter#custom_period Filter.custom_period}.
               FORECASTED_SPEND = 2
             end
@@ -138,10 +152,10 @@ module Google
           # and thresholds.
           # @!attribute [rw] pubsub_topic
           #   @return [::String]
-          #     Optional. The name of the Pub/Sub topic where budget related messages will
-          #     be published, in the form `projects/{project_id}/topics/{topic_id}`.
-          #     Updates are sent at regular intervals to the topic. The topic needs to be
-          #     created before the budget is created; see
+          #     Optional. The name of the Pub/Sub topic where budget related messages will be
+          #     published, in the form `projects/{project_id}/topics/{topic_id}`. Updates
+          #     are sent at regular intervals to the topic.
+          #     The topic needs to be created before the budget is created; see
           #     https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications
           #     for more details.
           #     Caller is expected to have
@@ -151,28 +165,25 @@ module Google
           #     for more details on Pub/Sub roles and permissions.
           # @!attribute [rw] schema_version
           #   @return [::String]
-          #     Optional. Required when
-          #     {::Google::Cloud::Billing::Budgets::V1beta1::AllUpdatesRule#pubsub_topic AllUpdatesRule.pubsub_topic}
-          #     is set. The schema version of the notification sent to
-          #     {::Google::Cloud::Billing::Budgets::V1beta1::AllUpdatesRule#pubsub_topic AllUpdatesRule.pubsub_topic}.
-          #     Only "1.0" is accepted. It represents the JSON schema as defined in
+          #     Optional. Required when {::Google::Cloud::Billing::Budgets::V1beta1::AllUpdatesRule#pubsub_topic AllUpdatesRule.pubsub_topic} is set. The schema version of
+          #     the notification sent to {::Google::Cloud::Billing::Budgets::V1beta1::AllUpdatesRule#pubsub_topic AllUpdatesRule.pubsub_topic}. Only "1.0" is
+          #     accepted. It represents the JSON schema as defined in
           #     https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#notification_format.
           # @!attribute [rw] monitoring_notification_channels
           #   @return [::Array<::String>]
-          #     Optional. Targets to send notifications to when a threshold is exceeded.
-          #     This is in addition to default recipients who have billing account IAM
-          #     roles. The value is the full REST resource name of a monitoring
-          #     notification channel with the form
+          #     Optional. Targets to send notifications to when a threshold is exceeded. This is in
+          #     addition to default recipients who have billing account IAM roles.
+          #     The value is the full REST resource name of a monitoring notification
+          #     channel with the form
           #     `projects/{project_id}/notificationChannels/{channel_id}`. A maximum of 5
           #     channels are allowed. See
           #     https://cloud.google.com/billing/docs/how-to/budgets-notification-recipients
           #     for more details.
           # @!attribute [rw] disable_default_iam_recipients
           #   @return [::Boolean]
-          #     Optional. When set to true, disables default notifications sent when a
-          #     threshold is exceeded. Default notifications are sent to those with Billing
-          #     Account Administrator and Billing Account User IAM roles for the target
-          #     account.
+          #     Optional. When set to true, disables default notifications sent when a threshold is
+          #     exceeded. Default notifications are sent to those with Billing Account
+          #     Administrator and Billing Account User IAM roles for the target account.
           class AllUpdatesRule
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -188,16 +199,14 @@ module Google
           #     Only zero or one project can be specified currently.
           # @!attribute [rw] credit_types
           #   @return [::Array<::String>]
-          #     Optional. If
-          #     {::Google::Cloud::Billing::Budgets::V1beta1::Filter#credit_types_treatment Filter.credit_types_treatment}
-          #     is INCLUDE_SPECIFIED_CREDITS, this is a list of credit types to be
-          #     subtracted from gross cost to determine the spend for threshold
-          #     calculations. See [a list of acceptable credit type
+          #     Optional. If {::Google::Cloud::Billing::Budgets::V1beta1::Filter#credit_types_treatment Filter.credit_types_treatment} is INCLUDE_SPECIFIED_CREDITS, this is
+          #     a list of credit types to be subtracted from gross cost to determine the
+          #     spend for threshold calculations. See
+          #     [a list of acceptable credit type
           #     values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
           #
-          #     If
-          #     {::Google::Cloud::Billing::Budgets::V1beta1::Filter#credit_types_treatment Filter.credit_types_treatment}
-          #     is **not** INCLUDE_SPECIFIED_CREDITS, this field must be empty.
+          #     If {::Google::Cloud::Billing::Budgets::V1beta1::Filter#credit_types_treatment Filter.credit_types_treatment} is **not** INCLUDE_SPECIFIED_CREDITS,
+          #     this field must be empty.
           # @!attribute [rw] credit_types_treatment
           #   @return [::Google::Cloud::Billing::Budgets::V1beta1::Filter::CreditTypesTreatment]
           #     Optional. If not set, default behavior is `INCLUDE_ALL_CREDITS`.
@@ -211,18 +220,23 @@ module Google
           #     https://cloud.google.com/billing/v1/how-tos/catalog-api.
           # @!attribute [rw] subaccounts
           #   @return [::Array<::String>]
-          #     Optional. A set of subaccounts of the form `billingAccounts/{account_id}`,
-          #     specifying that usage from only this set of subaccounts should be included
-          #     in the budget. If a subaccount is set to the name of the parent account,
+          #     Optional. A set of subaccounts of the form `billingAccounts/{account_id}`, specifying
+          #     that usage from only this set of subaccounts should be included in the
+          #     budget. If a subaccount is set to the name of the parent account,
           #     usage from the parent account will be included. If omitted, the
           #     report will include usage from the parent account and all
           #     subaccounts, if they exist.
           # @!attribute [rw] labels
           #   @return [::Google::Protobuf::Map{::String => ::Google::Protobuf::ListValue}]
-          #     Optional. A single label and value pair specifying that usage from only
-          #     this set of labeled resources should be included in the budget. Currently,
-          #     multiple entries or multiple values per entry are not allowed. If omitted,
-          #     the report will include all labeled and unlabeled usage.
+          #     Optional. A single label and value pair specifying that usage from only this set of
+          #     labeled resources should be included in the budget. If omitted, the
+          #     report will include all labeled and unlabeled usage.
+          #
+          #     An object containing a single `"key": value` pair. Example: `{ "name":
+          #     "wrench" }`.
+          #
+          #      _Currently, multiple entries or multiple values per entry are not
+          #      allowed._
           # @!attribute [rw] calendar_period
           #   @return [::Google::Cloud::Billing::Budgets::V1beta1::CalendarPeriod]
           #     Optional. Specifies to track usage for recurring calendar period.
@@ -233,8 +247,8 @@ module Google
           #     so on.
           # @!attribute [rw] custom_period
           #   @return [::Google::Cloud::Billing::Budgets::V1beta1::CustomPeriod]
-          #     Optional. Specifies to track usage from any start date (required) to any
-          #     end date (optional). This time period is static, it does not recur.
+          #     Optional. Specifies to track usage from any start date (required) to any end date
+          #     (optional). This time period is static, it does not recur.
           class Filter
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -278,9 +292,9 @@ module Google
           #     Required. The start date must be after January 1, 2017.
           # @!attribute [rw] end_date
           #   @return [::Google::Type::Date]
-          #     Optional. The end date of the time period. Budgets with elapsed end date
-          #     won't be processed. If unset, specifies to track all usage incurred since
-          #     the start_date.
+          #     Optional. The end date of the time period. Budgets with elapsed end date won't be
+          #     processed. If unset, specifies to track all usage
+          #     incurred since the start_date.
           class CustomPeriod
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -291,6 +305,8 @@ module Google
           # `CalendarPeriod`". All calendar times begin at 12 AM US and Canadian
           # Pacific Time (UTC-8).
           module CalendarPeriod
+            # Calendar period is unset. This is the default if the budget is for a
+            # custom time period (CustomPeriod).
             CALENDAR_PERIOD_UNSPECIFIED = 0
 
             # A month. Month starts on the first day of each month, such as January 1,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-billing-budgets-v1beta1
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.6.5
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-12 00:00:00.000000000 Z
+date: 2022-02-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.7'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.7'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -208,7 +208,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: API Client library for the Billing Budgets V1beta1 API