google-cloud-service_management-v1 0.3.2 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7306075531d44e8358f0c03b0b9390c61d1409b39888d5bde21f755859b30f77
-  data.tar.gz: 9a29ecd54533e71dd540c9f64d90a3c3d056b505a9b3c9ace3038592dd544076
+  metadata.gz: faa6c83fb44c47cab7383ee4dbdab273ca6ebc9f063bdf65f7fb4de00b58d97f
+  data.tar.gz: bd0e7ee461809f43e833cd4f2924dd6874d9164a4c3276cb8f5c2474bf764bf1
 SHA512:
-  metadata.gz: 380636b6dd08932958e911cdd7cdee42d9cf11311cf23694f4d8375cfdaa799c0a7d2f1cf2b3693de02eacb5eeea57bf154e4b6ff84a1794c790a29ba63e1aa4
-  data.tar.gz: b98e03ff9014001a463d8f61fb6729749a26d54a906fe5ad14bc06232088a740dab1cc51a2003859a9230b3c9c3359d718da6537c39c73a26ab6319e7d8e3970
+  metadata.gz: 669ab7105ca677b89db972b83b7cd3be7dc20f227be23570c6a051ecdd1015d253f3dcc6b2da00fc80617c707635c1e15b27133fa24fde6188aca73e293dcc31
+  data.tar.gz: c937965c156a805b8f1b4849f77b0027c8f7705b3f22918e262942e6d1d291785596492616f66d550376de2f658e496c0ac49e0c483e574fbb3f2392c26e0692

data/AUTHENTICATION.md

@@ -66,11 +66,11 @@ The environment variables that google-cloud-service_management-v1
 checks for credentials are configured on the service Credentials class (such as
 {::Google::Cloud::ServiceManagement::V1::ServiceManager::Credentials}):
 
-1. `SERVICE_MANAGEMENT_CREDENTIALS` - Path to JSON file, or JSON contents
-2. `SERVICE_MANAGEMENT_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_MANAGEMENT_CREDENTIALS` - Path to JSON file, or JSON contents
+* `SERVICE_MANAGEMENT_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_management/v1"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::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_management/v1"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new do |
 end
 ```
 
-Or configured globally for all clients:
+Or globally for all clients:
 
 ```ruby
 require "google/cloud/service_management/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_management/v1"
 
 client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
-request = my_create_request
+request = ::Google::Cloud::ServiceManagement::V1::ListServicesRequest.new # (request fields as keyword arguments...)
 response = client.list_services request
 ```
 

data/lib/google/api/servicemanagement/v1/servicemanager_services_pb.rb

@@ -27,7 +27,7 @@ module Google
           # [Google Service Management API](https://cloud.google.com/service-management/overview)
           class Service
 
-            include ::GRPC::GenericService
+            include GRPC::GenericService
 
             self.marshal_class_method = :encode
             self.unmarshal_class_method = :decode

data/lib/google/cloud/service_management/v1/service_manager/client.rb

@@ -131,7 +131,7 @@ module Google
                                        !@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

data/lib/google/cloud/service_management/v1/service_manager/operations.rb

@@ -82,7 +82,7 @@ module Google
               # Create credentials
               credentials = @config.credentials
               credentials ||= Credentials.default scope: @config.scope
-              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
@@ -396,9 +396,9 @@ module Google
             end
 
             ##
-            # Waits for the specified long-running operation until it is done or reaches
-            # at most a specified timeout, returning the latest state.  If the operation
-            # is already done, the latest state is immediately returned.  If the timeout
+            # Waits until the specified long-running operation is done or reaches at most
+            # a specified timeout, returning the latest state.  If the operation is
+            # already done, the latest state is immediately returned.  If the timeout
             # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
             # timeout is used.  If the server does not support this method, it returns
             # `google.rpc.Code.UNIMPLEMENTED`.

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module ServiceManagement
       module V1
-        VERSION = "0.3.2"
+        VERSION = "0.3.3"
       end
     end
   end

data/proto_docs/google/api/auth.rb

@@ -19,9 +19,10 @@
 
 module Google
   module Api
-    # `Authentication` defines the authentication configuration for an API.
+    # `Authentication` defines the authentication configuration for API methods
+    # provided by an API service.
     #
-    # Example for an API targeted for external use:
+    # Example:
     #
     #     name: calendar.googleapis.com
     #     authentication:
@@ -33,6 +34,9 @@ module Google
     #       - selector: "*"
     #         requirements:
     #           provider_id: google_calendar_auth
+    #       - selector: google.calendar.Delegate
+    #         oauth:
+    #           canonical_scopes: https://www.googleapis.com/auth/calendar.read
     # @!attribute [rw] rules
     #   @return [::Array<::Google::Api::AuthenticationRule>]
     #     A list of authentication rules that apply to individual API methods.
@@ -66,6 +70,7 @@ module Google
     # @!attribute [rw] allow_without_credential
     #   @return [::Boolean]
     #     If true, the service accepts API keys without any other credential.
+    #     This flag only applies to HTTP and gRPC requests.
     # @!attribute [rw] requirements
     #   @return [::Array<::Google::Api::AuthRequirement>]
     #     Requirements for additional authentication providers.
@@ -74,8 +79,31 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
-    # Configuration for an anthentication provider, including support for
-    # [JSON Web Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
+    # Specifies a location to extract JWT from an API request.
+    # @!attribute [rw] header
+    #   @return [::String]
+    #     Specifies HTTP header name to extract JWT token.
+    # @!attribute [rw] query
+    #   @return [::String]
+    #     Specifies URL query parameter name to extract JWT token.
+    # @!attribute [rw] value_prefix
+    #   @return [::String]
+    #     The value prefix. The value format is "value_prefix\\{token}"
+    #     Only applies to "in" header type. Must be empty for "in" query type.
+    #     If not empty, the header value has to match (case sensitive) this prefix.
+    #     If not matched, JWT will not be extracted. If matched, JWT will be
+    #     extracted after the prefix is removed.
+    #
+    #     For example, for "Authorization: Bearer \\{JWT}",
+    #     value_prefix="Bearer " with a space at the end.
+    class JwtLocation
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
+    # Configuration for an authentication provider, including support for
+    # [JSON Web Token
+    # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
     # @!attribute [rw] id
     #   @return [::String]
     #     The unique identifier of the auth provider. It will be referred to by
@@ -93,12 +121,15 @@ module Google
     # @!attribute [rw] jwks_uri
     #   @return [::String]
     #     URL of the provider's public key set to validate signature of the JWT. See
-    #     [OpenID Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata).
+    #     [OpenID
+    #     Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata).
     #     Optional if the key set document:
     #      - can be retrieved from
-    #        [OpenID Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html
+    #        [OpenID
+    #        Discovery](https://openid.net/specs/openid-connect-discovery-1_0.html)
     #        of the issuer.
-    #      - can be inferred from the email domain of the issuer (e.g. a Google service account).
+    #      - can be inferred from the email domain of the issuer (e.g. a Google
+    #      service account).
     #
     #     Example: https://www.googleapis.com/oauth2/v1/certs
     # @!attribute [rw] audiences
@@ -106,11 +137,15 @@ module Google
     #     The list of JWT
     #     [audiences](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.3).
     #     that are allowed to access. A JWT containing any of these audiences will
-    #     be accepted. When this setting is absent, only JWTs with audience
-    #     "https://{::Google::Api::Service#name Service_name}/{::Google::Protobuf::Api#name API_name}"
-    #     will be accepted. For example, if no audiences are in the setting,
-    #     LibraryService API will only accept JWTs with the following audience
-    #     "https://library-example.googleapis.com/google.example.library.v1.LibraryService".
+    #     be accepted. When this setting is absent, JWTs with audiences:
+    #       - "https://[service.name]/[google.protobuf.Api.name]"
+    #       - "https://[service.name]/"
+    #     will be accepted.
+    #     For example, if no audiences are in the setting, LibraryService API will
+    #     accept JWTs with the following audiences:
+    #       -
+    #       https://library-example.googleapis.com/google.example.library.v1.LibraryService
+    #       - https://library-example.googleapis.com/
     #
     #     Example:
     #
@@ -118,8 +153,27 @@ module Google
     #                    bookstore_web.apps.googleusercontent.com
     # @!attribute [rw] authorization_url
     #   @return [::String]
-    #     Redirect URL if JWT token is required but no present or is expired.
+    #     Redirect URL if JWT token is required but not present or is expired.
     #     Implement authorizationUrl of securityDefinitions in OpenAPI spec.
+    # @!attribute [rw] jwt_locations
+    #   @return [::Array<::Google::Api::JwtLocation>]
+    #     Defines the locations to extract the JWT.
+    #
+    #     JWT locations can be either from HTTP headers or URL query parameters.
+    #     The rule is that the first match wins. The checking order is: checking
+    #     all headers first, then URL query parameters.
+    #
+    #     If not specified,  default to use following 3 locations:
+    #        1) Authorization: Bearer
+    #        2) x-goog-iap-jwt-assertion
+    #        3) access_token query parameter
+    #
+    #     Default locations can be specified as followings:
+    #        jwt_locations:
+    #        - header: Authorization
+    #          value_prefix: "Bearer "
+    #        - header: x-goog-iap-jwt-assertion
+    #        - query: access_token
     class AuthProvider
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -158,7 +212,8 @@ module Google
     end
 
     # User-defined authentication requirements, including support for
-    # [JSON Web Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
+    # [JSON Web Token
+    # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
     # @!attribute [rw] provider_id
     #   @return [::String]
     #     {::Google::Api::AuthProvider#id id} from authentication provider.

data/proto_docs/google/api/backend.rb

@@ -39,17 +39,133 @@ module Google
     # @!attribute [rw] address
     #   @return [::String]
     #     The address of the API backend.
+    #
+    #     The scheme is used to determine the backend protocol and security.
+    #     The following schemes are accepted:
+    #
+    #        SCHEME        PROTOCOL    SECURITY
+    #        http://       HTTP        None
+    #        https://      HTTP        TLS
+    #        grpc://       gRPC        None
+    #        grpcs://      gRPC        TLS
+    #
+    #     It is recommended to explicitly include a scheme. Leaving out the scheme
+    #     may cause constrasting behaviors across platforms.
+    #
+    #     If the port is unspecified, the default is:
+    #     - 80 for schemes without TLS
+    #     - 443 for schemes with TLS
+    #
+    #     For HTTP backends, use {::Google::Api::BackendRule#protocol protocol}
+    #     to specify the protocol version.
     # @!attribute [rw] deadline
     #   @return [::Float]
-    #     The number of seconds to wait for a response from a request.  The default
-    #     deadline for gRPC is infinite (no deadline) and HTTP requests is 5 seconds.
+    #     The number of seconds to wait for a response from a request. The default
+    #     varies based on the request protocol and deployment environment.
     # @!attribute [rw] min_deadline
     #   @return [::Float]
     #     Minimum deadline in seconds needed for this method. Calls having deadline
     #     value lower than this will be rejected.
+    # @!attribute [rw] operation_deadline
+    #   @return [::Float]
+    #     The number of seconds to wait for the completion of a long running
+    #     operation. The default is no deadline.
+    # @!attribute [rw] path_translation
+    #   @return [::Google::Api::BackendRule::PathTranslation]
+    # @!attribute [rw] jwt_audience
+    #   @return [::String]
+    #     The JWT audience is used when generating a JWT ID token for the backend.
+    #     This ID token will be added in the HTTP "authorization" header, and sent
+    #     to the backend.
+    # @!attribute [rw] disable_auth
+    #   @return [::Boolean]
+    #     When disable_auth is true, a JWT ID token won't be generated and the
+    #     original "Authorization" HTTP header will be preserved. If the header is
+    #     used to carry the original token and is expected by the backend, this
+    #     field must be set to true to preserve the header.
+    # @!attribute [rw] protocol
+    #   @return [::String]
+    #     The protocol used for sending a request to the backend.
+    #     The supported values are "http/1.1" and "h2".
+    #
+    #     The default value is inferred from the scheme in the
+    #     {::Google::Api::BackendRule#address address} field:
+    #
+    #        SCHEME        PROTOCOL
+    #        http://       http/1.1
+    #        https://      http/1.1
+    #        grpc://       h2
+    #        grpcs://      h2
+    #
+    #     For secure HTTP backends (https://) that support HTTP/2, set this field
+    #     to "h2" for improved performance.
+    #
+    #     Configuring this field to non-default values is only supported for secure
+    #     HTTP backends. This field will be ignored for all other backends.
+    #
+    #     See
+    #     https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids
+    #     for more details on the supported values.
     class BackendRule
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # Path Translation specifies how to combine the backend address with the
+      # request path in order to produce the appropriate forwarding URL for the
+      # request.
+      #
+      # Path Translation is applicable only to HTTP-based backends. Backends which
+      # do not accept requests over HTTP/HTTPS should leave `path_translation`
+      # unspecified.
+      module PathTranslation
+        PATH_TRANSLATION_UNSPECIFIED = 0
+
+        # Use the backend address as-is, with no modification to the path. If the
+        # URL pattern contains variables, the variable names and values will be
+        # appended to the query string. If a query string parameter and a URL
+        # pattern variable have the same name, this may result in duplicate keys in
+        # the query string.
+        #
+        # # Examples
+        #
+        # Given the following operation config:
+        #
+        #     Method path:        /api/company/{cid}/user/{uid}
+        #     Backend address:    https://example.cloudfunctions.net/getUser
+        #
+        # Requests to the following request paths will call the backend at the
+        # translated path:
+        #
+        #     Request path: /api/company/widgetworks/user/johndoe
+        #     Translated:
+        #     https://example.cloudfunctions.net/getUser?cid=widgetworks&uid=johndoe
+        #
+        #     Request path: /api/company/widgetworks/user/johndoe?timezone=EST
+        #     Translated:
+        #     https://example.cloudfunctions.net/getUser?timezone=EST&cid=widgetworks&uid=johndoe
+        CONSTANT_ADDRESS = 1
+
+        # The request path will be appended to the backend address.
+        #
+        # # Examples
+        #
+        # Given the following operation config:
+        #
+        #     Method path:        /api/company/{cid}/user/{uid}
+        #     Backend address:    https://example.appspot.com
+        #
+        # Requests to the following request paths will call the backend at the
+        # translated path:
+        #
+        #     Request path: /api/company/widgetworks/user/johndoe
+        #     Translated:
+        #     https://example.appspot.com/api/company/widgetworks/user/johndoe
+        #
+        #     Request path: /api/company/widgetworks/user/johndoe?timezone=EST
+        #     Translated:
+        #     https://example.appspot.com/api/company/widgetworks/user/johndoe?timezone=EST
+        APPEND_PATH_TO_ADDRESS = 2
+      end
     end
   end
 end

data/proto_docs/google/api/billing.rb

@@ -22,22 +22,33 @@ module Google
     # Billing related configuration of the service.
     #
     # The following example shows how to configure monitored resources and metrics
-    # for billing:
+    # for billing, `consumer_destinations` is the only supported destination and
+    # the monitored resources need at least one label key
+    # `cloud.googleapis.com/location` to indicate the location of the billing
+    # usage, using different monitored resources between monitoring and billing is
+    # recommended so they can be evolved independently:
+    #
     #
     #     monitored_resources:
-    #     - type: library.googleapis.com/branch
+    #     - type: library.googleapis.com/billing_branch
     #       labels:
-    #       - key: /city
-    #         description: The city where the library branch is located in.
-    #       - key: /name
-    #         description: The name of the branch.
+    #       - key: cloud.googleapis.com/location
+    #         description: |
+    #           Predefined label to support billing location restriction.
+    #       - key: city
+    #         description: |
+    #           Custom label to define the city where the library branch is located
+    #           in.
+    #       - key: name
+    #         description: Custom label to define the name of the library branch.
     #     metrics:
     #     - name: library.googleapis.com/book/borrowed_count
     #       metric_kind: DELTA
     #       value_type: INT64
+    #       unit: "1"
     #     billing:
     #       consumer_destinations:
-    #       - monitored_resource: library.googleapis.com/branch
+    #       - monitored_resource: library.googleapis.com/billing_branch
     #         metrics:
     #         - library.googleapis.com/book/borrowed_count
     # @!attribute [rw] consumer_destinations

data/proto_docs/google/api/config_change.rb

@@ -33,7 +33,7 @@ module Google
     #     'key' is used. If the field has no unique identifier, the numeric index
     #     is used.
     #     Examples:
-    #     - visibility.rules[selector=="google.LibraryService.CreateBook"].restriction
+    #     - visibility.rules[selector=="google.LibraryService.ListBooks"].restriction
     #     - quota.metric_rules[selector=="google"].metric_costs[key=="reads"].value
     #     - logging.producer_destinations[0]
     # @!attribute [rw] old_value

data/proto_docs/google/api/context.rb

@@ -36,6 +36,25 @@ module Google
     #
     # Available context types are defined in package
     # `google.rpc.context`.
+    #
+    # This also provides mechanism to allowlist any protobuf message extension that
+    # can be sent in grpc metadata using “x-goog-ext-<extension_id>-bin” and
+    # “x-goog-ext-<extension_id>-jspb” format. For example, list any service
+    # specific protobuf types that can appear in grpc metadata as follows in your
+    # yaml file:
+    #
+    # Example:
+    #
+    #     context:
+    #       rules:
+    #        - selector: "google.example.library.v1.LibraryService.CreateBook"
+    #          allowed_request_extensions:
+    #          - google.foo.v1.NewExtension
+    #          allowed_response_extensions:
+    #          - google.foo.v1.NewExtension
+    #
+    # You can also specify extension ID instead of fully qualified extension name
+    # here.
     # @!attribute [rw] rules
     #   @return [::Array<::Google::Api::ContextRule>]
     #     A list of RPC context rules that apply to individual API methods.
@@ -59,6 +78,14 @@ module Google
     # @!attribute [rw] provided
     #   @return [::Array<::String>]
     #     A list of full type names of provided contexts.
+    # @!attribute [rw] allowed_request_extensions
+    #   @return [::Array<::String>]
+    #     A list of full type names or extension IDs of extensions allowed in grpc
+    #     side channel from client to backend.
+    # @!attribute [rw] allowed_response_extensions
+    #   @return [::Array<::String>]
+    #     A list of full type names or extension IDs of extensions allowed in grpc
+    #     side channel from backend to client.
     class ContextRule
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/api/documentation.rb

@@ -89,6 +89,12 @@ module Google
     # @!attribute [rw] documentation_root_url
     #   @return [::String]
     #     The URL to the root of documentation.
+    # @!attribute [rw] service_root_url
+    #   @return [::String]
+    #     Specifies the service root url if the default one (the service name
+    #     from the yaml file) is not suitable. This can be seen in any fully
+    #     specified service urls as well as sections that show a base that other
+    #     urls are relative to.
     # @!attribute [rw] overview
     #   @return [::String]
     #     Declares a single overview page. For example:
@@ -115,16 +121,16 @@ module Google
     #     The selector is a comma-separated list of patterns. Each pattern is a
     #     qualified name of the element which may end in "*", indicating a wildcard.
     #     Wildcards are only allowed at the end and for a whole component of the
-    #     qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". To
-    #     specify a default for all applicable elements, the whole pattern "*"
-    #     is used.
+    #     qualified name, i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A
+    #     wildcard will match one or more components. To specify a default for all
+    #     applicable elements, the whole pattern "*" is used.
     # @!attribute [rw] description
     #   @return [::String]
     #     Description of the selected API(s).
     # @!attribute [rw] deprecation_description
     #   @return [::String]
-    #     Deprecation description of the selected element(s). It can be provided if an
-    #     element is marked as `deprecated`.
+    #     Deprecation description of the selected element(s). It can be provided if
+    #     an element is marked as `deprecated`.
     class DocumentationRule
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -150,8 +156,8 @@ module Google
     #     `[Java][Tutorial.Java]`.
     # @!attribute [rw] content
     #   @return [::String]
-    #     The Markdown content of the page. You can use <code>&#40;== include \\{path} ==&#41;</code>
-    #     to include content from a Markdown file.
+    #     The Markdown content of the page. You can use <code>&#40;== include \\{path}
+    #     ==&#41;</code> to include content from a Markdown file.
     # @!attribute [rw] subpages
     #   @return [::Array<::Google::Api::Page>]
     #     Subpages of this page. The order of subpages specified here will be

data/proto_docs/google/api/endpoint.rb

@@ -19,10 +19,10 @@
 
 module Google
   module Api
-    # `Endpoint` describes a network endpoint that serves a set of APIs.
-    # A service may expose any number of endpoints, and all endpoints share the
-    # same service configuration, such as quota configuration and monitoring
-    # configuration.
+    # `Endpoint` describes a network endpoint of a service that serves a set of
+    # APIs. It is commonly known as a service endpoint. A service may expose
+    # any number of service endpoints, and all service endpoints share the same
+    # service definition, such as quota limits and monitoring metrics.
     #
     # Example service configuration:
     #
@@ -40,20 +40,20 @@ module Google
     #     The canonical name of this endpoint.
     # @!attribute [rw] aliases
     #   @return [::Array<::String>]
+    #     Unimplemented. Dot not use.
+    #
     #     DEPRECATED: This field is no longer supported. Instead of using aliases,
     #     please specify multiple {::Google::Api::Endpoint google.api.Endpoint} for each of the intended
     #     aliases.
     #
     #     Additional names that this endpoint will be hosted on.
-    # @!attribute [rw] features
-    #   @return [::Array<::String>]
-    #     The list of features enabled on this endpoint.
     # @!attribute [rw] target
     #   @return [::String]
     #     The specification of an Internet routable address of API frontend that will
-    #     handle requests to this [API Endpoint](https://cloud.google.com/apis/design/glossary).
-    #     It should be either a valid IPv4 address or a fully-qualified domain name.
-    #     For example, "8.8.8.8" or "myservice.appspot.com".
+    #     handle requests to this [API
+    #     Endpoint](https://cloud.google.com/apis/design/glossary). It should be
+    #     either a valid IPv4 address or a fully-qualified domain name. For example,
+    #     "8.8.8.8" or "myservice.appspot.com".
     # @!attribute [rw] allow_cors
     #   @return [::Boolean]
     #     Allowing

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/api/launch_stage.rb

@@ -0,0 +1,71 @@
+# 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
+    # The launch stage as defined by [Google Cloud Platform
+    # Launch Stages](http://cloud.google.com/terms/launch-stages).
+    module LaunchStage
+      # Do not use this default value.
+      LAUNCH_STAGE_UNSPECIFIED = 0
+
+      # The feature is not yet implemented. Users can not use it.
+      UNIMPLEMENTED = 6
+
+      # Prelaunch features are hidden from users and are only visible internally.
+      PRELAUNCH = 7
+
+      # Early Access features are limited to a closed group of testers. To use
+      # these features, you must sign up in advance and sign a Trusted Tester
+      # agreement (which includes confidentiality provisions). These features may
+      # be unstable, changed in backward-incompatible ways, and are not
+      # guaranteed to be released.
+      EARLY_ACCESS = 1
+
+      # Alpha is a limited availability test for releases before they are cleared
+      # for widespread use. By Alpha, all significant design issues are resolved
+      # and we are in the process of verifying functionality. Alpha customers
+      # need to apply for access, agree to applicable terms, and have their
+      # projects allowlisted. Alpha releases don’t have to be feature complete,
+      # no SLAs are provided, and there are no technical support obligations, but
+      # they will be far enough along that customers can actually use them in
+      # test environments or for limited-use tests -- just like they would in
+      # normal production cases.
+      ALPHA = 2
+
+      # Beta is the point at which we are ready to open a release for any
+      # customer to use. There are no SLA or technical support obligations in a
+      # Beta release. Products will be complete from a feature perspective, but
+      # may have some open outstanding issues. Beta releases are suitable for
+      # limited production use cases.
+      BETA = 3
+
+      # GA features are open to all developers and are considered stable and
+      # fully qualified for production use.
+      GA = 4
+
+      # Deprecated features are scheduled to be shut down and removed. For more
+      # information, see the “Deprecation Policy” section of our [Terms of
+      # Service](https://cloud.google.com/terms/)
+      # and the [Google Cloud Platform Subject to the Deprecation
+      # Policy](https://cloud.google.com/terms/deprecation) documentation.
+      DEPRECATED = 5
+    end
+  end
+end

data/proto_docs/google/api/metric.rb

@@ -28,11 +28,12 @@ module Google
     # @!attribute [rw] type
     #   @return [::String]
     #     The metric type, including its DNS name prefix. The type is not
-    #     URL-encoded.  All user-defined custom metric types have the DNS name
-    #     `custom.googleapis.com`.  Metric types should use a natural hierarchical
-    #     grouping. For example:
+    #     URL-encoded. All user-defined metric types have the DNS name
+    #     `custom.googleapis.com` or `external.googleapis.com`. Metric types should
+    #     use a natural hierarchical grouping. For example:
     #
     #         "custom.googleapis.com/invoice/paid/amount"
+    #         "external.googleapis.com/prometheus/up"
     #         "appengine.googleapis.com/http/server/response_latencies"
     # @!attribute [rw] labels
     #   @return [::Array<::Google::Api::LabelDescriptor>]
@@ -52,10 +53,28 @@ module Google
     #     Some combinations of `metric_kind` and `value_type` might not be supported.
     # @!attribute [rw] unit
     #   @return [::String]
-    #     The unit in which the metric value is reported. It is only applicable
-    #     if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
-    #     supported units are a subset of [The Unified Code for Units of
-    #     Measure](http://unitsofmeasure.org/ucum.html) standard:
+    #     The units in which the metric value is reported. It is only applicable
+    #     if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The `unit`
+    #     defines the representation of the stored metric values.
+    #
+    #     Different systems might scale the values to be more easily displayed (so a
+    #     value of `0.02kBy` _might_ be displayed as `20By`, and a value of
+    #     `3523kBy` _might_ be displayed as `3.5MBy`). However, if the `unit` is
+    #     `kBy`, then the value of the metric is always in thousands of bytes, no
+    #     matter how it might be displayed.
+    #
+    #     If you want a custom metric to record the exact number of CPU-seconds used
+    #     by a job, you can create an `INT64 CUMULATIVE` metric whose `unit` is
+    #     `s{CPU}` (or equivalently `1s{CPU}` or just `s`). If the job uses 12,005
+    #     CPU-seconds, then the value is written as `12005`.
+    #
+    #     Alternatively, if you want a custom metric to record data in a more
+    #     granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is
+    #     `ks{CPU}`, and then write the value `12.005` (which is `12005/1000`),
+    #     or use `Kis{CPU}` and write `11.723` (which is `12005/1024`).
+    #
+    #     The supported units are a subset of [The Unified Code for Units of
+    #     Measure](https://unitsofmeasure.org/ucum.html) standard:
     #
     #     **Basic units (UNIT)**
     #
@@ -65,36 +84,44 @@ module Google
     #     * `min`   minute
     #     * `h`     hour
     #     * `d`     day
+    #     * `1`     dimensionless
     #
     #     **Prefixes (PREFIX)**
     #
-    #     * `k`     kilo    (10**3)
-    #     * `M`     mega    (10**6)
-    #     * `G`     giga    (10**9)
-    #     * `T`     tera    (10**12)
-    #     * `P`     peta    (10**15)
-    #     * `E`     exa     (10**18)
-    #     * `Z`     zetta   (10**21)
-    #     * `Y`     yotta   (10**24)
-    #     * `m`     milli   (10**-3)
-    #     * `u`     micro   (10**-6)
-    #     * `n`     nano    (10**-9)
-    #     * `p`     pico    (10**-12)
-    #     * `f`     femto   (10**-15)
-    #     * `a`     atto    (10**-18)
-    #     * `z`     zepto   (10**-21)
-    #     * `y`     yocto   (10**-24)
-    #     * `Ki`    kibi    (2**10)
-    #     * `Mi`    mebi    (2**20)
-    #     * `Gi`    gibi    (2**30)
-    #     * `Ti`    tebi    (2**40)
+    #     * `k`     kilo    (10^3)
+    #     * `M`     mega    (10^6)
+    #     * `G`     giga    (10^9)
+    #     * `T`     tera    (10^12)
+    #     * `P`     peta    (10^15)
+    #     * `E`     exa     (10^18)
+    #     * `Z`     zetta   (10^21)
+    #     * `Y`     yotta   (10^24)
+    #
+    #     * `m`     milli   (10^-3)
+    #     * `u`     micro   (10^-6)
+    #     * `n`     nano    (10^-9)
+    #     * `p`     pico    (10^-12)
+    #     * `f`     femto   (10^-15)
+    #     * `a`     atto    (10^-18)
+    #     * `z`     zepto   (10^-21)
+    #     * `y`     yocto   (10^-24)
+    #
+    #     * `Ki`    kibi    (2^10)
+    #     * `Mi`    mebi    (2^20)
+    #     * `Gi`    gibi    (2^30)
+    #     * `Ti`    tebi    (2^40)
+    #     * `Pi`    pebi    (2^50)
     #
     #     **Grammar**
     #
     #     The grammar also includes these connectors:
     #
-    #     * `/`    division (as an infix operator, e.g. `1/s`).
-    #     * `.`    multiplication (as an infix operator, e.g. `GBy.d`)
+    #     * `/`    division or ratio (as an infix operator). For examples,
+    #              `kBy/{email}` or `MiBy/10ms` (although you should almost never
+    #              have `/s` in a metric `unit`; rates should always be computed at
+    #              query time from the underlying cumulative or delta value).
+    #     * `.`    multiplication or composition (as an infix operator). For
+    #              examples, `GBy.d` or `k{watt}.h`.
     #
     #     The grammar for a unit is as follows:
     #
@@ -109,14 +136,25 @@ module Google
     #
     #     Notes:
     #
-    #     * `Annotation` is just a comment if it follows a `UNIT` and is
-    #        equivalent to `1` if it is used alone. For examples,
-    #        `{requests}/s == 1/s`, `By{transmitted}/s == By/s`.
+    #     * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
+    #        is used alone, then the unit is equivalent to `1`. For examples,
+    #        `{request}/s == 1/s`, `By{transmitted}/s == By/s`.
     #     * `NAME` is a sequence of non-blank printable ASCII characters not
-    #        containing '\\{' or '}'.
-    #     * `1` represents dimensionless value 1, such as in `1/s`.
-    #     * `%` represents dimensionless value 1/100, and annotates values giving
-    #        a percentage.
+    #        containing `{` or `}`.
+    #     * `1` represents a unitary [dimensionless
+    #        unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
+    #        as in `1/s`. It is typically used when none of the basic units are
+    #        appropriate. For example, "new users per day" can be represented as
+    #        `1/d` or `{new-users}/d` (and a metric value `5` would mean "5 new
+    #        users). Alternatively, "thousands of page views per day" would be
+    #        represented as `1000/d` or `k1/d` or `k{page_views}/d` (and a metric
+    #        value of `5.3` would mean "5300 page views per day").
+    #     * `%` represents dimensionless value of 1/100, and annotates values giving
+    #        a percentage (so the metric values are typically in the range of 0..100,
+    #        and a metric value `3` means "3 percent").
+    #     * `10^2.%` indicates a metric contains a ratio, typically in the range
+    #        0..1, that will be multiplied by 100 and displayed as a percentage
+    #        (so a metric value `0.03` means "3 percent").
     # @!attribute [rw] description
     #   @return [::String]
     #     A detailed description of the metric, which can be used in documentation.
@@ -126,11 +164,46 @@ module Google
     #     Use sentence case without an ending period, for example "Request count".
     #     This field is optional but it is recommended to be set for any metrics
     #     associated with user-visible concepts, such as Quota.
+    # @!attribute [rw] metadata
+    #   @return [::Google::Api::MetricDescriptor::MetricDescriptorMetadata]
+    #     Optional. Metadata which can be used to guide usage of the metric.
+    # @!attribute [rw] launch_stage
+    #   @return [::Google::Api::LaunchStage]
+    #     Optional. The launch stage of the metric definition.
+    # @!attribute [rw] monitored_resource_types
+    #   @return [::Array<::String>]
+    #     Read-only. If present, then a [time
+    #     series][google.monitoring.v3.TimeSeries], which is identified partially by
+    #     a metric type and a {::Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor}, that is associated
+    #     with this metric type can only be associated with one of the monitored
+    #     resource types listed here.
     class MetricDescriptor
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
 
+      # Additional annotations that can be used to guide the usage of a metric.
+      # @!attribute [rw] launch_stage
+      #   @return [::Google::Api::LaunchStage]
+      #     Deprecated. Must use the {::Google::Api::MetricDescriptor#launch_stage MetricDescriptor.launch_stage} instead.
+      # @!attribute [rw] sample_period
+      #   @return [::Google::Protobuf::Duration]
+      #     The sampling period of metric data points. For metrics which are written
+      #     periodically, consecutive data points are stored at this time interval,
+      #     excluding data loss due to errors. Metrics with a higher granularity have
+      #     a smaller sampling period.
+      # @!attribute [rw] ingest_delay
+      #   @return [::Google::Protobuf::Duration]
+      #     The delay of data points caused by ingestion. Data points older than this
+      #     age are guaranteed to be ingested and available to be read, excluding
+      #     data loss due to errors.
+      class MetricDescriptorMetadata
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
       # The kind of measurement. It describes how the data is reported.
+      # For information on setting the start time and end time based on
+      # the MetricKind, see [TimeInterval][google.monitoring.v3.TimeInterval].
       module MetricKind
         # Do not use this default value.
         METRIC_KIND_UNSPECIFIED = 0

data/proto_docs/google/api/monitored_resource.rb

@@ -40,7 +40,6 @@ module Google
     #   @return [::String]
     #     Required. The monitored resource type. For example, the type
     #     `"cloudsql_database"` represents databases in Google Cloud SQL.
-    #     The maximum length of this value is 256 characters.
     # @!attribute [rw] display_name
     #   @return [::String]
     #     Optional. A concise name for the monitored resource type that might be
@@ -56,6 +55,9 @@ module Google
     #     Required. A set of labels used to describe instances of this monitored
     #     resource type. For example, an individual Google Cloud SQL database is
     #     identified by values for the labels `"database_id"` and `"zone"`.
+    # @!attribute [rw] launch_stage
+    #   @return [::Google::Api::LaunchStage]
+    #     Optional. The launch stage of the monitored resource definition.
     class MonitoredResourceDescriptor
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -101,15 +103,14 @@ module Google
     # Auxiliary metadata for a {::Google::Api::MonitoredResource MonitoredResource} object.
     # {::Google::Api::MonitoredResource MonitoredResource} objects contain the minimum set of information to
     # uniquely identify a monitored resource instance. There is some other useful
-    # auxiliary metadata. Google Stackdriver Monitoring & Logging uses an ingestion
-    # pipeline to extract metadata for cloud resources of all types , and stores
+    # auxiliary metadata. Monitoring and Logging use an ingestion
+    # pipeline to extract metadata for cloud resources of all types, and store
     # the metadata in this message.
     # @!attribute [rw] system_labels
     #   @return [::Google::Protobuf::Struct]
     #     Output only. Values for predefined system metadata labels.
-    #     System labels are a kind of metadata extracted by Google Stackdriver.
-    #     Stackdriver determines what system labels are useful and how to obtain
-    #     their values. Some examples: "machine_image", "vpc", "subnet_id",
+    #     System labels are a kind of metadata extracted by Google, including
+    #     "machine_image", "vpc", "subnet_id",
     #     "security_group", "name", etc.
     #     System label values can be only strings, Boolean values, or a list of
     #     strings. For example:

data/proto_docs/google/api/monitoring.rb

@@ -25,49 +25,68 @@ module Google
     # for monitoring. In the example, a monitored resource and two metrics are
     # defined. The `library.googleapis.com/book/returned_count` metric is sent
     # to both producer and consumer projects, whereas the
-    # `library.googleapis.com/book/overdue_count` metric is only sent to the
+    # `library.googleapis.com/book/num_overdue` metric is only sent to the
     # consumer project.
     #
     #     monitored_resources:
-    #     - type: library.googleapis.com/branch
+    #     - type: library.googleapis.com/Branch
+    #       display_name: "Library Branch"
+    #       description: "A branch of a library."
+    #       launch_stage: GA
     #       labels:
-    #       - key: /city
-    #         description: The city where the library branch is located in.
-    #       - key: /name
-    #         description: The name of the branch.
+    #       - key: resource_container
+    #         description: "The Cloud container (ie. project id) for the Branch."
+    #       - key: location
+    #         description: "The location of the library branch."
+    #       - key: branch_id
+    #         description: "The id of the branch."
     #     metrics:
     #     - name: library.googleapis.com/book/returned_count
+    #       display_name: "Books Returned"
+    #       description: "The count of books that have been returned."
+    #       launch_stage: GA
     #       metric_kind: DELTA
     #       value_type: INT64
+    #       unit: "1"
     #       labels:
-    #       - key: /customer_id
-    #     - name: library.googleapis.com/book/overdue_count
+    #       - key: customer_id
+    #         description: "The id of the customer."
+    #     - name: library.googleapis.com/book/num_overdue
+    #       display_name: "Books Overdue"
+    #       description: "The current number of overdue books."
+    #       launch_stage: GA
     #       metric_kind: GAUGE
     #       value_type: INT64
+    #       unit: "1"
     #       labels:
-    #       - key: /customer_id
+    #       - key: customer_id
+    #         description: "The id of the customer."
     #     monitoring:
     #       producer_destinations:
-    #       - monitored_resource: library.googleapis.com/branch
+    #       - monitored_resource: library.googleapis.com/Branch
     #         metrics:
     #         - library.googleapis.com/book/returned_count
     #       consumer_destinations:
-    #       - monitored_resource: library.googleapis.com/branch
+    #       - monitored_resource: library.googleapis.com/Branch
     #         metrics:
     #         - library.googleapis.com/book/returned_count
-    #         - library.googleapis.com/book/overdue_count
+    #         - library.googleapis.com/book/num_overdue
     # @!attribute [rw] producer_destinations
     #   @return [::Array<::Google::Api::Monitoring::MonitoringDestination>]
     #     Monitoring configurations for sending metrics to the producer project.
-    #     There can be multiple producer destinations, each one must have a
-    #     different monitored resource type. A metric can be used in at most
-    #     one producer destination.
+    #     There can be multiple producer destinations. A monitored resource type may
+    #     appear in multiple monitoring destinations if different aggregations are
+    #     needed for different sets of metrics associated with that monitored
+    #     resource type. A monitored resource and metric pair may only be used once
+    #     in the Monitoring configuration.
     # @!attribute [rw] consumer_destinations
     #   @return [::Array<::Google::Api::Monitoring::MonitoringDestination>]
     #     Monitoring configurations for sending metrics to the consumer project.
-    #     There can be multiple consumer destinations, each one must have a
-    #     different monitored resource type. A metric can be used in at most
-    #     one consumer destination.
+    #     There can be multiple consumer destinations. A monitored resource type may
+    #     appear in multiple monitoring destinations if different aggregations are
+    #     needed for different sets of metrics associated with that monitored
+    #     resource type. A monitored resource and metric pair may only be used once
+    #     in the Monitoring configuration.
     class Monitoring
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -80,8 +99,8 @@ module Google
       #     {::Google::Api::Service#monitored_resources Service.monitored_resources} section.
       # @!attribute [rw] metrics
       #   @return [::Array<::String>]
-      #     Names of the metrics to report to this monitoring destination.
-      #     Each name must be defined in {::Google::Api::Service#metrics Service.metrics} section.
+      #     Types of the metrics to report to this monitoring destination.
+      #     Each type must be defined in {::Google::Api::Service#metrics Service.metrics} section.
       class MonitoringDestination
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/api/quota.rb

@@ -22,7 +22,7 @@ module Google
     # Quota configuration helps to achieve fairness and budgeting in service
     # usage.
     #
-    # The quota configuration works this way:
+    # The metric based quota configuration works this way:
     # - The service configuration defines a set of metrics.
     # - For API calls, the quota.metric_rules maps methods to metrics with
     #   corresponding costs.
@@ -40,6 +40,7 @@ module Google
     #        values:
     #          STANDARD: 10000
     #
+    #
     #      # The metric rules bind all methods to the read_calls metric,
     #      # except for the UpdateBook and DeleteBook methods. These two methods
     #      # are mapped to the write_calls metric, with the UpdateBook method
@@ -70,24 +71,17 @@ module Google
     # @!attribute [rw] limits
     #   @return [::Array<::Google::Api::QuotaLimit>]
     #     List of `QuotaLimit` definitions for the service.
-    #
-    #     Used by metric-based quotas only.
     # @!attribute [rw] metric_rules
     #   @return [::Array<::Google::Api::MetricRule>]
     #     List of `MetricRule` definitions, each one mapping a selected method to one
     #     or more metrics.
-    #
-    #     Used by metric-based quotas only.
     class Quota
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
     # Bind API methods to metrics. Binding a method to a metric causes that
-    # metric's configured quota, billing, and monitoring behaviors to apply to the
-    # method call.
-    #
-    # Used by metric-based quotas only.
+    # metric's configured quota behaviors to apply to the method call.
     # @!attribute [rw] selector
     #   @return [::String]
     #     Selects the methods to which this rule applies.
@@ -120,24 +114,12 @@ module Google
     # type combination defined within a `QuotaGroup`.
     # @!attribute [rw] name
     #   @return [::String]
-    #     Name of the quota limit. The name is used to refer to the limit when
-    #     overriding the default limit on per-consumer basis.
+    #     Name of the quota limit.
     #
-    #     For group-based quota limits, the name must be unique within the quota
-    #     group. If a name is not provided, it will be generated from the limit_by
-    #     and duration fields.
-    #
-    #     For metric-based quota limits, the name must be provided, and it must be
-    #     unique within the service. The name can only include alphanumeric
-    #     characters as well as '-'.
+    #     The name must be provided, and it must be unique within the service. The
+    #     name can only include alphanumeric characters as well as '-'.
     #
     #     The maximum length of the limit name is 64 characters.
-    #
-    #     The name of a limit is used as a unique identifier for this limit.
-    #     Therefore, once a limit has been put into use, its name should be
-    #     immutable. You can use the display_name field to provide a user-friendly
-    #     name for the limit. The display name can be evolved over time without
-    #     affecting the identity of the limit.
     # @!attribute [rw] description
     #   @return [::String]
     #     Optional. User-visible, extended description for this quota limit.
@@ -178,10 +160,7 @@ module Google
     #     Used by group-based quotas only.
     # @!attribute [rw] duration
     #   @return [::String]
-    #     Duration of this limit in textual notation. Example: "100s", "24h", "1d".
-    #     For duration longer than a day, only multiple of days is supported. We
-    #     support only "100s" and "1d" for now. Additional support will be added in
-    #     the future. "0" indicates indefinite duration.
+    #     Duration of this limit in textual notation. Must be "100s" or "1d".
     #
     #     Used by group-based quotas only.
     # @!attribute [rw] metric
@@ -189,75 +168,22 @@ module Google
     #     The name of the metric this quota limit applies to. The quota limits with
     #     the same metric will be checked together during runtime. The metric must be
     #     defined within the service config.
-    #
-    #     Used by metric-based quotas only.
     # @!attribute [rw] unit
     #   @return [::String]
     #     Specify the unit of the quota limit. It uses the same syntax as
     #     [Metric.unit][]. The supported unit kinds are determined by the quota
     #     backend system.
     #
-    #     The [Google Service Control](https://cloud.google.com/service-control)
-    #     supports the following unit components:
-    #     * One of the time intevals:
-    #       * "/min"  for quota every minute.
-    #       * "/d"  for quota every 24 hours, starting 00:00 US Pacific Time.
-    #       * Otherwise the quota won't be reset by time, such as storage limit.
-    #     * One and only one of the granted containers:
-    #       * "/\\{organization}" quota for an organization.
-    #       * "/\\{project}" quota for a project.
-    #       * "/\\{folder}" quota for a folder.
-    #       * "/\\{resource}" quota for a universal resource.
-    #     * Zero or more quota segmentation dimension. Not all combos are valid.
-    #       * "/\\{region}" quota for every region. Not to be used with time intervals.
-    #       * Otherwise the resources granted on the target is not segmented.
-    #       * "/\\{zone}" quota for every zone. Not to be used with time intervals.
-    #       * Otherwise the resources granted on the target is not segmented.
-    #       * "/\\{resource}" quota for a resource associated with a project or org.
-    #
     #     Here are some examples:
     #     * "1/min/\\{project}" for quota per minute per project.
-    #     * "1/min/\\{user}" for quota per minute per user.
-    #     * "1/min/\\{organization}" for quota per minute per organization.
     #
     #     Note: the order of unit components is insignificant.
     #     The "1" at the beginning is required to follow the metric unit syntax.
-    #
-    #     Used by metric-based quotas only.
     # @!attribute [rw] values
     #   @return [::Google::Protobuf::Map{::String => ::Integer}]
-    #     Tiered limit values. Also allows for regional or zone overrides for these
-    #     values if "/\\{region}" or "/\\{zone}" is specified in the unit field.
-    #
-    #     Currently supported tiers from low to high:
-    #     VERY_LOW, LOW, STANDARD, HIGH, VERY_HIGH
-    #
-    #     To apply different limit values for users according to their tiers, specify
-    #     the values for the tiers you want to differentiate. For example:
-    #     \\{LOW:100, STANDARD:500, HIGH:1000, VERY_HIGH:5000}
-    #
-    #     The limit value for each tier is optional except for the tier STANDARD.
-    #     The limit value for an unspecified tier falls to the value of its next
-    #     tier towards tier STANDARD. For the above example, the limit value for tier
-    #     STANDARD is 500.
-    #
-    #     To apply the same limit value for all users, just specify limit value for
-    #     tier STANDARD. For example: \\{STANDARD:500}.
-    #
-    #     To apply a regional overide for a tier, add a map entry with key
-    #     "<TIER>/<region>", where <region> is a region name. Similarly, for a zone
-    #     override, add a map entry with key "<TIER>/\\{zone}".
-    #     Further, a wildcard can be used at the end of a zone name in order to
-    #     specify zone level overrides. For example:
-    #     LOW: 10, STANDARD: 50, HIGH: 100,
-    #     LOW/us-central1: 20, STANDARD/us-central1: 60, HIGH/us-central1: 200,
-    #     LOW/us-central1-*: 10, STANDARD/us-central1-*: 20, HIGH/us-central1-*: 80
-    #
-    #     The regional overrides tier set for each region must be the same as
-    #     the tier set for default limit values. Same rule applies for zone overrides
-    #     tier as well.
-    #
-    #     Used by metric-based quotas only.
+    #     Tiered limit values. You must specify this as a key:value pair, with an
+    #     integer value that is the maximum number of requests allowed for the
+    #     specified unit. Currently only STANDARD is supported.
     # @!attribute [rw] display_name
     #   @return [::String]
     #     User-visible display name for this limit.

data/proto_docs/google/api/service.rb

@@ -28,7 +28,6 @@ module Google
     # Example:
     #
     #     type: google.api.Service
-    #     config_version: 3
     #     name: calendar.googleapis.com
     #     title: Google Calendar API
     #     apis:
@@ -42,27 +41,24 @@ module Google
     #       - selector: "*"
     #         requirements:
     #           provider_id: google_calendar_auth
-    # @!attribute [rw] config_version
-    #   @return [::Google::Protobuf::UInt32Value]
-    #     The semantic version of the service configuration. The config version
-    #     affects the interpretation of the service configuration. For example,
-    #     certain features are enabled by default for certain config versions.
-    #     The latest config version is `3`.
     # @!attribute [rw] name
     #   @return [::String]
-    #     The DNS address at which this service is available,
-    #     e.g. `calendar.googleapis.com`.
-    # @!attribute [rw] id
-    #   @return [::String]
-    #     A unique ID for a specific instance of this message, typically assigned
-    #     by the client for tracking purpose. If empty, the server may choose to
-    #     generate one instead.
+    #     The service name, which is a DNS-like logical identifier for the
+    #     service, such as `calendar.googleapis.com`. The service name
+    #     typically goes through DNS verification to make sure the owner
+    #     of the service also owns the DNS name.
     # @!attribute [rw] title
     #   @return [::String]
     #     The product title for this service.
     # @!attribute [rw] producer_project_id
     #   @return [::String]
     #     The Google project that owns this service.
+    # @!attribute [rw] id
+    #   @return [::String]
+    #     A unique ID for a specific instance of this message, typically assigned
+    #     by the client for tracking purpose. Must be no longer than 63 characters
+    #     and only lower case letters, digits, '.', '_' and '-' are allowed. If
+    #     empty, the server may choose to generate one instead.
     # @!attribute [rw] apis
     #   @return [::Array<::Google::Protobuf::Api>]
     #     A list of API interfaces exported by this service. Only the `name` field
@@ -143,6 +139,12 @@ module Google
     # @!attribute [rw] source_info
     #   @return [::Google::Api::SourceInfo]
     #     Output only. The source information for this configuration if available.
+    # @!attribute [rw] config_version
+    #   @return [::Google::Protobuf::UInt32Value]
+    #     Obsolete. Do not use.
+    #
+    #     This field has no semantic meaning. The service config compiler always
+    #     sets this field to `3`.
     class Service
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/api/usage.rb

@@ -25,6 +25,12 @@ module Google
     #     Requirements that must be satisfied before a consumer project can use the
     #     service. Each requirement is of the form <service.name>/<requirement-id>;
     #     for example 'serviceusage.googleapis.com/billing-enabled'.
+    #
+    #     For Google APIs, a Terms of Service requirement must be included here.
+    #     Google Cloud APIs must include "serviceusage.googleapis.com/tos/cloud".
+    #     Other Google APIs should include
+    #     "serviceusage.googleapis.com/tos/universal". Additional ToS can be
+    #     included based on the business needs.
     # @!attribute [rw] rules
     #   @return [::Array<::Google::Api::UsageRule>]
     #     A list of usage rules that apply to individual API methods.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-service_management-v1
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.3
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-17 00:00:00.000000000 Z
+date: 2021-07-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -191,6 +191,7 @@ files:
 - proto_docs/google/api/endpoint.rb
 - proto_docs/google/api/field_behavior.rb
 - proto_docs/google/api/label.rb
+- proto_docs/google/api/launch_stage.rb
 - proto_docs/google/api/log.rb
 - proto_docs/google/api/logging.rb
 - proto_docs/google/api/metric.rb