google-cloud-billing-budgets-v1beta1 0.5.0 → 0.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b29b0eec5f8684e7a46dbd8cfed7cf761669abd1d9cf1e5a7f9c74900b7dfd2
-  data.tar.gz: 2728272dae7981e0223524967184928c14f82cc99eae310774e49ba4c75fd9cc
+  metadata.gz: f61b90907e8f6657d0ff0fa4ca319f8891697c149953328e5a758de53a2968dd
+  data.tar.gz: f821c2fcaaa363b15818f8b3e54245cf7c2d7b899c88a2613729d0caf752b56d
 SHA512:
-  metadata.gz: 1c6b468271b79eba0862a14d414bfd2892ed6f1408519aa16ec9b749f928aa2d57067f4c1c227ad523bbc029cc4b938e5021086e8e8248e44f7764b80b793ea7
-  data.tar.gz: f9122d34bee7eae3bf6ae43cc54670de56fcdefd115193d35be63589cab8cac48cad3b91fcc0f4858f717ecd1a1a6bd8d1e710eaf97653c484cbaef8db19e0c4
+  metadata.gz: e05e9c4062902b494ae679597d535fd73f8d82f7ef62c8eb2e8b050d397554f808d2b2e8728d2b9510d5b2fa8799efbcfd0c4f8d3ddc84f3998d04fd5a58213b
+  data.tar.gz: 38e15bc18d8f793aaf45217d637126cb733bf0bd2172be666cf667204498e8e52bc0a2608a2130d7bbc68a0b01b5e2094941affe6d155885eda3e066442e36c9

data/AUTHENTICATION.md

@@ -66,11 +66,11 @@ The environment variables that google-cloud-billing-budgets-v1beta1
 checks for credentials are configured on the service Credentials class (such as
 {::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Credentials}):
 
-1. `BILLING_BUDGETS_CREDENTIALS` - Path to JSON file, or JSON contents
-2. `BILLING_BUDGETS_KEYFILE` - Path to JSON file, or JSON contents
-3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
-4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
-5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
+* `BILLING_BUDGETS_CREDENTIALS` - Path to JSON file, or JSON contents
+* `BILLING_BUDGETS_KEYFILE` - Path to JSON file, or JSON contents
+* `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
+* `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
+* `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
 
 ```ruby
 require "google/cloud/billing/budgets/v1beta1"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new
 
 ### Configuration
 
-The **Credentials JSON** can be configured instead of placing them in
-environment variables. Either on an individual client initialization:
+The path to the **Credentials JSON** file can be configured instead of storing
+it in an environment variable. Either on an individual client initialization:
 
 ```ruby
 require "google/cloud/billing/budgets/v1beta1"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new d
 end
 ```
 
-Or configured globally for all clients:
+Or globally for all clients:
 
 ```ruby
 require "google/cloud/billing/budgets/v1beta1"

data/README.md

@@ -33,7 +33,7 @@ In order to use this library, you first need to go through the following steps:
 require "google/cloud/billing/budgets/v1beta1"
 
 client = ::Google::Cloud::Billing::Budgets::V1beta1::BudgetService::Client.new
-request = my_create_request
+request = ::Google::Cloud::Billing::Budgets::V1beta1::CreateBudgetRequest.new # (request fields as keyword arguments...)
 response = client.create_budget request
 ```
 

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

@@ -1,12 +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
@@ -48,6 +49,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :services, :string, 3
       repeated :subaccounts, :string, 5
       map :labels, :string, :message, 6, "google.protobuf.ListValue"
+      oneof :usage_period do
+        optional :calendar_period, :enum, 8, "google.cloud.billing.budgets.v1beta1.CalendarPeriod"
+        optional :custom_period, :message, 9, "google.cloud.billing.budgets.v1beta1.CustomPeriod"
+      end
     end
     add_enum "google.cloud.billing.budgets.v1beta1.Filter.CreditTypesTreatment" do
       value :CREDIT_TYPES_TREATMENT_UNSPECIFIED, 0
@@ -55,6 +60,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :EXCLUDE_ALL_CREDITS, 2
       value :INCLUDE_SPECIFIED_CREDITS, 3
     end
+    add_message "google.cloud.billing.budgets.v1beta1.CustomPeriod" do
+      optional :start_date, :message, 1, "google.type.Date"
+      optional :end_date, :message, 2, "google.type.Date"
+    end
+    add_enum "google.cloud.billing.budgets.v1beta1.CalendarPeriod" do
+      value :CALENDAR_PERIOD_UNSPECIFIED, 0
+      value :MONTH, 1
+      value :QUARTER, 2
+      value :YEAR, 3
+    end
   end
 end
 
@@ -71,6 +86,8 @@ module Google
           AllUpdatesRule = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.billing.budgets.v1beta1.AllUpdatesRule").msgclass
           Filter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.billing.budgets.v1beta1.Filter").msgclass
           Filter::CreditTypesTreatment = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.billing.budgets.v1beta1.Filter.CreditTypesTreatment").enummodule
+          CustomPeriod = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.billing.budgets.v1beta1.CustomPeriod").msgclass
+          CalendarPeriod = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.billing.budgets.v1beta1.CalendarPeriod").enummodule
         end
       end
     end

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]
@@ -71,34 +70,22 @@ module Google
 
                   default_config.rpcs.update_budget.timeout = 60.0
                   default_config.rpcs.update_budget.retry_policy = {
-                    initial_delay: 0.1,
-                max_delay: 60.0,
-                multiplier: 1.3,
-                retry_codes: [4, 14]
+                    initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
                   default_config.rpcs.get_budget.timeout = 60.0
                   default_config.rpcs.get_budget.retry_policy = {
-                    initial_delay: 0.1,
-                max_delay: 60.0,
-                multiplier: 1.3,
-                retry_codes: [4, 14]
+                    initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
                   default_config.rpcs.list_budgets.timeout = 60.0
                   default_config.rpcs.list_budgets.retry_policy = {
-                    initial_delay: 0.1,
-                max_delay: 60.0,
-                multiplier: 1.3,
-                retry_codes: [4, 14]
+                    initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
                   default_config.rpcs.delete_budget.timeout = 60.0
                   default_config.rpcs.delete_budget.retry_policy = {
-                    initial_delay: 0.1,
-                max_delay: 60.0,
-                multiplier: 1.3,
-                retry_codes: [4, 14]
+                    initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
                   }
 
                   default_config
@@ -130,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]
@@ -162,14 +145,13 @@ 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
-                if credentials.is_a?(String) || credentials.is_a?(Hash)
+                if credentials.is_a?(::String) || credentials.is_a?(::Hash)
                   credentials = Credentials.new credentials, scope: @config.scope
                 end
                 @quota_project_id = @config.quota_project
@@ -220,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?
 
@@ -237,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|
@@ -298,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?
 
@@ -315,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|
@@ -370,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?
 
@@ -387,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|
@@ -449,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?
 
@@ -466,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|
@@ -517,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?
 
@@ -534,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|
@@ -567,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,7 +29,7 @@ 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

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

@@ -22,7 +22,7 @@ module Google
     module Billing
       module Budgets
         module V1beta1
-          VERSION = "0.5.0"
+          VERSION = "0.6.3"
         end
       end
     end

data/proto_docs/google/api/field_behavior.rb

@@ -57,9 +57,15 @@ module Google
 
       # Denotes that a (repeated) field is an unordered list.
       # This indicates that the service may provide the elements of the list
-      # in any arbitrary order, rather than the order the user originally
+      # in any arbitrary  order, rather than the order the user originally
       # provided. Additionally, the list's order may or may not be stable.
       UNORDERED_LIST = 6
+
+      # Denotes that this field returns a non-empty default value if not set.
+      # This indicates that if the user provides the empty value in a request,
+      # a non-empty value will be returned. The user will not be aware of what
+      # non-empty value to expect.
+      NON_EMPTY_DEFAULT = 7
     end
   end
 end

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

@@ -25,8 +25,8 @@ module Google
           # A budget is a plan that describes what you expect to spend on Cloud
           # projects, plus the rules to execute as spend is tracked against that plan,
           # (for example, send an alert when 90% of the target spend is met).
-          # Currently all plans are monthly budgets so the usage period(s) tracked are
-          # implied (calendar months of usage back-to-back).
+          # The budget time period is configurable, with options such as month (default),
+          # quarter, year, or custom time period.
           # @!attribute [r] name
           #   @return [::String]
           #     Output only. Resource name of the budget.
@@ -38,8 +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.
+          #     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.
@@ -67,21 +68,29 @@ module Google
           #     A specified amount to use as the budget.
           #     `currency_code` is optional. If specified when creating a budget, it must
           #     match the currency of the billing account. If specified when updating a
-          #     budget, it must match the existing budget currency_code.
+          #     budget, it must match the currency_code of the existing budget.
           #     The `currency_code` is provided on output.
           # @!attribute [rw] last_period_amount
           #   @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#custom_period Filter.custom_period}.
           class BudgetAmount
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # Describes a budget amount targeted to last period's spend.
-          # At this time, the amount is automatically 100% of last period's spend;
-          # that is, there are no other options yet.
-          # Future configuration will be described here (for example, configuring a
-          # percentage of last period's spend).
+          # 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}.
           class LastPeriodAmount
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -117,6 +126,10 @@ 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#custom_period Filter.custom_period}.
               FORECASTED_SPEND = 2
             end
           end
@@ -129,12 +142,12 @@ module Google
           #     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#manage-notifications
+          #     https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications
           #     for more details.
           #     Caller is expected to have
           #     `pubsub.topics.setIamPolicy` permission on the topic when it's set for a
           #     budget, otherwise, the API call will fail with PERMISSION_DENIED. See
-          #     https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications
+          #     https://cloud.google.com/billing/docs/how-to/budgets-programmatic-notifications#permissions_required_for_this_task
           #     for more details on Pub/Sub roles and permissions.
           # @!attribute [rw] schema_version
           #   @return [::String]
@@ -179,13 +192,12 @@ module Google
           #     {::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.
+          #     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. See [a list
-          #     of acceptable credit type
-          #     values](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
+          #     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,6 +223,18 @@ module Google
           #     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.
+          # @!attribute [rw] calendar_period
+          #   @return [::Google::Cloud::Billing::Budgets::V1beta1::CalendarPeriod]
+          #     Optional. Specifies to track usage for recurring calendar period.
+          #     For example, assume that CalendarPeriod.QUARTER is set. The budget will
+          #     track usage from April 1 to June 30, when the current calendar month is
+          #     April, May, June. After that, it will track usage from July 1 to
+          #     September 30 when the current calendar month is July, August, September,
+          #     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.
           class Filter
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -224,8 +248,11 @@ module Google
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
 
-            # Specifies how credits should be treated when determining spend for
-            # threshold calculations.
+            # Specifies how credits are applied when determining the spend for
+            # threshold calculations. Budgets track the total cost minus any applicable
+            # selected credits.
+            # [See the documentation for a list of credit
+            # types](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type).
             module CreditTypesTreatment
               CREDIT_TYPES_TREATMENT_UNSPECIFIED = 0
 
@@ -237,11 +264,46 @@ module Google
               # threshold calculations.
               EXCLUDE_ALL_CREDITS = 2
 
-              # Credit types specified in the credit_types field are subtracted from the
+              # [Credit
+              # types](https://cloud.google.com/billing/docs/how-to/export-data-bigquery-tables#credits-type)
+              # specified in the credit_types field are subtracted from the
               # gross cost to determine the spend for threshold calculations.
               INCLUDE_SPECIFIED_CREDITS = 3
             end
           end
+
+          # All date times begin at 12 AM US and Canadian Pacific Time (UTC-8).
+          # @!attribute [rw] start_date
+          #   @return [::Google::Type::Date]
+          #     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.
+          class CustomPeriod
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # A `CalendarPeriod` represents the abstract concept of a time period that
+          # has a canonical start. Grammatically, "the start of the current
+          # `CalendarPeriod`". All calendar times begin at 12 AM US and Canadian
+          # Pacific Time (UTC-8).
+          module CalendarPeriod
+            CALENDAR_PERIOD_UNSPECIFIED = 0
+
+            # A month. Month starts on the first day of each month, such as January 1,
+            # February 1, March 1, and so on.
+            MONTH = 1
+
+            # A quarter. Quarters start on dates January 1, April 1, July 1, and October
+            # 1 of each year.
+            QUARTER = 2
+
+            # A year. Year starts on January 1.
+            YEAR = 3
+          end
         end
       end
     end

data/proto_docs/google/type/date.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Type
+    # Represents a whole or partial calendar date, such as a birthday. The time of
+    # day and time zone are either specified elsewhere or are insignificant. The
+    # date is relative to the Gregorian Calendar. This can represent one of the
+    # following:
+    #
+    # * A full date, with non-zero year, month, and day values
+    # * A month and day value, with a zero year, such as an anniversary
+    # * A year on its own, with zero month and day values
+    # * A year and month value, with a zero day, such as a credit card expiration
+    # date
+    #
+    # Related types are [google.type.TimeOfDay][google.type.TimeOfDay] and
+    # `google.protobuf.Timestamp`.
+    # @!attribute [rw] year
+    #   @return [::Integer]
+    #     Year of the date. Must be from 1 to 9999, or 0 to specify a date without
+    #     a year.
+    # @!attribute [rw] month
+    #   @return [::Integer]
+    #     Month of a year. Must be from 1 to 12, or 0 to specify a year without a
+    #     month and day.
+    # @!attribute [rw] day
+    #   @return [::Integer]
+    #     Day of a month. Must be from 1 to 31 and valid for the year and month, or 0
+    #     to specify a year by itself or a year and month where the day isn't
+    #     significant.
+    class Date
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/type/money.rb

@@ -22,7 +22,7 @@ module Google
     # Represents an amount of money with its currency type.
     # @!attribute [rw] currency_code
     #   @return [::String]
-    #     The 3-letter currency code defined in ISO 4217.
+    #     The three-letter currency code defined in ISO 4217.
     # @!attribute [rw] units
     #   @return [::Integer]
     #     The whole units of the amount.

metadata

@@ -1,29 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-billing-budgets-v1beta1
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.3
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-09 00:00:00.000000000 Z
+date: 2021-11-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.7'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: 2.a
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.7'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.3'
+        version: 2.a
 - !ruby/object:Gem::Dependency
   name: google-cloud-errors
   requirement: !ruby/object:Gem::Requirement
@@ -181,6 +187,7 @@ files:
 - proto_docs/google/protobuf/empty.rb
 - proto_docs/google/protobuf/field_mask.rb
 - proto_docs/google/protobuf/struct.rb
+- proto_docs/google/type/date.rb
 - proto_docs/google/type/money.rb
 homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
@@ -201,7 +208,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.13
+rubygems_version: 3.2.17
 signing_key: 
 specification_version: 4
 summary: API Client library for the Billing Budgets V1beta1 API