google-cloud-cloud_quotas-v1 2.5.0 → 2.6.0

data/lib/google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/rest/service_stub.rb

@@ -0,0 +1,234 @@
+# frozen_string_literal: true
+
+# Copyright 2026 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!
+
+require "google/api/cloudquotas/v1/quota_adjuster_settings_pb"
+
+module Google
+  module Cloud
+    module CloudQuotas
+      module V1
+        module QuotaAdjusterSettingsManager
+          module Rest
+            ##
+            # REST service stub for the QuotaAdjusterSettingsManager service.
+            # Service stub contains baseline method implementations
+            # including transcoding, making the REST call, and deserialing the response.
+            #
+            class ServiceStub
+              # @private
+              def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
+                # These require statements are intentionally placed here to initialize
+                # the REST modules only when it's required.
+                require "gapic/rest"
+
+                @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
+                                                             endpoint_template: endpoint_template,
+                                                             universe_domain: universe_domain,
+                                                             credentials: credentials,
+                                                             numeric_enums: true,
+                                                             service_name: self.class,
+                                                             raise_faraday_errors: false,
+                                                             logger: logger
+              end
+
+              ##
+              # The effective universe domain
+              #
+              # @return [String]
+              #
+              def universe_domain
+                @client_stub.universe_domain
+              end
+
+              ##
+              # The effective endpoint
+              #
+              # @return [String]
+              #
+              def endpoint
+                @client_stub.endpoint
+              end
+
+              ##
+              # The logger used for request/response debug logging.
+              #
+              # @return [Logger]
+              #
+              def logger stub: false
+                stub ? @client_stub.stub_logger : @client_stub.logger
+              end
+
+              ##
+              # Baseline implementation for the update_quota_adjuster_settings REST call
+              #
+              # @param request_pb [::Google::Cloud::CloudQuotas::V1::UpdateQuotaAdjusterSettingsRequest]
+              #   A request object representing the call parameters. Required.
+              # @param options [::Gapic::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::CloudQuotas::V1::QuotaAdjusterSettings]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::CloudQuotas::V1::QuotaAdjusterSettings]
+              #   A result object deserialized from the server's reply
+              def update_quota_adjuster_settings request_pb, options = nil
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_update_quota_adjuster_settings_request request_pb
+                query_string_params = if query_string_params.any?
+                                        query_string_params.to_h { |p| p.split "=", 2 }
+                                      else
+                                        {}
+                                      end
+
+                response = @client_stub.make_http_request(
+                  verb,
+                  uri: uri,
+                  body: body || "",
+                  params: query_string_params,
+                  method_name: "update_quota_adjuster_settings",
+                  options: options
+                )
+                operation = ::Gapic::Rest::TransportOperation.new response
+                result = ::Google::Cloud::CloudQuotas::V1::QuotaAdjusterSettings.decode_json response.body, ignore_unknown_fields: true
+                catch :response do
+                  yield result, operation if block_given?
+                  result
+                end
+              end
+
+              ##
+              # Baseline implementation for the get_quota_adjuster_settings REST call
+              #
+              # @param request_pb [::Google::Cloud::CloudQuotas::V1::GetQuotaAdjusterSettingsRequest]
+              #   A request object representing the call parameters. Required.
+              # @param options [::Gapic::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::CloudQuotas::V1::QuotaAdjusterSettings]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::CloudQuotas::V1::QuotaAdjusterSettings]
+              #   A result object deserialized from the server's reply
+              def get_quota_adjuster_settings request_pb, options = nil
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_get_quota_adjuster_settings_request request_pb
+                query_string_params = if query_string_params.any?
+                                        query_string_params.to_h { |p| p.split "=", 2 }
+                                      else
+                                        {}
+                                      end
+
+                response = @client_stub.make_http_request(
+                  verb,
+                  uri: uri,
+                  body: body || "",
+                  params: query_string_params,
+                  method_name: "get_quota_adjuster_settings",
+                  options: options
+                )
+                operation = ::Gapic::Rest::TransportOperation.new response
+                result = ::Google::Cloud::CloudQuotas::V1::QuotaAdjusterSettings.decode_json response.body, ignore_unknown_fields: true
+                catch :response do
+                  yield result, operation if block_given?
+                  result
+                end
+              end
+
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the update_quota_adjuster_settings REST call
+              #
+              # @param request_pb [::Google::Cloud::CloudQuotas::V1::UpdateQuotaAdjusterSettingsRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_update_quota_adjuster_settings_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :patch,
+                                                          uri_template: "/v1/{quota_adjuster_settings.name}",
+                                                          body: "quota_adjuster_settings",
+                                                          matches: [
+                                                            ["quota_adjuster_settings.name", %r{^projects/[^/]+/locations/[^/]+/quotaAdjusterSettings/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :patch,
+                                                          uri_template: "/v1/{quota_adjuster_settings.name}",
+                                                          body: "quota_adjuster_settings",
+                                                          matches: [
+                                                            ["quota_adjuster_settings.name", %r{^folders/[^/]+/locations/[^/]+/quotaAdjusterSettings/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :patch,
+                                                          uri_template: "/v1/{quota_adjuster_settings.name}",
+                                                          body: "quota_adjuster_settings",
+                                                          matches: [
+                                                            ["quota_adjuster_settings.name", %r{^organizations/[^/]+/locations/[^/]+/quotaAdjusterSettings/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
+
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the get_quota_adjuster_settings REST call
+              #
+              # @param request_pb [::Google::Cloud::CloudQuotas::V1::GetQuotaAdjusterSettingsRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_get_quota_adjuster_settings_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :get,
+                                                          uri_template: "/v1/{name}",
+                                                          matches: [
+                                                            ["name", %r{^projects/[^/]+/locations/[^/]+/quotaAdjusterSettings/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :get,
+                                                          uri_template: "/v1/{name}",
+                                                          matches: [
+                                                            ["name", %r{^folders/[^/]+/locations/[^/]+/quotaAdjusterSettings/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :get,
+                                                          uri_template: "/v1/{name}",
+                                                          matches: [
+                                                            ["name", %r{^organizations/[^/]+/locations/[^/]+/quotaAdjusterSettings/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/rest.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+# Copyright 2026 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!
+
+require "gapic/rest"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/cloud_quotas/v1/version"
+
+require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/credentials"
+require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/paths"
+require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/rest/client"
+
+module Google
+  module Cloud
+    module CloudQuotas
+      module V1
+        ##
+        # The Quotas Adjuster Settings API is an infrastructure service for Google
+        #  Cloud that lets service consumers view and update their quota adjuster
+        #  settings.
+        #
+        # - Update quota adjuster settings.
+        # - Get the name of the configurations.
+        #
+        # To load this service and instantiate a REST client:
+        #
+        #     require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/rest"
+        #     client = ::Google::Cloud::CloudQuotas::V1::QuotaAdjusterSettingsManager::Rest::Client.new
+        #
+        module QuotaAdjusterSettingsManager
+          # Client for the REST transport
+          module Rest
+          end
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "rest", "helpers.rb"
+require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/rest/helpers" if ::File.file? helper_path

data/lib/google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+# Copyright 2026 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!
+
+require "gapic/common"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/cloud_quotas/v1/version"
+
+require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/credentials"
+require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/paths"
+require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/client"
+require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/rest"
+
+module Google
+  module Cloud
+    module CloudQuotas
+      module V1
+        ##
+        # The Quotas Adjuster Settings API is an infrastructure service for Google
+        #  Cloud that lets service consumers view and update their quota adjuster
+        #  settings.
+        #
+        # - Update quota adjuster settings.
+        # - Get the name of the configurations.
+        #
+        # @example Load this service and instantiate a gRPC client
+        #
+        #     require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager"
+        #     client = ::Google::Cloud::CloudQuotas::V1::QuotaAdjusterSettingsManager::Client.new
+        #
+        # @example Load this service and instantiate a REST client
+        #
+        #     require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/rest"
+        #     client = ::Google::Cloud::CloudQuotas::V1::QuotaAdjusterSettingsManager::Rest::Client.new
+        #
+        module QuotaAdjusterSettingsManager
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "quota_adjuster_settings_manager", "helpers.rb"
+require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/helpers" if ::File.file? helper_path

data/lib/google/cloud/cloud_quotas/v1/rest.rb

@@ -17,6 +17,7 @@
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
 require "google/cloud/cloud_quotas/v1/cloud_quotas/rest"
+require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager/rest"
 require "google/cloud/cloud_quotas/v1/version"
 
 module Google

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module CloudQuotas
       module V1
-        VERSION = "2.5.0"
+        VERSION = "2.6.0"
       end
     end
   end

data/lib/google/cloud/cloud_quotas/v1.rb

@@ -17,6 +17,7 @@
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
 require "google/cloud/cloud_quotas/v1/cloud_quotas"
+require "google/cloud/cloud_quotas/v1/quota_adjuster_settings_manager"
 require "google/cloud/cloud_quotas/v1/version"
 
 module Google

data/proto_docs/google/api/cloudquotas/v1/cloudquotas.rb

@@ -24,7 +24,7 @@ module Google
         # Message for requesting list of QuotaInfos
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. Parent value of QuotaInfo resources.
+        #     Required. Identifier. Parent value of QuotaInfo resources.
         #     Listing across different resource containers (such as 'projects/-') is not
         #     allowed.
         #
@@ -60,7 +60,7 @@ module Google
         # Message for getting a QuotaInfo
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The resource name of the quota info.
+        #     Required. Identifier. The resource name of the quota info.
         #
         #     An example name:
         #     `projects/123/locations/global/services/compute.googleapis.com/quotaInfos/CpusPerProjectPerRegion`
@@ -72,7 +72,7 @@ module Google
         # Message for requesting list of QuotaPreferences
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. Parent value of QuotaPreference resources.
+        #     Required. Identifier. Parent value of QuotaPreference resources.
         #     Listing across different resource containers (such as 'projects/-') is not
         #     allowed.
         #
@@ -129,7 +129,7 @@ module Google
         # Message for getting a QuotaPreference
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. Name of the resource
+        #     Required. Identifier. Name of the resource
         #
         #     Example name:
         #     `projects/123/locations/global/quota_preferences/my-config-for-us-east1`
@@ -141,7 +141,7 @@ module Google
         # Message for creating a QuotaPreference
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. Value for parent.
+        #     Required. Identifier. Value for parent.
         #
         #     Example:
         #     `projects/123/locations/global`

data/proto_docs/google/api/cloudquotas/v1/quota_adjuster_settings.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+# Copyright 2026 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 Cloud
+    module CloudQuotas
+      module V1
+        # Request for getting QuotaAdjusterSettings
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. Identifier. Name of the `quotaAdjusterSettings` configuration.
+        #     Only a single setting per project is supported.
+        class GetQuotaAdjusterSettingsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request for updating QuotaAdjusterSettings
+        # @!attribute [rw] quota_adjuster_settings
+        #   @return [::Google::Cloud::CloudQuotas::V1::QuotaAdjusterSettings]
+        #     Required. The QuotaAdjusterSettings to update.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. The list of fields to update.
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Optional. If set to true, checks the syntax of the request but doesn't
+        #     update the quota adjuster settings value. Note that although a request can
+        #     be valid, that doesn't guarantee that the request will be fulfilled.
+        class UpdateQuotaAdjusterSettingsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The QuotaAdjusterSettings resource defines the settings for the Quota
+        # Adjuster.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Identifier. Name of the configuration, in the formats below:
+        #
+        #     * For a project:
+        #       projects/PROJECT_NUMBER/locations/global/quotaAdjusterSettings
+        #     * For a folder:
+        #       folders/FOLDER_NUMBER/locations/global/quotaAdjusterSettings
+        #     * For an organization:
+        #       organizations/ORGANIZATION_NUMBER/locations/global/quotaAdjusterSettings
+        # @!attribute [rw] enablement
+        #   @return [::Google::Cloud::CloudQuotas::V1::QuotaAdjusterSettings::Enablement]
+        #     Optional. The configured value of the enablement at the given resource.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The timestamp when the QuotaAdjusterSettings resource was last
+        #     updated.
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Optional. The current ETag of the QuotaAdjusterSettings. If an ETag is
+        #     provided on update and does not match the current server's ETag in the
+        #     QuotaAdjusterSettings, the request is blocked and returns an ABORTED error.
+        #     See https://google.aip.dev/134#etags for more details on ETags.
+        # @!attribute [rw] inherited
+        #   @return [::Boolean]
+        #     Optional. Indicates whether the setting is inherited or explicitly
+        #     specified.
+        # @!attribute [r] inherited_from
+        #   @return [::String]
+        #     Output only. The resource container from which the setting is inherited.
+        #     This refers to the  nearest ancestor with enablement set (either ENABLED or
+        #     DISABLED). The value can be an organizations/\\{organization_id},
+        #     folders/\\{folder_id}, or can be 'default' if no ancestor exists with
+        #     enablement set. The value will be empty when enablement is directly set on
+        #     this container.
+        class QuotaAdjusterSettings
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The enablement status of the quota adjuster.
+          module Enablement
+            # The quota adjuster is in an unknown state.
+            ENABLEMENT_UNSPECIFIED = 0
+
+            # The quota adjuster is enabled.
+            ENABLED = 2
+
+            # The quota adjuster is disabled.
+            DISABLED = 3
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/api/cloudquotas/v1/resources.rb

@@ -27,21 +27,21 @@ module Google
         #   @return [::String]
         #     Resource name of this QuotaInfo.
         #     The ID component following "locations/" must be "global".
-        #     Example:
+        #     For example,
         #     `projects/123/locations/global/services/compute.googleapis.com/quotaInfos/CpusPerProjectPerRegion`
         # @!attribute [rw] quota_id
         #   @return [::String]
         #     The id of the quota, which is unique within the service.
-        #     Example: `CpusPerProjectPerRegion`
+        #     For example, `CpusPerProjectPerRegion`
         # @!attribute [rw] metric
         #   @return [::String]
         #     The metric of the quota. It specifies the resources consumption the quota
         #     is defined for.
-        #     Example: `compute.googleapis.com/cpus`
+        #     For example, `compute.googleapis.com/cpus`
         # @!attribute [rw] service
         #   @return [::String]
         #     The name of the service in which the quota is defined.
-        #     Example: `compute.googleapis.com`
+        #     For example, `compute.googleapis.com`
         # @!attribute [rw] is_precise
         #   @return [::Boolean]
         #     Whether this is a precise quota. A precise quota is tracked with absolute
@@ -50,8 +50,8 @@ module Google
         #   @return [::String]
         #     The reset time interval for the quota. Refresh interval applies to rate
         #     quota only.
-        #     Example: "minute" for per minute, "day" for per day, or "10 seconds" for
-        #     every 10 seconds.
+        #     For example, "minute" for per minute, "day" for per day, or "10 seconds"
+        #     for every 10 seconds.
         # @!attribute [rw] container_type
         #   @return [::Google::Cloud::CloudQuotas::V1::QuotaInfo::ContainerType]
         #     The container type of the QuotaInfo.
@@ -146,25 +146,26 @@ module Google
         #   @return [::String]
         #     Required except in the CREATE requests.
         #     The resource name of the quota preference.
-        #     The ID component following "locations/" must be "global".
-        #     Example:
+        #     The path that follows `/locations` must be `/global`.
+        #     For example:
         #     `projects/123/locations/global/quotaPreferences/my-config-for-us-east1`
         # @!attribute [rw] dimensions
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Immutable. The dimensions that this quota preference applies to. The key of
-        #     the map entry is the name of a dimension, such as "region", "zone",
-        #     "network_id", and the value of the map entry is the dimension value.
+        #     the map entry is the name of a dimension, such as `region`, `zone`,
+        #     `network_id`, and the value of the map entry is the dimension value.
         #
         #     If a dimension is missing from the map of dimensions, the quota preference
         #     applies to all the dimension values except for those that have other quota
         #     preferences configured for the specific value.
         #
-        #     NOTE: QuotaPreferences can only be applied across all values of "user" and
-        #     "resource" dimension. Do not set values for "user" or "resource" in the
+        #     Note: QuotaPreferences can only be applied across all values of `user` and
+        #     `resource` dimension. Do not set values for `user` or `resource` in the
         #     dimension map.
         #
-        #     Example: \\{"provider", "Foo Inc"} where "provider" is a service specific
-        #     dimension.
+        #     For example: `{"provider" : "Example Organization"}` where `provider` is a
+        #     service-specific quota dimension and `Example Organization` is the provider
+        #     name.
         # @!attribute [rw] quota_config
         #   @return [::Google::Cloud::CloudQuotas::V1::QuotaConfig]
         #     Required. Preferred quota configuration.
@@ -186,7 +187,7 @@ module Google
         # @!attribute [rw] quota_id
         #   @return [::String]
         #     Required. The id of the quota to which the quota preference is applied. A
-        #     quota name is unique in the service. Example: `CpusPerProjectPerRegion`
+        #     quota name is unique in the service. For example, `CpusPerProjectPerRegion`
         # @!attribute [r] reconciling
         #   @return [::Boolean]
         #     Output only. Is the quota preference pending Google Cloud approval and
@@ -196,9 +197,9 @@ module Google
         #     The reason / justification for this quota preference.
         # @!attribute [rw] contact_email
         #   @return [::String]
-        #     Input only. An email address that can be used to contact the the user, in
-        #     case Google Cloud needs more information to make a decision before
-        #     additional quota can be granted.
+        #     Input only. An email address that can be used to contact the user, in case
+        #     Google Cloud needs more information to make a decision before additional
+        #     quota can be granted.
         #
         #     When requesting a quota increase, the email address is required.
         #     When requesting a quota decrease, the email address is optional.
@@ -275,20 +276,21 @@ module Google
         # combination of dimensions.
         # @!attribute [rw] dimensions
         #   @return [::Google::Protobuf::Map{::String => ::String}]
-        #     The map of dimensions for this dimensions info. The key of a map entry
-        #     is "region", "zone" or the name of a service specific dimension, and the
-        #     value of a map entry is the value of the dimension.  If a dimension does
+        #     The map of dimensions in key-value pairs. The key of a map entry
+        #     is "region", "zone", or the name of a service-specific dimension, and the
+        #     value of a map entry is the value of the dimension. If a dimension does
         #     not appear in the map of dimensions, the dimensions info applies to all
-        #     the dimension values except for those that have another DimenisonInfo
+        #     the dimension values except for those that have another DimensionInfo
         #     instance configured for the specific value.
-        #     Example: \\{"provider" : "Foo Inc"} where "provider" is a service specific
-        #     dimension of a quota.
+        #     For example: `{"provider" : "Example Organization"}` where `provider` is a
+        #     service-specific quota dimension and `Example Organization` is the provider
+        #     name.
         # @!attribute [rw] details
         #   @return [::Google::Cloud::CloudQuotas::V1::QuotaDetails]
         #     Quota details for the specified dimensions.
         # @!attribute [rw] applicable_locations
         #   @return [::Array<::String>]
-        #     The applicable regions or zones of this dimensions info. The field will be
+        #     The applicable regions or zones of this dimension. The field is
         #     set to ['global'] for quotas that are not per region or per zone.
         #     Otherwise, it will be set to the list of locations this dimension info is
         #     applicable to.