google-cloud-service_control-v1 0.3.2 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5dd0df1092b74cdfd9603daffcc73dbaaa292081b2dea796d03872cc602e2ff
-  data.tar.gz: ac82224a83097a1873ba9948d0240092785e05171ee412ba78ddba810200dda1
+  metadata.gz: 01da9ad01ff745f86d6149371feaa9b7a569ed2c4421d3a4ac753e1fc62d3546
+  data.tar.gz: d5553dff2b6f72f20109f438c08fdb0f71deb0261c67e15ecd4af52c68e12369
 SHA512:
-  metadata.gz: 77c3f8b6c71a3d7ccd865e51a4c0bdfec7bf69f1c358cb8a45a4c0c3c2703621fa3de40b7975e38e4594a5d8fcadafe0f5f86766804326028b6c57a53d31e663
-  data.tar.gz: d4baf4c2c54e33ef8170a0075b5adc6c954fcf411eae9861736b1244df8f17874d100e00e5cf41849b72f13ff18b8805f1e44f6766718dd75f3a7d48f7961231
+  metadata.gz: 51708eefede90d41a2d25882171aa636cabf4100c64c5d9e2778eb9fd1043f27fafa245ece9bf30b3b82dcf2a077ecd9002f4e48852823c0122df2206cc51f57
+  data.tar.gz: 2743c1e542657c945d8f76c12b3c12c7880b566621fbf702a31280a2bcad5e57f0ed0e689a10bfd897bef2715ae61cc2944d31e9d91fcb9dc7e8c1ce020db930

data/AUTHENTICATION.md

@@ -66,11 +66,11 @@ The environment variables that google-cloud-service_control-v1
 checks for credentials are configured on the service Credentials class (such as
 {::Google::Cloud::ServiceControl::V1::QuotaController::Credentials}):
 
-1. `SERVICE_CONTROL_CREDENTIALS` - Path to JSON file, or JSON contents
-2. `SERVICE_CONTROL_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
+* `SERVICE_CONTROL_CREDENTIALS` - Path to JSON file, or JSON contents
+* `SERVICE_CONTROL_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/service_control/v1"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::ServiceControl::V1::QuotaController::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/service_control/v1"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::ServiceControl::V1::QuotaController::Client.new do |co
 end
 ```
 
-Or configured globally for all clients:
+Or globally for all clients:
 
 ```ruby
 require "google/cloud/service_control/v1"

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/service_control/v1"
 
 client = ::Google::Cloud::ServiceControl::V1::QuotaController::Client.new
-request = my_create_request
+request = ::Google::Cloud::ServiceControl::V1::AllocateQuotaRequest.new # (request fields as keyword arguments...)
 response = client.allocate_quota request
 ```
 

data/lib/google/api/servicecontrol/v1/distribution_pb.rb

@@ -3,6 +3,7 @@
 
 require 'google/protobuf'
 
+require 'google/api/distribution_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/api/servicecontrol/v1/distribution.proto", :syntax => :proto3) do
     add_message "google.api.servicecontrol.v1.Distribution" do
@@ -12,6 +13,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :maximum, :double, 4
       optional :sum_of_squared_deviation, :double, 5
       repeated :bucket_counts, :int64, 6
+      repeated :exemplars, :message, 10, "google.api.Distribution.Exemplar"
       oneof :bucket_option do
         optional :linear_buckets, :message, 7, "google.api.servicecontrol.v1.Distribution.LinearBuckets"
         optional :exponential_buckets, :message, 8, "google.api.servicecontrol.v1.Distribution.ExponentialBuckets"

data/lib/google/api/servicecontrol/v1/quota_controller_pb.rb

@@ -5,6 +5,7 @@ require 'google/protobuf'
 
 require 'google/api/annotations_pb'
 require 'google/api/servicecontrol/v1/metric_value_pb'
+require 'google/rpc/status_pb'
 require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/api/servicecontrol/v1/quota_controller.proto", :syntax => :proto3) do
@@ -39,6 +40,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :code, :enum, 1, "google.api.servicecontrol.v1.QuotaError.Code"
       optional :subject, :string, 2
       optional :description, :string, 3
+      optional :status, :message, 4, "google.rpc.Status"
     end
     add_enum "google.api.servicecontrol.v1.QuotaError.Code" do
       value :UNSPECIFIED, 0

data/lib/google/api/servicecontrol/v1/quota_controller_services_pb.rb

@@ -24,13 +24,13 @@ module Google
     module ServiceControl
       module V1
         module QuotaController
-          # [Google Quota Control API](https://cloud.google.com/service-control/overview)
+          # [Google Quota Control API](/service-control/overview)
           #
           # Allows clients to allocate and release quota against a [managed
           # service](https://cloud.google.com/service-management/reference/rpc/google.api/servicemanagement.v1#google.api.servicemanagement.v1.ManagedService).
           class Service
 
-            include ::GRPC::GenericService
+            include GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode

data/lib/google/api/servicecontrol/v1/service_controller_pb.rb

@@ -4,11 +4,11 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
 require 'google/api/servicecontrol/v1/check_error_pb'
 require 'google/api/servicecontrol/v1/operation_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/rpc/status_pb'
-require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/api/servicecontrol/v1/service_controller.proto", :syntax => :proto3) do
     add_message "google.api.servicecontrol.v1.CheckRequest" do

data/lib/google/api/servicecontrol/v1/service_controller_services_pb.rb

@@ -24,13 +24,13 @@ module Google
     module ServiceControl
       module V1
         module ServiceController
-          # [Google Service Control API](https://cloud.google.com/service-control/overview)
+          # [Google Service Control API](/service-control/overview)
           #
           # Lets clients check and report operations against a [managed
           # service](https://cloud.google.com/service-management/reference/rpc/google.api/servicemanagement.v1#google.api.servicemanagement.v1.ManagedService).
           class Service
 
-            include ::GRPC::GenericService
+            include GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode
@@ -47,7 +47,8 @@ module Google
             # propagation, therefore callers MUST NOT depend on the `Check` method having
             # the latest policy information.
             #
-            # NOTE: the [CheckRequest][google.api.servicecontrol.v1.CheckRequest] has the size limit of 64KB.
+            # NOTE: the [CheckRequest][google.api.servicecontrol.v1.CheckRequest] has
+            # the size limit (wire-format byte size) of 1MB.
             #
             # This method requires the `servicemanagement.services.check` permission
             # on the specified service. For more information, see
@@ -62,8 +63,8 @@ module Google
             # the aggregation time window to avoid data loss risk more than 0.01%
             # for business and compliance reasons.
             #
-            # NOTE: the [ReportRequest][google.api.servicecontrol.v1.ReportRequest] has the size limit (wire-format byte size) of
-            # 1MB.
+            # NOTE: the [ReportRequest][google.api.servicecontrol.v1.ReportRequest] has
+            # the size limit (wire-format byte size) of 1MB.
             #
             # This method requires the `servicemanagement.services.report` permission
             # on the specified service. For more information, see

data/lib/google/cloud/service_control/v1/quota_controller.rb

@@ -30,7 +30,7 @@ module Google
     module ServiceControl
       module V1
         ##
-        # [Google Quota Control API](https://cloud.google.com/service-control/overview)
+        # [Google Quota Control API](/service-control/overview)
         #
         # Allows clients to allocate and release quota against a [managed
         # service](https://cloud.google.com/service-management/reference/rpc/google.api/servicemanagement.v1#google.api.servicemanagement.v1.ManagedService).

data/lib/google/cloud/service_control/v1/quota_controller/client.rb

@@ -27,7 +27,7 @@ module Google
           ##
           # Client for the QuotaController service.
           #
-          # [Google Quota Control API](https://cloud.google.com/service-control/overview)
+          # [Google Quota Control API](/service-control/overview)
           #
           # Allows clients to allocate and release quota against a [managed
           # service](https://cloud.google.com/service-management/reference/rpc/google.api/servicemanagement.v1#google.api.servicemanagement.v1.ManagedService).
@@ -42,13 +42,12 @@ module Google
             # See {::Google::Cloud::ServiceControl::V1::QuotaController::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
+            # @example
             #
-            # To modify the configuration for all QuotaController clients:
-            #
-            #     ::Google::Cloud::ServiceControl::V1::QuotaController::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all QuotaController clients
+            #   ::Google::Cloud::ServiceControl::V1::QuotaController::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -95,19 +94,15 @@ module Google
             ##
             # Create a new QuotaController client object.
             #
-            # ## Examples
-            #
-            # To create a new QuotaController client with the default
-            # configuration:
+            # @example
             #
-            #     client = ::Google::Cloud::ServiceControl::V1::QuotaController::Client.new
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::ServiceControl::V1::QuotaController::Client.new
             #
-            # To create a new QuotaController client with a custom
-            # configuration:
-            #
-            #     client = ::Google::Cloud::ServiceControl::V1::QuotaController::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::ServiceControl::V1::QuotaController::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the QuotaController client.
             # @yieldparam config [Client::Configuration]
@@ -127,14 +122,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
@@ -225,7 +219,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.allocate_quota.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.allocate_quota.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @quota_controller_stub.call_rpc :allocate_quota, request, options: options do |response, operation|
@@ -249,22 +245,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 allocate_quota
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Cloud::ServiceControl::V1::QuotaController::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.allocate_quota.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Cloud::ServiceControl::V1::QuotaController::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.allocate_quota.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # allocate_quota to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::ServiceControl::V1::QuotaController::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.allocate_quota.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::ServiceControl::V1::QuotaController::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.allocate_quota.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.

data/lib/google/cloud/service_control/v1/service_controller.rb

@@ -30,7 +30,7 @@ module Google
     module ServiceControl
       module V1
         ##
-        # [Google Service Control API](https://cloud.google.com/service-control/overview)
+        # [Google Service Control API](/service-control/overview)
         #
         # Lets clients check and report operations against a [managed
         # service](https://cloud.google.com/service-management/reference/rpc/google.api/servicemanagement.v1#google.api.servicemanagement.v1.ManagedService).

data/lib/google/cloud/service_control/v1/service_controller/client.rb

@@ -27,7 +27,7 @@ module Google
           ##
           # Client for the ServiceController service.
           #
-          # [Google Service Control API](https://cloud.google.com/service-control/overview)
+          # [Google Service Control API](/service-control/overview)
           #
           # Lets clients check and report operations against a [managed
           # service](https://cloud.google.com/service-management/reference/rpc/google.api/servicemanagement.v1#google.api.servicemanagement.v1.ManagedService).
@@ -42,13 +42,12 @@ module Google
             # See {::Google::Cloud::ServiceControl::V1::ServiceController::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
+            # @example
             #
-            # To modify the configuration for all ServiceController clients:
-            #
-            #     ::Google::Cloud::ServiceControl::V1::ServiceController::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all ServiceController clients
+            #   ::Google::Cloud::ServiceControl::V1::ServiceController::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -66,6 +65,13 @@ module Google
                                 end
                 default_config = Client::Configuration.new parent_config
 
+                default_config.rpcs.check.timeout = 5.0
+                default_config.rpcs.check.retry_policy = {
+                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
+                }
+
+                default_config.rpcs.report.timeout = 16.0
+
                 default_config
               end
               yield @configure if block_given?
@@ -95,19 +101,15 @@ module Google
             ##
             # Create a new ServiceController client object.
             #
-            # ## Examples
+            # @example
             #
-            # To create a new ServiceController client with the default
-            # configuration:
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::ServiceControl::V1::ServiceController::Client.new
             #
-            #     client = ::Google::Cloud::ServiceControl::V1::ServiceController::Client.new
-            #
-            # To create a new ServiceController client with a custom
-            # configuration:
-            #
-            #     client = ::Google::Cloud::ServiceControl::V1::ServiceController::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::ServiceControl::V1::ServiceController::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the ServiceController client.
             # @yieldparam config [Client::Configuration]
@@ -127,14 +129,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
@@ -163,7 +164,8 @@ module Google
             # propagation, therefore callers MUST NOT depend on the `Check` method having
             # the latest policy information.
             #
-            # NOTE: the {::Google::Cloud::ServiceControl::V1::CheckRequest CheckRequest} has the size limit of 64KB.
+            # NOTE: the {::Google::Cloud::ServiceControl::V1::CheckRequest CheckRequest} has
+            # the size limit (wire-format byte size) of 1MB.
             #
             # This method requires the `servicemanagement.services.check` permission
             # on the specified service. For more information, see
@@ -234,7 +236,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.check.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.check.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_controller_stub.call_rpc :check, request, options: options do |response, operation|
@@ -255,8 +259,8 @@ module Google
             # the aggregation time window to avoid data loss risk more than 0.01%
             # for business and compliance reasons.
             #
-            # NOTE: the {::Google::Cloud::ServiceControl::V1::ReportRequest ReportRequest} has the size limit (wire-format byte size) of
-            # 1MB.
+            # NOTE: the {::Google::Cloud::ServiceControl::V1::ReportRequest ReportRequest} has
+            # the size limit (wire-format byte size) of 1MB.
             #
             # This method requires the `servicemanagement.services.report` permission
             # on the specified service. For more information, see
@@ -294,7 +298,8 @@ module Google
             #
             #     There is no limit on the number of operations in the same ReportRequest,
             #     however the ReportRequest size should be no larger than 1MB. See
-            #     {::Google::Cloud::ServiceControl::V1::ReportResponse#report_errors ReportResponse.report_errors} for partial failure behavior.
+            #     {::Google::Cloud::ServiceControl::V1::ReportResponse#report_errors ReportResponse.report_errors}
+            #     for partial failure behavior.
             #   @param service_config_id [::String]
             #     Specifies which version of service config should be used to process the
             #     request.
@@ -336,7 +341,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.report.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.report.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @service_controller_stub.call_rpc :report, request, options: options do |response, operation|
@@ -360,22 +367,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 check
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Cloud::ServiceControl::V1::ServiceController::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.check.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Cloud::ServiceControl::V1::ServiceController::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.check.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # check to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::ServiceControl::V1::ServiceController::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.check.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::ServiceControl::V1::ServiceController::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.check.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.

data/lib/google/cloud/service_control/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module ServiceControl
       module V1
-        VERSION = "0.3.2"
+        VERSION = "0.4.3"
       end
     end
   end

data/proto_docs/google/api/distribution.rb

@@ -0,0 +1,225 @@
+# 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 Api
+    # `Distribution` contains summary statistics for a population of values. It
+    # optionally contains a histogram representing the distribution of those values
+    # across a set of buckets.
+    #
+    # The summary statistics are the count, mean, sum of the squared deviation from
+    # the mean, the minimum, and the maximum of the set of population of values.
+    # The histogram is based on a sequence of buckets and gives a count of values
+    # that fall into each bucket. The boundaries of the buckets are given either
+    # explicitly or by formulas for buckets of fixed or exponentially increasing
+    # widths.
+    #
+    # Although it is not forbidden, it is generally a bad idea to include
+    # non-finite values (infinities or NaNs) in the population of values, as this
+    # will render the `mean` and `sum_of_squared_deviation` fields meaningless.
+    # @!attribute [rw] count
+    #   @return [::Integer]
+    #     The number of values in the population. Must be non-negative. This value
+    #     must equal the sum of the values in `bucket_counts` if a histogram is
+    #     provided.
+    # @!attribute [rw] mean
+    #   @return [::Float]
+    #     The arithmetic mean of the values in the population. If `count` is zero
+    #     then this field must be zero.
+    # @!attribute [rw] sum_of_squared_deviation
+    #   @return [::Float]
+    #     The sum of squared deviations from the mean of the values in the
+    #     population. For values x_i this is:
+    #
+    #         Sum[i=1..n]((x_i - mean)^2)
+    #
+    #     Knuth, "The Art of Computer Programming", Vol. 2, page 232, 3rd edition
+    #     describes Welford's method for accumulating this sum in one pass.
+    #
+    #     If `count` is zero then this field must be zero.
+    # @!attribute [rw] range
+    #   @return [::Google::Api::Distribution::Range]
+    #     If specified, contains the range of the population values. The field
+    #     must not be present if the `count` is zero.
+    # @!attribute [rw] bucket_options
+    #   @return [::Google::Api::Distribution::BucketOptions]
+    #     Defines the histogram bucket boundaries. If the distribution does not
+    #     contain a histogram, then omit this field.
+    # @!attribute [rw] bucket_counts
+    #   @return [::Array<::Integer>]
+    #     The number of values in each bucket of the histogram, as described in
+    #     `bucket_options`. If the distribution does not have a histogram, then omit
+    #     this field. If there is a histogram, then the sum of the values in
+    #     `bucket_counts` must equal the value in the `count` field of the
+    #     distribution.
+    #
+    #     If present, `bucket_counts` should contain N values, where N is the number
+    #     of buckets specified in `bucket_options`. If you supply fewer than N
+    #     values, the remaining values are assumed to be 0.
+    #
+    #     The order of the values in `bucket_counts` follows the bucket numbering
+    #     schemes described for the three bucket types. The first value must be the
+    #     count for the underflow bucket (number 0). The next N-2 values are the
+    #     counts for the finite buckets (number 1 through N-2). The N'th value in
+    #     `bucket_counts` is the count for the overflow bucket (number N-1).
+    # @!attribute [rw] exemplars
+    #   @return [::Array<::Google::Api::Distribution::Exemplar>]
+    #     Must be in increasing order of `value` field.
+    class Distribution
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # The range of the population values.
+      # @!attribute [rw] min
+      #   @return [::Float]
+      #     The minimum of the population values.
+      # @!attribute [rw] max
+      #   @return [::Float]
+      #     The maximum of the population values.
+      class Range
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # `BucketOptions` describes the bucket boundaries used to create a histogram
+      # for the distribution. The buckets can be in a linear sequence, an
+      # exponential sequence, or each bucket can be specified explicitly.
+      # `BucketOptions` does not include the number of values in each bucket.
+      #
+      # A bucket has an inclusive lower bound and exclusive upper bound for the
+      # values that are counted for that bucket. The upper bound of a bucket must
+      # be strictly greater than the lower bound. The sequence of N buckets for a
+      # distribution consists of an underflow bucket (number 0), zero or more
+      # finite buckets (number 1 through N - 2) and an overflow bucket (number N -
+      # 1). The buckets are contiguous: the lower bound of bucket i (i > 0) is the
+      # same as the upper bound of bucket i - 1. The buckets span the whole range
+      # of finite values: lower bound of the underflow bucket is -infinity and the
+      # upper bound of the overflow bucket is +infinity. The finite buckets are
+      # so-called because both bounds are finite.
+      # @!attribute [rw] linear_buckets
+      #   @return [::Google::Api::Distribution::BucketOptions::Linear]
+      #     The linear bucket.
+      # @!attribute [rw] exponential_buckets
+      #   @return [::Google::Api::Distribution::BucketOptions::Exponential]
+      #     The exponential buckets.
+      # @!attribute [rw] explicit_buckets
+      #   @return [::Google::Api::Distribution::BucketOptions::Explicit]
+      #     The explicit buckets.
+      class BucketOptions
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+
+        # Specifies a linear sequence of buckets that all have the same width
+        # (except overflow and underflow). Each bucket represents a constant
+        # absolute uncertainty on the specific value in the bucket.
+        #
+        # There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the
+        # following boundaries:
+        #
+        #    Upper bound (0 <= i < N-1):     offset + (width * i).
+        #    Lower bound (1 <= i < N):       offset + (width * (i - 1)).
+        # @!attribute [rw] num_finite_buckets
+        #   @return [::Integer]
+        #     Must be greater than 0.
+        # @!attribute [rw] width
+        #   @return [::Float]
+        #     Must be greater than 0.
+        # @!attribute [rw] offset
+        #   @return [::Float]
+        #     Lower bound of the first bucket.
+        class Linear
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Specifies an exponential sequence of buckets that have a width that is
+        # proportional to the value of the lower bound. Each bucket represents a
+        # constant relative uncertainty on a specific value in the bucket.
+        #
+        # There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the
+        # following boundaries:
+        #
+        #    Upper bound (0 <= i < N-1):     scale * (growth_factor ^ i).
+        #    Lower bound (1 <= i < N):       scale * (growth_factor ^ (i - 1)).
+        # @!attribute [rw] num_finite_buckets
+        #   @return [::Integer]
+        #     Must be greater than 0.
+        # @!attribute [rw] growth_factor
+        #   @return [::Float]
+        #     Must be greater than 1.
+        # @!attribute [rw] scale
+        #   @return [::Float]
+        #     Must be greater than 0.
+        class Exponential
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Specifies a set of buckets with arbitrary widths.
+        #
+        # There are `size(bounds) + 1` (= N) buckets. Bucket `i` has the following
+        # boundaries:
+        #
+        #    Upper bound (0 <= i < N-1):     bounds[i]
+        #    Lower bound (1 <= i < N);       bounds[i - 1]
+        #
+        # The `bounds` field must contain at least one element. If `bounds` has
+        # only one element, then there are no finite buckets, and that single
+        # element is the common boundary of the overflow and underflow buckets.
+        # @!attribute [rw] bounds
+        #   @return [::Array<::Float>]
+        #     The values must be monotonically increasing.
+        class Explicit
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+
+      # Exemplars are example points that may be used to annotate aggregated
+      # distribution values. They are metadata that gives information about a
+      # particular value added to a Distribution bucket, such as a trace ID that
+      # was active when a value was added. They may contain further information,
+      # such as a example values and timestamps, origin, etc.
+      # @!attribute [rw] value
+      #   @return [::Float]
+      #     Value of the exemplar point. This value determines to which bucket the
+      #     exemplar belongs.
+      # @!attribute [rw] timestamp
+      #   @return [::Google::Protobuf::Timestamp]
+      #     The observation (sampling) time of the above value.
+      # @!attribute [rw] attachments
+      #   @return [::Array<::Google::Protobuf::Any>]
+      #     Contextual information about the example value. Examples are:
+      #
+      #       Trace: type.googleapis.com/google.monitoring.v3.SpanContext
+      #
+      #       Literal string: type.googleapis.com/google.protobuf.StringValue
+      #
+      #       Labels dropped during aggregation:
+      #         type.googleapis.com/google.monitoring.v3.DroppedLabels
+      #
+      #     There may be only a single attachment of any given message type in a
+      #     single exemplar, and this is enforced by the system.
+      class Exemplar
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+    end
+  end
+end

data/proto_docs/google/api/servicecontrol/v1/distribution.rb

@@ -70,6 +70,9 @@ module Google
         # @!attribute [rw] explicit_buckets
         #   @return [::Google::Cloud::ServiceControl::V1::Distribution::ExplicitBuckets]
         #     Buckets with arbitrary user-provided width.
+        # @!attribute [rw] exemplars
+        #   @return [::Array<::Google::Api::Distribution::Exemplar>]
+        #     Example points. Must be in increasing order of `value` field.
         class Distribution
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/api/servicecontrol/v1/log_entry.rb

@@ -31,7 +31,7 @@ module Google
         #     The time the event described by the log entry occurred. If
         #     omitted, defaults to operation start time.
         # @!attribute [rw] severity
-        #   @return [::Google::Logging::Type::LogSeverity]
+        #   @return [::Google::Cloud::Logging::Type::LogSeverity]
         #     The severity of the log entry. The default value is
         #     `LogSeverity.DEFAULT`.
         # @!attribute [rw] http_request

data/proto_docs/google/api/servicecontrol/v1/metric_value.rb

@@ -33,11 +33,13 @@ module Google
         #     The start of the time period over which this metric value's measurement
         #     applies. The time period has different semantics for different metric
         #     types (cumulative, delta, and gauge). See the metric definition
-        #     documentation in the service configuration for details.
+        #     documentation in the service configuration for details. If not specified,
+        #     {::Google::Cloud::ServiceControl::V1::Operation#start_time google.api.servicecontrol.v1.Operation.start_time} will be used.
         # @!attribute [rw] end_time
         #   @return [::Google::Protobuf::Timestamp]
         #     The end of the time period over which this metric value's measurement
-        #     applies.
+        #     applies.  If not specified,
+        #     {::Google::Cloud::ServiceControl::V1::Operation#end_time google.api.servicecontrol.v1.Operation.end_time} will be used.
         # @!attribute [rw] bool_value
         #   @return [::Boolean]
         #     A boolean value.

data/proto_docs/google/api/servicecontrol/v1/operation.rb

@@ -56,8 +56,10 @@ module Google
         # @!attribute [rw] end_time
         #   @return [::Google::Protobuf::Timestamp]
         #     End time of the operation.
-        #     Required when the operation is used in {::Google::Cloud::ServiceControl::V1::ServiceController::Client#report ServiceController.Report},
-        #     but optional when the operation is used in {::Google::Cloud::ServiceControl::V1::ServiceController::Client#check ServiceController.Check}.
+        #     Required when the operation is used in
+        #     {::Google::Cloud::ServiceControl::V1::ServiceController::Client#report ServiceController.Report},
+        #     but optional when the operation is used in
+        #     {::Google::Cloud::ServiceControl::V1::ServiceController::Client#check ServiceController.Check}.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Labels describing the operation. Only the following labels are allowed:
@@ -112,13 +114,13 @@ module Google
 
           # Defines the importance of the data contained in the operation.
           module Importance
-            # The API implementation may cache and aggregate the data.
-            # The data may be lost when rare and unexpected system failures occur.
+            # Allows data caching, batching, and aggregation. It provides
+            # higher performance with higher data loss risk.
             LOW = 0
 
-            # The API implementation doesn't cache and aggregate the data.
-            # If the method returns successfully, it's guaranteed that the data has
-            # been persisted in durable storage.
+            # Disables data aggregation to minimize data loss. It is for operations
+            # that contains significant monetary value or audit trail. This feature
+            # only applies to the client libraries.
             HIGH = 1
           end
         end

data/proto_docs/google/api/servicecontrol/v1/quota_controller.rb

@@ -63,6 +63,7 @@ module Google
         #     (1) the quota operation is performed on non-API resources.
         #     (2) quota_metrics is set because the caller is doing quota override.
         #
+        #
         #     Example of an RPC method name:
         #         google.example.library.v1.LibraryService.CreateShelf
         # @!attribute [rw] consumer_id
@@ -137,14 +138,14 @@ module Google
             # Unimplemented. When used in AllocateQuotaRequest, this returns the
             # effective quota limit(s) in the response, and no quota check will be
             # performed. Not supported for other requests, and even for
-            # AllocateQuotaRequest, this is currently supported only for whitelisted
+            # AllocateQuotaRequest, this is currently supported only for allowlisted
             # services.
             QUERY_ONLY = 4
 
             # The operation allocates quota for the amount specified in the service
             # configuration or specified using the quota metrics. If the requested
             # amount is higher than the available quota, request does not fail and
-            # remaining quota would become negative (going over the limit)
+            # remaining quota would become negative (going over the limit).
             # Not supported for Rate Quota.
             ADJUST_ONLY = 5
           end
@@ -190,6 +191,10 @@ module Google
         # @!attribute [rw] description
         #   @return [::String]
         #     Free-form text that provides details on the cause of the error.
+        # @!attribute [rw] status
+        #   @return [::Google::Rpc::Status]
+        #     Contains additional information about the quota error.
+        #     If available, `status.code` will be non zero.
         class QuotaError
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/api/servicecontrol/v1/service_controller.rb

@@ -48,8 +48,9 @@ module Google
         # Response message for the Check method.
         # @!attribute [rw] operation_id
         #   @return [::String]
-        #     The same operation_id value used in the {::Google::Cloud::ServiceControl::V1::CheckRequest CheckRequest}.
-        #     Used for logging and diagnostics purposes.
+        #     The same operation_id value used in the
+        #     {::Google::Cloud::ServiceControl::V1::CheckRequest CheckRequest}. Used for logging
+        #     and diagnostics purposes.
         # @!attribute [rw] check_errors
         #   @return [::Array<::Google::Cloud::ServiceControl::V1::CheckError>]
         #     Indicate the decision of the check.
@@ -148,7 +149,8 @@ module Google
         #
         #     There is no limit on the number of operations in the same ReportRequest,
         #     however the ReportRequest size should be no larger than 1MB. See
-        #     {::Google::Cloud::ServiceControl::V1::ReportResponse#report_errors ReportResponse.report_errors} for partial failure behavior.
+        #     {::Google::Cloud::ServiceControl::V1::ReportResponse#report_errors ReportResponse.report_errors}
+        #     for partial failure behavior.
         # @!attribute [rw] service_config_id
         #   @return [::String]
         #     Specifies which version of service config should be used to process the
@@ -188,13 +190,17 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # Represents the processing error of one {::Google::Cloud::ServiceControl::V1::Operation Operation} in the request.
+          # Represents the processing error of one
+          # {::Google::Cloud::ServiceControl::V1::Operation Operation} in the request.
           # @!attribute [rw] operation_id
           #   @return [::String]
-          #     The {::Google::Cloud::ServiceControl::V1::Operation#operation_id Operation.operation_id} value from the request.
+          #     The
+          #     {::Google::Cloud::ServiceControl::V1::Operation#operation_id Operation.operation_id}
+          #     value from the request.
           # @!attribute [rw] status
           #   @return [::Google::Rpc::Status]
-          #     Details of the error when processing the {::Google::Cloud::ServiceControl::V1::Operation Operation}.
+          #     Details of the error when processing the
+          #     {::Google::Cloud::ServiceControl::V1::Operation Operation}.
           class ReportError
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/logging/type/log_severity.rb

@@ -18,51 +18,53 @@
 
 
 module Google
-  module Logging
-    module Type
-      # The severity of the event described in a log entry, expressed as one of the
-      # standard severity levels listed below.  For your reference, the levels are
-      # assigned the listed numeric values. The effect of using numeric values other
-      # than those listed is undefined.
-      #
-      # You can filter for log entries by severity.  For example, the following
-      # filter expression will match log entries with severities `INFO`, `NOTICE`,
-      # and `WARNING`:
-      #
-      #     severity > DEBUG AND severity <= WARNING
-      #
-      # If you are writing log entries, you should map other severity encodings to
-      # one of these standard levels. For example, you might map all of Java's FINE,
-      # FINER, and FINEST levels to `LogSeverity.DEBUG`. You can preserve the
-      # original severity level in the log entry payload if you wish.
-      module LogSeverity
-        # (0) The log entry has no assigned severity level.
-        DEFAULT = 0
+  module Cloud
+    module Logging
+      module Type
+        # The severity of the event described in a log entry, expressed as one of the
+        # standard severity levels listed below.  For your reference, the levels are
+        # assigned the listed numeric values. The effect of using numeric values other
+        # than those listed is undefined.
+        #
+        # You can filter for log entries by severity.  For example, the following
+        # filter expression will match log entries with severities `INFO`, `NOTICE`,
+        # and `WARNING`:
+        #
+        #     severity > DEBUG AND severity <= WARNING
+        #
+        # If you are writing log entries, you should map other severity encodings to
+        # one of these standard levels. For example, you might map all of Java's FINE,
+        # FINER, and FINEST levels to `LogSeverity.DEBUG`. You can preserve the
+        # original severity level in the log entry payload if you wish.
+        module LogSeverity
+          # (0) The log entry has no assigned severity level.
+          DEFAULT = 0
 
-        # (100) Debug or trace information.
-        DEBUG = 100
+          # (100) Debug or trace information.
+          DEBUG = 100
 
-        # (200) Routine information, such as ongoing status or performance.
-        INFO = 200
+          # (200) Routine information, such as ongoing status or performance.
+          INFO = 200
 
-        # (300) Normal but significant events, such as start up, shut down, or
-        # a configuration change.
-        NOTICE = 300
+          # (300) Normal but significant events, such as start up, shut down, or
+          # a configuration change.
+          NOTICE = 300
 
-        # (400) Warning events might cause problems.
-        WARNING = 400
+          # (400) Warning events might cause problems.
+          WARNING = 400
 
-        # (500) Error events are likely to cause problems.
-        ERROR = 500
+          # (500) Error events are likely to cause problems.
+          ERROR = 500
 
-        # (600) Critical events cause more severe problems or outages.
-        CRITICAL = 600
+          # (600) Critical events cause more severe problems or outages.
+          CRITICAL = 600
 
-        # (700) A person must take an action immediately.
-        ALERT = 700
+          # (700) A person must take an action immediately.
+          ALERT = 700
 
-        # (800) One or more systems are unusable.
-        EMERGENCY = 800
+          # (800) One or more systems are unusable.
+          EMERGENCY = 800
+        end
       end
     end
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-service_control-v1
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.3
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-17 00:00:00.000000000 Z
+date: 2021-08-11 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
@@ -190,6 +190,7 @@ files:
 - lib/google/cloud/service_control/v1/service_controller/credentials.rb
 - lib/google/cloud/service_control/v1/version.rb
 - proto_docs/README.md
+- proto_docs/google/api/distribution.rb
 - proto_docs/google/api/resource.rb
 - proto_docs/google/api/servicecontrol/v1/check_error.rb
 - proto_docs/google/api/servicecontrol/v1/distribution.rb