google-api-client 0.43.0 → 0.48.0

data/generated/google/apis/servicemanagement_v1/classes.rb

@@ -22,13 +22,13 @@ module Google
   module Apis
     module ServicemanagementV1
       
-      # Generated advice about this change, used for providing more
-      # information about how a change will affect the existing service.
+      # Generated advice about this change, used for providing more information about
+      # how a change will affect the existing service.
       class Advice
         include Google::Apis::Core::Hashable
       
-        # Useful description for why this advice was applied and what actions should
-        # be taken to mitigate any implied risks.
+        # Useful description for why this advice was applied and what actions should be
+        # taken to mitigate any implied risks.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
@@ -43,14 +43,13 @@ module Google
         end
       end
       
-      # Api is a light-weight descriptor for an API Interface.
-      # Interfaces are also described as "protocol buffer services" in some contexts,
-      # such as by the "service" keyword in a .proto file, but they are different
-      # from API Services, which represent a concrete implementation of an interface
-      # as opposed to simply a description of methods and bindings. They are also
-      # sometimes simply referred to as "APIs" in other contexts, such as the name of
-      # this message itself. See https://cloud.google.com/apis/design/glossary for
-      # detailed terminology.
+      # Api is a light-weight descriptor for an API Interface. Interfaces are also
+      # described as "protocol buffer services" in some contexts, such as by the "
+      # service" keyword in a .proto file, but they are different from API Services,
+      # which represent a concrete implementation of an interface as opposed to simply
+      # a description of methods and bindings. They are also sometimes simply referred
+      # to as "APIs" in other contexts, such as the name of this message itself. See
+      # https://cloud.google.com/apis/design/glossary for detailed terminology.
       class Api
         include Google::Apis::Core::Hashable
       
@@ -64,8 +63,8 @@ module Google
         # @return [Array<Google::Apis::ServicemanagementV1::Mixin>]
         attr_accessor :mixins
       
-        # The fully qualified name of this interface, including package name
-        # followed by the interface's simple name.
+        # The fully qualified name of this interface, including package name followed by
+        # the interface's simple name.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -75,8 +74,8 @@ module Google
         # @return [Array<Google::Apis::ServicemanagementV1::Option>]
         attr_accessor :options
       
-        # `SourceContext` represents information about the source of a
-        # protobuf element, like the file in which it is defined.
+        # `SourceContext` represents information about the source of a protobuf element,
+        # like the file in which it is defined.
         # Corresponds to the JSON property `sourceContext`
         # @return [Google::Apis::ServicemanagementV1::SourceContext]
         attr_accessor :source_context
@@ -86,23 +85,19 @@ module Google
         # @return [String]
         attr_accessor :syntax
       
-        # A version string for this interface. If specified, must have the form
-        # `major-version.minor-version`, as in `1.10`. If the minor version is
-        # omitted, it defaults to zero. If the entire version field is empty, the
-        # major version is derived from the package name, as outlined below. If the
-        # field is not empty, the version in the package name will be verified to be
-        # consistent with what is provided here.
-        # The versioning schema uses [semantic
-        # versioning](http://semver.org) where the major version number
-        # indicates a breaking change and the minor version an additive,
-        # non-breaking change. Both version numbers are signals to users
-        # what to expect from different versions, and should be carefully
-        # chosen based on the product plan.
-        # The major version is also reflected in the package name of the
-        # interface, which must end in `v<major-version>`, as in
-        # `google.feature.v1`. For major versions 0 and 1, the suffix can
-        # be omitted. Zero major versions must only be used for
-        # experimental, non-GA interfaces.
+        # A version string for this interface. If specified, must have the form `major-
+        # version.minor-version`, as in `1.10`. If the minor version is omitted, it
+        # defaults to zero. If the entire version field is empty, the major version is
+        # derived from the package name, as outlined below. If the field is not empty,
+        # the version in the package name will be verified to be consistent with what is
+        # provided here. The versioning schema uses [semantic versioning](http://semver.
+        # org) where the major version number indicates a breaking change and the minor
+        # version an additive, non-breaking change. Both version numbers are signals to
+        # users what to expect from different versions, and should be carefully chosen
+        # based on the product plan. The major version is also reflected in the package
+        # name of the interface, which must end in `v`, as in `google.feature.v1`. For
+        # major versions 0 and 1, the suffix can be omitted. Zero major versions must
+        # only be used for experimental, non-GA interfaces.
         # Corresponds to the JSON property `version`
         # @return [String]
         attr_accessor :version
@@ -123,53 +118,21 @@ module Google
         end
       end
       
-      # Specifies the audit configuration for a service.
-      # The configuration determines which permission types are logged, and what
-      # identities, if any, are exempted from logging.
-      # An AuditConfig must have one or more AuditLogConfigs.
-      # If there are AuditConfigs for both `allServices` and a specific service,
-      # the union of the two AuditConfigs is used for that service: the log_types
-      # specified in each AuditConfig are enabled, and the exempted_members in each
-      # AuditLogConfig are exempted.
-      # Example Policy with multiple AuditConfigs:
-      # `
-      # "audit_configs": [
-      # `
-      # "service": "allServices",
-      # "audit_log_configs": [
-      # `
-      # "log_type": "DATA_READ",
-      # "exempted_members": [
-      # "user:jose@example.com"
-      # ]
-      # `,
-      # `
-      # "log_type": "DATA_WRITE"
-      # `,
-      # `
-      # "log_type": "ADMIN_READ"
-      # `
-      # ]
-      # `,
-      # `
-      # "service": "sampleservice.googleapis.com",
-      # "audit_log_configs": [
-      # `
-      # "log_type": "DATA_READ"
-      # `,
-      # `
-      # "log_type": "DATA_WRITE",
-      # "exempted_members": [
-      # "user:aliya@example.com"
-      # ]
-      # `
-      # ]
-      # `
-      # ]
-      # `
-      # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
-      # logging. It also exempts jose@example.com from DATA_READ logging, and
-      # aliya@example.com from DATA_WRITE logging.
+      # Specifies the audit configuration for a service. The configuration determines
+      # which permission types are logged, and what identities, if any, are exempted
+      # from logging. An AuditConfig must have one or more AuditLogConfigs. If there
+      # are AuditConfigs for both `allServices` and a specific service, the union of
+      # the two AuditConfigs is used for that service: the log_types specified in each
+      # AuditConfig are enabled, and the exempted_members in each AuditLogConfig are
+      # exempted. Example Policy with multiple AuditConfigs: ` "audit_configs": [ ` "
+      # service": "allServices", "audit_log_configs": [ ` "log_type": "DATA_READ", "
+      # exempted_members": [ "user:jose@example.com" ] `, ` "log_type": "DATA_WRITE" `,
+      # ` "log_type": "ADMIN_READ" ` ] `, ` "service": "sampleservice.googleapis.com",
+      # "audit_log_configs": [ ` "log_type": "DATA_READ" `, ` "log_type": "DATA_WRITE"
+      # , "exempted_members": [ "user:aliya@example.com" ] ` ] ` ] ` For sampleservice,
+      # this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also
+      # exempts jose@example.com from DATA_READ logging, and aliya@example.com from
+      # DATA_WRITE logging.
       class AuditConfig
         include Google::Apis::Core::Hashable
       
@@ -178,9 +141,9 @@ module Google
         # @return [Array<Google::Apis::ServicemanagementV1::AuditLogConfig>]
         attr_accessor :audit_log_configs
       
-        # Specifies a service that will be enabled for audit logging.
-        # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
-        # `allServices` is a special value that covers all services.
+        # Specifies a service that will be enabled for audit logging. For example, `
+        # storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special
+        # value that covers all services.
         # Corresponds to the JSON property `service`
         # @return [String]
         attr_accessor :service
@@ -196,28 +159,15 @@ module Google
         end
       end
       
-      # Provides the configuration for logging a type of permissions.
-      # Example:
-      # `
-      # "audit_log_configs": [
-      # `
-      # "log_type": "DATA_READ",
-      # "exempted_members": [
-      # "user:jose@example.com"
-      # ]
-      # `,
-      # `
-      # "log_type": "DATA_WRITE"
-      # `
-      # ]
-      # `
-      # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
-      # jose@example.com from DATA_READ logging.
+      # Provides the configuration for logging a type of permissions. Example: ` "
+      # audit_log_configs": [ ` "log_type": "DATA_READ", "exempted_members": [ "user:
+      # jose@example.com" ] `, ` "log_type": "DATA_WRITE" ` ] ` This enables '
+      # DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from
+      # DATA_READ logging.
       class AuditLogConfig
         include Google::Apis::Core::Hashable
       
-        # Specifies the identities that do not cause logging for this type of
-        # permission.
+        # Specifies the identities that do not cause logging for this type of permission.
         # Follows the same format of Binding.members.
         # Corresponds to the JSON property `exemptedMembers`
         # @return [Array<String>]
@@ -239,85 +189,63 @@ module Google
         end
       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).
+      # Configuration for an authentication provider, including support for [JSON Web
+      # Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
       class AuthProvider
         include Google::Apis::Core::Hashable
       
-        # 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, 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:
-        # -
+        # 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, 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:
-        # audiences: bookstore_android.apps.googleusercontent.com,
-        # bookstore_web.apps.googleusercontent.com
+        # LibraryService - https://library-example.googleapis.com/ Example: audiences:
+        # bookstore_android.apps.googleusercontent.com, bookstore_web.apps.
+        # googleusercontent.com
         # Corresponds to the JSON property `audiences`
         # @return [String]
         attr_accessor :audiences
       
-        # Redirect URL if JWT token is required but not present or is expired.
-        # Implement authorizationUrl of securityDefinitions in OpenAPI spec.
+        # Redirect URL if JWT token is required but not present or is expired. Implement
+        # authorizationUrl of securityDefinitions in OpenAPI spec.
         # Corresponds to the JSON property `authorizationUrl`
         # @return [String]
         attr_accessor :authorization_url
       
-        # The unique identifier of the auth provider. It will be referred to by
-        # `AuthRequirement.provider_id`.
-        # Example: "bookstore_auth".
+        # The unique identifier of the auth provider. It will be referred to by `
+        # AuthRequirement.provider_id`. Example: "bookstore_auth".
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Identifies the principal that issued the JWT. See
-        # https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32#section-4.1.1
-        # Usually a URL or an email address.
-        # Example: https://securetoken.google.com
-        # Example: 1234567-compute@developer.gserviceaccount.com
+        # Identifies the principal that issued the JWT. See https://tools.ietf.org/html/
+        # draft-ietf-oauth-json-web-token-32#section-4.1.1 Usually a URL or an email
+        # address. Example: https://securetoken.google.com Example: 1234567-compute@
+        # developer.gserviceaccount.com
         # Corresponds to the JSON property `issuer`
         # @return [String]
         attr_accessor :issuer
       
-        # 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).
-        # Optional if the key set document:
-        # - can be retrieved from
-        # [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).
-        # Example: https://www.googleapis.com/oauth2/v1/certs
+        # 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). Optional if the key set document: - can be retrieved from [
+        # 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). Example: https://www.googleapis.com/oauth2/v1/certs
         # Corresponds to the JSON property `jwksUri`
         # @return [String]
         attr_accessor :jwks_uri
       
-        # 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
+        # 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
         # Corresponds to the JSON property `jwtLocations`
         # @return [Array<Google::Apis::ServicemanagementV1::JwtLocation>]
         attr_accessor :jwt_locations
@@ -337,34 +265,26 @@ module Google
         end
       end
       
-      # User-defined authentication requirements, including support for
-      # [JSON Web Token
-      # (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
+      # User-defined authentication requirements, including support for [JSON Web
+      # Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).
       class AuthRequirement
         include Google::Apis::Core::Hashable
       
-        # NOTE: This will be deprecated soon, once AuthProvider.audiences is
-        # implemented and accepted in all the runtime components.
-        # 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://Service_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".
-        # Example:
-        # audiences: bookstore_android.apps.googleusercontent.com,
-        # bookstore_web.apps.googleusercontent.com
+        # NOTE: This will be deprecated soon, once AuthProvider.audiences is implemented
+        # and accepted in all the runtime components. 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://
+        # Service_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". Example: audiences: bookstore_android.apps.googleusercontent.
+        # com, bookstore_web.apps.googleusercontent.com
         # Corresponds to the JSON property `audiences`
         # @return [String]
         attr_accessor :audiences
       
-        # id from authentication provider.
-        # Example:
-        # provider_id: bookstore_auth
+        # id from authentication provider. Example: provider_id: bookstore_auth
         # Corresponds to the JSON property `providerId`
         # @return [String]
         attr_accessor :provider_id
@@ -380,18 +300,11 @@ module Google
         end
       end
       
-      # `Authentication` defines the authentication configuration for an API.
-      # Example for an API targeted for external use:
-      # name: calendar.googleapis.com
-      # authentication:
-      # providers:
-      # - id: google_calendar_auth
-      # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
-      # issuer: https://securetoken.google.com
-      # rules:
-      # - selector: "*"
-      # requirements:
-      # provider_id: google_calendar_auth
+      # `Authentication` defines the authentication configuration for an API. Example
+      # for an API targeted for external use: name: calendar.googleapis.com
+      # authentication: providers: - id: google_calendar_auth jwks_uri: https://www.
+      # googleapis.com/oauth2/v1/certs issuer: https://securetoken.google.com rules: -
+      # selector: "*" requirements: provider_id: google_calendar_auth
       class Authentication
         include Google::Apis::Core::Hashable
       
@@ -400,8 +313,8 @@ module Google
         # @return [Array<Google::Apis::ServicemanagementV1::AuthProvider>]
         attr_accessor :providers
       
-        # A list of authentication rules that apply to individual API methods.
-        # **NOTE:** All service configuration rules follow "last one wins" order.
+        # A list of authentication rules that apply to individual API methods. **NOTE:**
+        # All service configuration rules follow "last one wins" order.
         # Corresponds to the JSON property `rules`
         # @return [Array<Google::Apis::ServicemanagementV1::AuthenticationRule>]
         attr_accessor :rules
@@ -417,36 +330,34 @@ module Google
         end
       end
       
-      # Authentication rules for the service.
-      # By default, if a method has any authentication requirements, every request
-      # must include a valid credential matching one of the requirements.
-      # It's an error to include more than one kind of credential in a single
-      # request.
-      # If a method doesn't have any auth requirements, request credentials will be
-      # ignored.
+      # Authentication rules for the service. By default, if a method has any
+      # authentication requirements, every request must include a valid credential
+      # matching one of the requirements. It's an error to include more than one kind
+      # of credential in a single request. If a method doesn't have any auth
+      # requirements, request credentials will be ignored.
       class AuthenticationRule
         include Google::Apis::Core::Hashable
       
-        # If true, the service accepts API keys without any other credential.
+        # If true, the service accepts API keys without any other credential. This flag
+        # only applies to HTTP and gRPC requests.
         # Corresponds to the JSON property `allowWithoutCredential`
         # @return [Boolean]
         attr_accessor :allow_without_credential
         alias_method :allow_without_credential?, :allow_without_credential
       
         # OAuth scopes are a way to define data and permissions on data. For example,
-        # there are scopes defined for "Read-only access to Google Calendar" and
-        # "Access to Cloud Platform". Users can consent to a scope for an application,
-        # giving it permission to access that data on their behalf.
-        # OAuth scope specifications should be fairly coarse grained; a user will need
-        # to see and understand the text description of what your scope means.
-        # In most cases: use one or at most two OAuth scopes for an entire family of
-        # products. If your product has multiple APIs, you should probably be sharing
-        # the OAuth scope across all of those APIs.
-        # When you need finer grained OAuth consent screens: talk with your product
-        # management about how developers will use them in practice.
-        # Please note that even though each of the canonical scopes is enough for a
-        # request to be accepted and passed to the backend, a request can still fail
-        # due to the backend requiring additional scopes or permissions.
+        # there are scopes defined for "Read-only access to Google Calendar" and "Access
+        # to Cloud Platform". Users can consent to a scope for an application, giving it
+        # permission to access that data on their behalf. OAuth scope specifications
+        # should be fairly coarse grained; a user will need to see and understand the
+        # text description of what your scope means. In most cases: use one or at most
+        # two OAuth scopes for an entire family of products. If your product has
+        # multiple APIs, you should probably be sharing the OAuth scope across all of
+        # those APIs. When you need finer grained OAuth consent screens: talk with your
+        # product management about how developers will use them in practice. Please note
+        # that even though each of the canonical scopes is enough for a request to be
+        # accepted and passed to the backend, a request can still fail due to the
+        # backend requiring additional scopes or permissions.
         # Corresponds to the JSON property `oauth`
         # @return [Google::Apis::ServicemanagementV1::OAuthRequirements]
         attr_accessor :oauth
@@ -456,8 +367,8 @@ module Google
         # @return [Array<Google::Apis::ServicemanagementV1::AuthRequirement>]
         attr_accessor :requirements
       
-        # Selects the methods to which this rule applies.
-        # Refer to selector for syntax details.
+        # Selects the methods to which this rule applies. Refer to selector for syntax
+        # details.
         # Corresponds to the JSON property `selector`
         # @return [String]
         attr_accessor :selector
@@ -479,8 +390,8 @@ module Google
       class Backend
         include Google::Apis::Core::Hashable
       
-        # A list of API backend rules that apply to individual API methods.
-        # **NOTE:** All service configuration rules follow "last one wins" order.
+        # A list of API backend rules that apply to individual API methods. **NOTE:**
+        # All service configuration rules follow "last one wins" order.
         # Corresponds to the JSON property `rules`
         # @return [Array<Google::Apis::ServicemanagementV1::BackendRule>]
         attr_accessor :rules
@@ -499,21 +410,13 @@ module Google
       class BackendRule
         include Google::Apis::Core::Hashable
       
-        # 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 protocol
-        # to specify the protocol version.
+        # 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 protocol to specify the protocol version.
         # Corresponds to the JSON property `address`
         # @return [String]
         attr_accessor :address
@@ -524,18 +427,18 @@ module Google
         # @return [Float]
         attr_accessor :deadline
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `disableAuth`
         # @return [Boolean]
         attr_accessor :disable_auth
         alias_method :disable_auth?, :disable_auth
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `jwtAudience`
         # @return [String]
         attr_accessor :jwt_audience
@@ -546,8 +449,8 @@ module Google
         # @return [Float]
         attr_accessor :min_deadline
       
-        # The number of seconds to wait for the completion of a long running
-        # operation. The default is no deadline.
+        # The number of seconds to wait for the completion of a long running operation.
+        # The default is no deadline.
         # Corresponds to the JSON property `operationDeadline`
         # @return [Float]
         attr_accessor :operation_deadline
@@ -557,29 +460,21 @@ module Google
         # @return [String]
         attr_accessor :path_translation
       
-        # 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
-        # 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.
+        # 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
+        # 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.
         # Corresponds to the JSON property `protocol`
         # @return [String]
         attr_accessor :protocol
       
-        # Selects the methods to which this rule applies.
-        # Refer to selector for syntax details.
+        # Selects the methods to which this rule applies. Refer to selector for syntax
+        # details.
         # Corresponds to the JSON property `selector`
         # @return [String]
         attr_accessor :selector
@@ -602,42 +497,28 @@ module Google
         end
       end
       
-      # Billing related configuration of the service.
-      # The following example shows how to configure monitored resources and metrics
-      # 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/billing_branch
-      # labels:
-      # - 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/billing_branch
-      # metrics:
-      # - library.googleapis.com/book/borrowed_count
+      # Billing related configuration of the service. The following example shows how
+      # to configure monitored resources and metrics 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/
+      # billing_branch labels: - 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/billing_branch metrics: - library.
+      # googleapis.com/book/borrowed_count
       class Billing
         include Google::Apis::Core::Hashable
       
-        # Billing configurations for sending metrics to the consumer project.
-        # There can be multiple consumer destinations per service, each one must have
-        # a different monitored resource type. A metric can be used in at most
-        # one consumer destination.
+        # Billing configurations for sending metrics to the consumer project. There can
+        # be multiple consumer destinations per service, each one must have a different
+        # monitored resource type. A metric can be used in at most one consumer
+        # destination.
         # Corresponds to the JSON property `consumerDestinations`
         # @return [Array<Google::Apis::ServicemanagementV1::BillingDestination>]
         attr_accessor :consumer_destinations
@@ -652,19 +533,19 @@ module Google
         end
       end
       
-      # Configuration of a specific billing destination (Currently only support
-      # bill against consumer project).
+      # Configuration of a specific billing destination (Currently only support bill
+      # against consumer project).
       class BillingDestination
         include Google::Apis::Core::Hashable
       
-        # Names of the metrics to report to this billing destination.
-        # Each name must be defined in Service.metrics section.
+        # Names of the metrics to report to this billing destination. Each name must be
+        # defined in Service.metrics section.
         # Corresponds to the JSON property `metrics`
         # @return [Array<String>]
         attr_accessor :metrics
       
-        # The monitored resource type. The type must be defined in
-        # Service.monitored_resources section.
+        # The monitored resource type. The type must be defined in Service.
+        # monitored_resources section.
         # Corresponds to the JSON property `monitoredResource`
         # @return [String]
         attr_accessor :monitored_resource
@@ -684,69 +565,57 @@ module Google
       class Binding
         include Google::Apis::Core::Hashable
       
-        # Represents a textual expression in the Common Expression Language (CEL)
-        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
-        # are documented at https://github.com/google/cel-spec.
-        # Example (Comparison):
-        # title: "Summary size limit"
-        # description: "Determines if a summary is less than 100 chars"
-        # expression: "document.summary.size() < 100"
-        # Example (Equality):
-        # title: "Requestor is owner"
-        # description: "Determines if requestor is the document owner"
-        # expression: "document.owner == request.auth.claims.email"
-        # Example (Logic):
-        # title: "Public documents"
-        # description: "Determine whether the document should be publicly visible"
-        # expression: "document.type != 'private' && document.type != 'internal'"
-        # Example (Data Manipulation):
-        # title: "Notification string"
-        # description: "Create a notification string with a timestamp."
-        # expression: "'New message received at ' + string(document.create_time)"
-        # The exact variables and functions that may be referenced within an expression
-        # are determined by the service that evaluates it. See the service
-        # documentation for additional information.
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
+        # "Summary size limit" description: "Determines if a summary is less than 100
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
+        # Requestor is owner" description: "Determines if requestor is the document
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
+        # Logic): title: "Public documents" description: "Determine whether the document
+        # should be publicly visible" expression: "document.type != 'private' &&
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
+        # string" description: "Create a notification string with a timestamp."
+        # expression: "'New message received at ' + string(document.create_time)" The
+        # exact variables and functions that may be referenced within an expression are
+        # determined by the service that evaluates it. See the service documentation for
+        # additional information.
         # Corresponds to the JSON property `condition`
         # @return [Google::Apis::ServicemanagementV1::Expr]
         attr_accessor :condition
       
-        # Specifies the identities requesting access for a Cloud Platform resource.
-        # `members` can have the following values:
-        # * `allUsers`: A special identifier that represents anyone who is
-        # on the internet; with or without a Google account.
-        # * `allAuthenticatedUsers`: A special identifier that represents anyone
-        # who is authenticated with a Google account or a service account.
-        # * `user:`emailid``: An email address that represents a specific Google
-        # account. For example, `alice@example.com` .
-        # * `serviceAccount:`emailid``: An email address that represents a service
-        # account. For example, `my-other-app@appspot.gserviceaccount.com`.
-        # * `group:`emailid``: An email address that represents a Google group.
-        # For example, `admins@example.com`.
-        # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # identifier) representing a user that has been recently deleted. For
-        # example, `alice@example.com?uid=123456789012345678901`. If the user is
-        # recovered, this value reverts to `user:`emailid`` and the recovered user
-        # retains the role in the binding.
-        # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
-        # unique identifier) representing a service account that has been recently
-        # deleted. For example,
-        # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
-        # If the service account is undeleted, this value reverts to
-        # `serviceAccount:`emailid`` and the undeleted service account retains the
-        # role in the binding.
-        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # identifier) representing a Google group that has been recently
-        # deleted. For example, `admins@example.com?uid=123456789012345678901`. If
-        # the group is recovered, this value reverts to `group:`emailid`` and the
-        # recovered group retains the role in the binding.
-        # * `domain:`domain``: The G Suite domain (primary) that represents all the
-        # users of that domain. For example, `google.com` or `example.com`.
+        # Specifies the identities requesting access for a Cloud Platform resource. `
+        # members` can have the following values: * `allUsers`: A special identifier
+        # that represents anyone who is on the internet; with or without a Google
+        # account. * `allAuthenticatedUsers`: A special identifier that represents
+        # anyone who is authenticated with a Google account or a service account. * `
+        # user:`emailid``: An email address that represents a specific Google account.
+        # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email
+        # address that represents a service account. For example, `my-other-app@appspot.
+        # gserviceaccount.com`. * `group:`emailid``: An email address that represents a
+        # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid=
+        # `uniqueid``: An email address (plus unique identifier) representing a user
+        # that has been recently deleted. For example, `alice@example.com?uid=
+        # 123456789012345678901`. If the user is recovered, this value reverts to `user:`
+        # emailid`` and the recovered user retains the role in the binding. * `deleted:
+        # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # identifier) representing a service account that has been recently deleted. For
+        # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+        # If the service account is undeleted, this value reverts to `serviceAccount:`
+        # emailid`` and the undeleted service account retains the role in the binding. *
+        # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # identifier) representing a Google group that has been recently deleted. For
+        # example, `admins@example.com?uid=123456789012345678901`. If the group is
+        # recovered, this value reverts to `group:`emailid`` and the recovered group
+        # retains the role in the binding. * `domain:`domain``: The G Suite domain (
+        # primary) that represents all the users of that domain. For example, `google.
+        # com` or `example.com`.
         # Corresponds to the JSON property `members`
         # @return [Array<String>]
         attr_accessor :members
       
-        # Role that is assigned to `members`.
-        # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
+        # , or `roles/owner`.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -763,17 +632,16 @@ module Google
         end
       end
       
-      # Change report associated with a particular service configuration.
-      # It contains a list of ConfigChanges based on the comparison between
-      # two service configurations.
+      # Change report associated with a particular service configuration. It contains
+      # a list of ConfigChanges based on the comparison between two service
+      # configurations.
       class ChangeReport
         include Google::Apis::Core::Hashable
       
-        # List of changes between two service configurations.
-        # The changes will be alphabetically sorted based on the identifier
-        # of each change.
-        # A ConfigChange identifier is a dot separated path to the configuration.
-        # Example: visibility.rules[selector='LibraryService.CreateBook'].restriction
+        # List of changes between two service configurations. The changes will be
+        # alphabetically sorted based on the identifier of each change. A ConfigChange
+        # identifier is a dot separated path to the configuration. Example: visibility.
+        # rules[selector='LibraryService.CreateBook'].restriction
         # Corresponds to the JSON property `configChanges`
         # @return [Array<Google::Apis::ServicemanagementV1::ConfigChange>]
         attr_accessor :config_changes
@@ -789,9 +657,8 @@ module Google
       end
       
       # Output generated from semantically comparing two versions of a service
-      # configuration.
-      # Includes detailed information about a field that have changed with
-      # applicable advice about potential consequences for the change, such as
+      # configuration. Includes detailed information about a field that have changed
+      # with applicable advice about potential consequences for the change, such as
       # backwards-incompatibility.
       class ConfigChange
         include Google::Apis::Core::Hashable
@@ -807,27 +674,25 @@ module Google
         # @return [String]
         attr_accessor :change_type
       
-        # Object hierarchy path to the change, with levels separated by a '.'
-        # character. For repeated fields, an applicable unique identifier field is
-        # used for the index (usually selector, name, or id). For maps, the term
-        # 'key' is used. If the field has no unique identifier, the numeric index
-        # is used.
-        # Examples:
-        # - visibility.rules[selector=="google.LibraryService.ListBooks"].restriction
-        # - quota.metric_rules[selector=="google"].metric_costs[key=="reads"].value
-        # - logging.producer_destinations[0]
+        # Object hierarchy path to the change, with levels separated by a '.' character.
+        # For repeated fields, an applicable unique identifier field is used for the
+        # index (usually selector, name, or id). For maps, the term 'key' is used. If
+        # the field has no unique identifier, the numeric index is used. Examples: -
+        # visibility.rules[selector=="google.LibraryService.ListBooks"].restriction -
+        # quota.metric_rules[selector=="google"].metric_costs[key=="reads"].value -
+        # logging.producer_destinations[0]
         # Corresponds to the JSON property `element`
         # @return [String]
         attr_accessor :element
       
-        # Value of the changed object in the new Service configuration,
-        # in JSON format. This field will not be populated if ChangeType == REMOVED.
+        # Value of the changed object in the new Service configuration, in JSON format.
+        # This field will not be populated if ChangeType == REMOVED.
         # Corresponds to the JSON property `newValue`
         # @return [String]
         attr_accessor :new_value
       
-        # Value of the changed object in the old Service configuration,
-        # in JSON format. This field will not be populated if ChangeType == ADDED.
+        # Value of the changed object in the old Service configuration, in JSON format.
+        # This field will not be populated if ChangeType == ADDED.
         # Corresponds to the JSON property `oldValue`
         # @return [String]
         attr_accessor :old_value
@@ -882,8 +747,8 @@ module Google
       class ConfigRef
         include Google::Apis::Core::Hashable
       
-        # Resource name of a service config. It must have the following
-        # format: "services/`service name`/configs/`config id`".
+        # Resource name of a service config. It must have the following format: "
+        # services/`service name`/configs/`config id`".
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -909,9 +774,9 @@ module Google
         # @return [Array<Google::Apis::ServicemanagementV1::ConfigFile>]
         attr_accessor :files
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
@@ -927,39 +792,24 @@ module Google
         end
       end
       
-      # `Context` defines which contexts an API requests.
-      # Example:
-      # context:
-      # rules:
-      # - selector: "*"
-      # requested:
-      # - google.rpc.context.ProjectContext
-      # - google.rpc.context.OriginContext
-      # The above specifies that all methods in the API request
-      # `google.rpc.context.ProjectContext` and
-      # `google.rpc.context.OriginContext`.
-      # Available context types are defined in package
-      # `google.rpc.context`.
-      # This also provides mechanism to whitelist 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.
+      # `Context` defines which contexts an API requests. Example: context: rules: -
+      # selector: "*" requested: - google.rpc.context.ProjectContext - google.rpc.
+      # context.OriginContext The above specifies that all methods in the API request `
+      # google.rpc.context.ProjectContext` and `google.rpc.context.OriginContext`.
+      # 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--bin” and “x-goog-ext--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.
       class Context
         include Google::Apis::Core::Hashable
       
-        # A list of RPC context rules that apply to individual API methods.
-        # **NOTE:** All service configuration rules follow "last one wins" order.
+        # A list of RPC context rules that apply to individual API methods. **NOTE:**
+        # All service configuration rules follow "last one wins" order.
         # Corresponds to the JSON property `rules`
         # @return [Array<Google::Apis::ServicemanagementV1::ContextRule>]
         attr_accessor :rules
@@ -979,14 +829,14 @@ module Google
       class ContextRule
         include Google::Apis::Core::Hashable
       
-        # A list of full type names or extension IDs of extensions allowed in grpc
-        # side channel from client to backend.
+        # A list of full type names or extension IDs of extensions allowed in grpc side
+        # channel from client to backend.
         # Corresponds to the JSON property `allowedRequestExtensions`
         # @return [Array<String>]
         attr_accessor :allowed_request_extensions
       
-        # A list of full type names or extension IDs of extensions allowed in grpc
-        # side channel from backend to client.
+        # A list of full type names or extension IDs of extensions allowed in grpc side
+        # channel from backend to client.
         # Corresponds to the JSON property `allowedResponseExtensions`
         # @return [Array<String>]
         attr_accessor :allowed_response_extensions
@@ -1001,8 +851,8 @@ module Google
         # @return [Array<String>]
         attr_accessor :requested
       
-        # Selects the methods to which this rule applies.
-        # Refer to selector for syntax details.
+        # Selects the methods to which this rule applies. Refer to selector for syntax
+        # details.
         # Corresponds to the JSON property `selector`
         # @return [String]
         attr_accessor :selector
@@ -1021,14 +871,14 @@ module Google
         end
       end
       
-      # Selects and configures the service controller used by the service.  The
-      # service controller handles features like abuse, quota, billing, logging,
-      # monitoring, etc.
+      # Selects and configures the service controller used by the service. The service
+      # controller handles features like abuse, quota, billing, logging, monitoring,
+      # etc.
       class Control
         include Google::Apis::Core::Hashable
       
-        # The service control environment to use. If empty, no control plane
-        # feature (like quota and billing) will be enabled.
+        # The service control environment to use. If empty, no control plane feature (
+        # like quota and billing) will be enabled.
         # Corresponds to the JSON property `environment`
         # @return [String]
         attr_accessor :environment
@@ -1043,19 +893,15 @@ module Google
         end
       end
       
-      # Customize service error responses.  For example, list any service
-      # specific protobuf types that can appear in error detail lists of
-      # error responses.
-      # Example:
-      # custom_error:
-      # types:
-      # - google.foo.v1.CustomError
-      # - google.foo.v1.AnotherError
+      # Customize service error responses. For example, list any service specific
+      # protobuf types that can appear in error detail lists of error responses.
+      # Example: custom_error: types: - google.foo.v1.CustomError - google.foo.v1.
+      # AnotherError
       class CustomError
         include Google::Apis::Core::Hashable
       
-        # The list of custom error rules that apply to individual API messages.
-        # **NOTE:** All service configuration rules follow "last one wins" order.
+        # The list of custom error rules that apply to individual API messages. **NOTE:**
+        # All service configuration rules follow "last one wins" order.
         # Corresponds to the JSON property `rules`
         # @return [Array<Google::Apis::ServicemanagementV1::CustomErrorRule>]
         attr_accessor :rules
@@ -1080,15 +926,15 @@ module Google
       class CustomErrorRule
         include Google::Apis::Core::Hashable
       
-        # Mark this message as possible payload in error response.  Otherwise,
-        # objects of this type will be filtered when they appear in error payload.
+        # Mark this message as possible payload in error response. Otherwise, objects of
+        # this type will be filtered when they appear in error payload.
         # Corresponds to the JSON property `isErrorType`
         # @return [Boolean]
         attr_accessor :is_error_type
         alias_method :is_error_type?, :is_error_type
       
-        # Selects messages to which this rule applies.
-        # Refer to selector for syntax details.
+        # Selects messages to which this rule applies. Refer to selector for syntax
+        # details.
         # Corresponds to the JSON property `selector`
         # @return [String]
         attr_accessor :selector
@@ -1129,8 +975,8 @@ module Google
         end
       end
       
-      # Strategy used to delete a service. This strategy is a placeholder only
-      # used by the system generated rollout to delete a service.
+      # Strategy used to delete a service. This strategy is a placeholder only used by
+      # the system generated rollout to delete a service.
       class DeleteServiceStrategy
         include Google::Apis::Core::Hashable
       
@@ -1174,31 +1020,6 @@ module Google
         end
       end
       
-      # Request message for DisableService method.
-      class DisableServiceRequest
-        include Google::Apis::Core::Hashable
-      
-        # Required. The identity of consumer resource which service disablement will be
-        # applied to.
-        # The Google Service Management implementation accepts the following
-        # forms:
-        # - "project:<project_id>"
-        # Note: this is made compatible with
-        # google.api.servicecontrol.v1.Operation.consumer_id.
-        # Corresponds to the JSON property `consumerId`
-        # @return [String]
-        attr_accessor :consumer_id
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @consumer_id = args[:consumer_id] if args.key?(:consumer_id)
-        end
-      end
-      
       # Operation payload for DisableService method.
       class DisableServiceResponse
         include Google::Apis::Core::Hashable
@@ -1212,56 +1033,32 @@ module Google
         end
       end
       
-      # `Documentation` provides the information for describing a service.
-      # Example:
-      # <pre><code>documentation:
-      # summary: >
-      # The Google Calendar API gives access
-      # to most calendar features.
-      # pages:
-      # - name: Overview
-      # content: &#40;== include google/foo/overview.md ==&#41;
-      # - name: Tutorial
-      # content: &#40;== include google/foo/tutorial.md ==&#41;
-      # subpages;
-      # - name: Java
-      # content: &#40;== include google/foo/tutorial_java.md ==&#41;
-      # rules:
-      # - selector: google.calendar.Calendar.Get
-      # description: >
-      # ...
-      # - selector: google.calendar.Calendar.Put
-      # description: >
-      # ...
-      # </code></pre>
-      # Documentation is provided in markdown syntax. In addition to
-      # standard markdown features, definition lists, tables and fenced
-      # code blocks are supported. Section headers can be provided and are
-      # interpreted relative to the section nesting of the context where
-      # a documentation fragment is embedded.
-      # Documentation from the IDL is merged with documentation defined
-      # via the config at normalization time, where documentation provided
-      # by config rules overrides IDL provided.
-      # A number of constructs specific to the API platform are supported
-      # in documentation text.
-      # In order to reference a proto element, the following
-      # notation can be used:
-      # <pre><code>&#91;fully.qualified.proto.name]&#91;]</code></pre>
-      # To override the display text used for the link, this can be used:
-      # <pre><code>&#91;display text]&#91;fully.qualified.proto.name]</code></pre>
-      # Text can be excluded from doc using the following notation:
-      # <pre><code>&#40;-- internal comment --&#41;</code></pre>
-      # A few directives are available in documentation. Note that
-      # directives must appear on a single line to be properly
-      # identified. The `include` directive includes a markdown file from
-      # an external source:
-      # <pre><code>&#40;== include path/to/file ==&#41;</code></pre>
-      # The `resource_for` directive marks a message to be the resource of
-      # a collection in REST view. If it is not specified, tools attempt
-      # to infer the resource from the operations in a collection:
-      # <pre><code>&#40;== resource_for v1.shelves.books ==&#41;</code></pre>
-      # The directive `suppress_warning` does not directly affect documentation
-      # and is documented together with service config validation.
+      # `Documentation` provides the information for describing a service. Example:
+      # documentation: summary: > The Google Calendar API gives access to most
+      # calendar features. pages: - name: Overview content: (== include google/foo/
+      # overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==
+      # ) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==)
+      # rules: - selector: google.calendar.Calendar.Get description: > ... - selector:
+      # google.calendar.Calendar.Put description: > ... Documentation is provided in
+      # markdown syntax. In addition to standard markdown features, definition lists,
+      # tables and fenced code blocks are supported. Section headers can be provided
+      # and are interpreted relative to the section nesting of the context where a
+      # documentation fragment is embedded. Documentation from the IDL is merged with
+      # documentation defined via the config at normalization time, where
+      # documentation provided by config rules overrides IDL provided. A number of
+      # constructs specific to the API platform are supported in documentation text.
+      # In order to reference a proto element, the following notation can be used: [
+      # fully.qualified.proto.name][] To override the display text used for the link,
+      # this can be used: [display text][fully.qualified.proto.name] Text can be
+      # excluded from doc using the following notation: (-- internal comment --) A few
+      # directives are available in documentation. Note that directives must appear on
+      # a single line to be properly identified. The `include` directive includes a
+      # markdown file from an external source: (== include path/to/file ==) The `
+      # resource_for` directive marks a message to be the resource of a collection in
+      # REST view. If it is not specified, tools attempt to infer the resource from
+      # the operations in a collection: (== resource_for v1.shelves.books ==) The
+      # directive `suppress_warning` does not directly affect documentation and is
+      # documented together with service config validation.
       class Documentation
         include Google::Apis::Core::Hashable
       
@@ -1270,19 +1067,11 @@ module Google
         # @return [String]
         attr_accessor :documentation_root_url
       
-        # Declares a single overview page. For example:
-        # <pre><code>documentation:
-        # summary: ...
-        # overview: &#40;== include overview.md ==&#41;
-        # </code></pre>
-        # This is a shortcut for the following declaration (using pages style):
-        # <pre><code>documentation:
-        # summary: ...
-        # pages:
-        # - name: Overview
-        # content: &#40;== include overview.md ==&#41;
-        # </code></pre>
-        # Note: you cannot specify both `overview` field and `pages` field.
+        # Declares a single overview page. For example: documentation: summary: ...
+        # overview: (== include overview.md ==) This is a shortcut for the following
+        # declaration (using pages style): documentation: summary: ... pages: - name:
+        # Overview content: (== include overview.md ==) Note: you cannot specify both `
+        # overview` field and `pages` field.
         # Corresponds to the JSON property `overview`
         # @return [String]
         attr_accessor :overview
@@ -1292,22 +1081,20 @@ module Google
         # @return [Array<Google::Apis::ServicemanagementV1::Page>]
         attr_accessor :pages
       
-        # A list of documentation rules that apply to individual API elements.
-        # **NOTE:** All service configuration rules follow "last one wins" order.
+        # A list of documentation rules that apply to individual API elements. **NOTE:**
+        # All service configuration rules follow "last one wins" order.
         # Corresponds to the JSON property `rules`
         # @return [Array<Google::Apis::ServicemanagementV1::DocumentationRule>]
         attr_accessor :rules
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `serviceRootUrl`
         # @return [String]
         attr_accessor :service_root_url
       
-        # A short summary of what the service does. Can only be provided by
-        # plain text.
+        # A short summary of what the service does. Can only be provided by plain text.
         # Corresponds to the JSON property `summary`
         # @return [String]
         attr_accessor :summary
@@ -1331,8 +1118,8 @@ module Google
       class DocumentationRule
         include Google::Apis::Core::Hashable
       
-        # 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`.
         # Corresponds to the JSON property `deprecationDescription`
         # @return [String]
         attr_accessor :deprecation_description
@@ -1369,12 +1156,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The identity of consumer resource which service enablement will be
-        # applied to.
-        # The Google Service Management implementation accepts the following
-        # forms:
-        # - "project:<project_id>"
-        # Note: this is made compatible with
-        # google.api.servicecontrol.v1.Operation.consumer_id.
+        # applied to. The Google Service Management implementation accepts the following
+        # forms: - "project:" Note: this is made compatible with google.api.
+        # servicecontrol.v1.Operation.consumer_id.
         # Corresponds to the JSON property `consumerId`
         # @return [String]
         attr_accessor :consumer_id
@@ -1402,35 +1186,28 @@ module Google
         end
       end
       
-      # `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.
-      # Example service configuration:
-      # name: library-example.googleapis.com
-      # endpoints:
-      # # Below entry makes 'google.example.library.v1.Library'
-      # # API be served from endpoint address library-example.googleapis.com.
-      # # It also allows HTTP OPTIONS calls to be passed to the backend, for
-      # # it to decide whether the subsequent cross-origin request is
-      # # allowed to proceed.
-      # - name: library-example.googleapis.com
-      # allow_cors: true
+      # `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.
+      # Example service configuration: name: library-example.googleapis.com endpoints:
+      # # Below entry makes 'google.example.library.v1.Library' # API be served from
+      # endpoint address library-example.googleapis.com. # It also allows HTTP OPTIONS
+      # calls to be passed to the backend, for # it to decide whether the subsequent
+      # cross-origin request is # allowed to proceed. - name: library-example.
+      # googleapis.com allow_cors: true
       class Endpoint
         include Google::Apis::Core::Hashable
       
         # DEPRECATED: This field is no longer supported. Instead of using aliases,
-        # please specify multiple google.api.Endpoint for each of the intended
-        # aliases.
+        # please specify multiple google.api.Endpoint for each of the intended aliases.
         # Additional names that this endpoint will be hosted on.
         # Corresponds to the JSON property `aliases`
         # @return [Array<String>]
         attr_accessor :aliases
       
-        # Allowing
-        # [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
-        # cross-domain traffic, would allow the backends served from this endpoint to
-        # receive and respond to HTTP OPTIONS requests. The response will be used by
+        # Allowing [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing),
+        # aka cross-domain traffic, would allow the backends served from this endpoint
+        # to receive and respond to HTTP OPTIONS requests. The response will be used by
         # the browser to determine whether the subsequent cross-origin request is
         # allowed to proceed.
         # Corresponds to the JSON property `allowCors`
@@ -1444,10 +1221,9 @@ module Google
         attr_accessor :name
       
         # 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".
         # Corresponds to the JSON property `target`
         # @return [String]
         attr_accessor :target
@@ -1484,8 +1260,8 @@ module Google
         # @return [Array<Google::Apis::ServicemanagementV1::Option>]
         attr_accessor :options
       
-        # `SourceContext` represents information about the source of a
-        # protobuf element, like the file in which it is defined.
+        # `SourceContext` represents information about the source of a protobuf element,
+        # like the file in which it is defined.
         # Corresponds to the JSON property `sourceContext`
         # @return [Google::Apis::ServicemanagementV1::SourceContext]
         attr_accessor :source_context
@@ -1540,52 +1316,43 @@ module Google
         end
       end
       
-      # Represents a textual expression in the Common Expression Language (CEL)
-      # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
-      # are documented at https://github.com/google/cel-spec.
-      # Example (Comparison):
-      # title: "Summary size limit"
-      # description: "Determines if a summary is less than 100 chars"
-      # expression: "document.summary.size() < 100"
-      # Example (Equality):
-      # title: "Requestor is owner"
-      # description: "Determines if requestor is the document owner"
-      # expression: "document.owner == request.auth.claims.email"
-      # Example (Logic):
-      # title: "Public documents"
-      # description: "Determine whether the document should be publicly visible"
-      # expression: "document.type != 'private' && document.type != 'internal'"
-      # Example (Data Manipulation):
-      # title: "Notification string"
-      # description: "Create a notification string with a timestamp."
-      # expression: "'New message received at ' + string(document.create_time)"
-      # The exact variables and functions that may be referenced within an expression
-      # are determined by the service that evaluates it. See the service
-      # documentation for additional information.
+      # Represents a textual expression in the Common Expression Language (CEL) syntax.
+      # CEL is a C-like expression language. The syntax and semantics of CEL are
+      # documented at https://github.com/google/cel-spec. Example (Comparison): title:
+      # "Summary size limit" description: "Determines if a summary is less than 100
+      # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
+      # Requestor is owner" description: "Determines if requestor is the document
+      # owner" expression: "document.owner == request.auth.claims.email" Example (
+      # Logic): title: "Public documents" description: "Determine whether the document
+      # should be publicly visible" expression: "document.type != 'private' &&
+      # document.type != 'internal'" Example (Data Manipulation): title: "Notification
+      # string" description: "Create a notification string with a timestamp."
+      # expression: "'New message received at ' + string(document.create_time)" The
+      # exact variables and functions that may be referenced within an expression are
+      # determined by the service that evaluates it. See the service documentation for
+      # additional information.
       class Expr
         include Google::Apis::Core::Hashable
       
-        # Optional. Description of the expression. This is a longer text which
-        # describes the expression, e.g. when hovered over it in a UI.
+        # Optional. Description of the expression. This is a longer text which describes
+        # the expression, e.g. when hovered over it in a UI.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Textual representation of an expression in Common Expression Language
-        # syntax.
+        # Textual representation of an expression in Common Expression Language syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # Optional. String indicating the location of the expression for error
-        # reporting, e.g. a file name and a position in the file.
+        # Optional. String indicating the location of the expression for error reporting,
+        # e.g. a file name and a position in the file.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
       
-        # Optional. Title for the expression, i.e. a short string describing
-        # its purpose. This can be used e.g. in UIs which allow to enter the
-        # expression.
+        # Optional. Title for the expression, i.e. a short string describing its purpose.
+        # This can be used e.g. in UIs which allow to enter the expression.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -1637,8 +1404,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :number
       
-        # The index of the field type in `Type.oneofs`, for message or enumeration
-        # types. The first type has index 1; zero means the type is not in the list.
+        # The index of the field type in `Type.oneofs`, for message or enumeration types.
+        # The first type has index 1; zero means the type is not in the list.
         # Corresponds to the JSON property `oneofIndex`
         # @return [Fixnum]
         attr_accessor :oneof_index
@@ -1654,8 +1421,8 @@ module Google
         attr_accessor :packed
         alias_method :packed?, :packed
       
-        # The field type URL, without the scheme, for message or enumeration
-        # types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
+        # The field type URL, without the scheme, for message or enumeration types.
+        # Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
         # Corresponds to the JSON property `typeUrl`
         # @return [String]
         attr_accessor :type_url
@@ -1679,8 +1446,8 @@ module Google
         end
       end
       
-      # Encapsulation of flow-specific error details for debugging.
-      # Used as a details field on an error Status, not intended for external use.
+      # Encapsulation of flow-specific error details for debugging. Used as a details
+      # field on an error Status, not intended for external use.
       class FlowErrorDetails
         include Google::Apis::Core::Hashable
       
@@ -1709,20 +1476,18 @@ module Google
       class GenerateConfigReportRequest
         include Google::Apis::Core::Hashable
       
-        # Required. Service configuration for which we want to generate the report.
-        # For this version of API, the supported types are
-        # google.api.servicemanagement.v1.ConfigRef,
-        # google.api.servicemanagement.v1.ConfigSource,
-        # and google.api.Service
+        # Required. Service configuration for which we want to generate the report. For
+        # this version of API, the supported types are google.api.servicemanagement.v1.
+        # ConfigRef, google.api.servicemanagement.v1.ConfigSource, and google.api.
+        # Service
         # Corresponds to the JSON property `newConfig`
         # @return [Hash<String,Object>]
         attr_accessor :new_config
       
-        # Optional. Service configuration against which the comparison will be done.
-        # For this version of API, the supported types are
-        # google.api.servicemanagement.v1.ConfigRef,
-        # google.api.servicemanagement.v1.ConfigSource,
-        # and google.api.Service
+        # Optional. Service configuration against which the comparison will be done. For
+        # this version of API, the supported types are google.api.servicemanagement.v1.
+        # ConfigRef, google.api.servicemanagement.v1.ConfigSource, and google.api.
+        # Service
         # Corresponds to the JSON property `oldConfig`
         # @return [Hash<String,Object>]
         attr_accessor :old_config
@@ -1742,14 +1507,13 @@ module Google
       class GenerateConfigReportResponse
         include Google::Apis::Core::Hashable
       
-        # list of ChangeReport, each corresponding to comparison between two
-        # service configurations.
+        # list of ChangeReport, each corresponding to comparison between two service
+        # configurations.
         # Corresponds to the JSON property `changeReports`
         # @return [Array<Google::Apis::ServicemanagementV1::ChangeReport>]
         attr_accessor :change_reports
       
-        # Errors / Linter warnings associated with the service definition this
-        # report
+        # Errors / Linter warnings associated with the service definition this report
         # belongs to.
         # Corresponds to the JSON property `diagnostics`
         # @return [Array<Google::Apis::ServicemanagementV1::Diagnostic>]
@@ -1801,15 +1565,13 @@ module Google
       class GetPolicyOptions
         include Google::Apis::Core::Hashable
       
-        # Optional. The policy format version to be returned.
-        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
-        # rejected.
-        # Requests for policies with any conditional bindings must specify version 3.
-        # Policies without any conditional bindings may specify any valid value or
-        # leave the field unset.
-        # To learn which resources support conditions in their IAM policies, see the
-        # [IAM
-        # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        # Optional. The policy format version to be returned. Valid values are 0, 1, and
+        # 3. Requests specifying an invalid value will be rejected. Requests for
+        # policies with any conditional bindings must specify version 3. Policies
+        # without any conditional bindings may specify any valid value or leave the
+        # field unset. To learn which resources support conditions in their IAM policies,
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
+        # resource-policies).
         # Corresponds to the JSON property `requestedPolicyVersion`
         # @return [Fixnum]
         attr_accessor :requested_policy_version
@@ -1825,23 +1587,22 @@ module Google
       end
       
       # Defines the HTTP configuration for an API service. It contains a list of
-      # HttpRule, each specifying the mapping of an RPC method
-      # to one or more HTTP REST API methods.
+      # HttpRule, each specifying the mapping of an RPC method to one or more HTTP
+      # REST API methods.
       class Http
         include Google::Apis::Core::Hashable
       
         # When set to true, URL path parameters will be fully URI-decoded except in
         # cases of single segment matches in reserved expansion, where "%2F" will be
-        # left encoded.
-        # The default behavior is to not decode RFC 6570 reserved characters in multi
-        # segment matches.
+        # left encoded. The default behavior is to not decode RFC 6570 reserved
+        # characters in multi segment matches.
         # Corresponds to the JSON property `fullyDecodeReservedExpansion`
         # @return [Boolean]
         attr_accessor :fully_decode_reserved_expansion
         alias_method :fully_decode_reserved_expansion?, :fully_decode_reserved_expansion
       
-        # A list of HTTP configuration rules that apply to individual API methods.
-        # **NOTE:** All service configuration rules follow "last one wins" order.
+        # A list of HTTP configuration rules that apply to individual API methods. **
+        # NOTE:** All service configuration rules follow "last one wins" order.
         # Corresponds to the JSON property `rules`
         # @return [Array<Google::Apis::ServicemanagementV1::HttpRule>]
         attr_accessor :rules
@@ -1857,251 +1618,149 @@ module Google
         end
       end
       
-      # # gRPC Transcoding
-      # gRPC Transcoding is a feature for mapping between a gRPC method and one or
-      # more HTTP REST endpoints. It allows developers to build a single API service
-      # that supports both gRPC APIs and REST APIs. Many systems, including [Google
-      # APIs](https://github.com/googleapis/googleapis),
-      # [Cloud Endpoints](https://cloud.google.com/endpoints), [gRPC
-      # Gateway](https://github.com/grpc-ecosystem/grpc-gateway),
-      # and [Envoy](https://github.com/envoyproxy/envoy) proxy support this feature
-      # and use it for large scale production services.
-      # `HttpRule` defines the schema of the gRPC/REST mapping. The mapping specifies
-      # how different portions of the gRPC request message are mapped to the URL
-      # path, URL query parameters, and HTTP request body. It also controls how the
-      # gRPC response message is mapped to the HTTP response body. `HttpRule` is
+      # # gRPC Transcoding gRPC Transcoding is a feature for mapping between a gRPC
+      # method and one or more HTTP REST endpoints. It allows developers to build a
+      # single API service that supports both gRPC APIs and REST APIs. Many systems,
+      # including [Google APIs](https://github.com/googleapis/googleapis), [Cloud
+      # Endpoints](https://cloud.google.com/endpoints), [gRPC Gateway](https://github.
+      # com/grpc-ecosystem/grpc-gateway), and [Envoy](https://github.com/envoyproxy/
+      # envoy) proxy support this feature and use it for large scale production
+      # services. `HttpRule` defines the schema of the gRPC/REST mapping. The mapping
+      # specifies how different portions of the gRPC request message are mapped to the
+      # URL path, URL query parameters, and HTTP request body. It also controls how
+      # the gRPC response message is mapped to the HTTP response body. `HttpRule` is
       # typically specified as an `google.api.http` annotation on the gRPC method.
       # Each mapping specifies a URL path template and an HTTP method. The path
       # template may refer to one or more fields in the gRPC request message, as long
-      # as each field is a non-repeated field with a primitive (non-message) type.
-      # The path template controls how fields of the request message are mapped to
-      # the URL path.
-      # Example:
-      # service Messaging `
-      # rpc GetMessage(GetMessageRequest) returns (Message) `
-      # option (google.api.http) = `
-      # get: "/v1/`name=messages/*`"
-      # `;
-      # `
-      # `
-      # message GetMessageRequest `
-      # string name = 1; // Mapped to URL path.
-      # `
-      # message Message `
-      # string text = 1; // The resource content.
-      # `
-      # This enables an HTTP REST to gRPC mapping as below:
-      # HTTP | gRPC
-      # -----|-----
-      # `GET /v1/messages/123456`  | `GetMessage(name: "messages/123456")`
-      # Any fields in the request message which are not bound by the path template
-      # automatically become HTTP query parameters if there is no HTTP request body.
-      # For example:
-      # service Messaging `
-      # rpc GetMessage(GetMessageRequest) returns (Message) `
-      # option (google.api.http) = `
-      # get:"/v1/messages/`message_id`"
-      # `;
-      # `
-      # `
-      # message GetMessageRequest `
-      # message SubMessage `
-      # string subfield = 1;
-      # `
-      # string message_id = 1; // Mapped to URL path.
-      # int64 revision = 2;    // Mapped to URL query parameter `revision`.
-      # SubMessage sub = 3;    // Mapped to URL query parameter `sub.subfield`.
-      # `
-      # This enables a HTTP JSON to RPC mapping as below:
-      # HTTP | gRPC
-      # -----|-----
-      # `GET /v1/messages/123456?revision=2&sub.subfield=foo` |
-      # `GetMessage(message_id: "123456" revision: 2 sub: SubMessage(subfield:
-      # "foo"))`
-      # Note that fields which are mapped to URL query parameters must have a
-      # primitive type or a repeated primitive type or a non-repeated message type.
-      # In the case of a repeated type, the parameter can be repeated in the URL
-      # as `...?param=A&param=B`. In the case of a message type, each field of the
-      # message is mapped to a separate parameter, such as
-      # `...?foo.a=A&foo.b=B&foo.c=C`.
-      # For HTTP methods that allow a request body, the `body` field
-      # specifies the mapping. Consider a REST update method on the
-      # message resource collection:
-      # service Messaging `
-      # rpc UpdateMessage(UpdateMessageRequest) returns (Message) `
-      # option (google.api.http) = `
-      # patch: "/v1/messages/`message_id`"
-      # body: "message"
-      # `;
-      # `
-      # `
-      # message UpdateMessageRequest `
-      # string message_id = 1; // mapped to the URL
-      # Message message = 2;   // mapped to the body
-      # `
-      # The following HTTP JSON to RPC mapping is enabled, where the
-      # representation of the JSON in the request body is determined by
-      # protos JSON encoding:
-      # HTTP | gRPC
-      # -----|-----
-      # `PATCH /v1/messages/123456 ` "text": "Hi!" `` | `UpdateMessage(message_id:
-      # "123456" message ` text: "Hi!" `)`
-      # The special name `*` can be used in the body mapping to define that
-      # every field not bound by the path template should be mapped to the
-      # request body.  This enables the following alternative definition of
-      # the update method:
-      # service Messaging `
-      # rpc UpdateMessage(Message) returns (Message) `
-      # option (google.api.http) = `
-      # patch: "/v1/messages/`message_id`"
-      # body: "*"
-      # `;
-      # `
-      # `
-      # message Message `
-      # string message_id = 1;
-      # string text = 2;
-      # `
-      # The following HTTP JSON to RPC mapping is enabled:
-      # HTTP | gRPC
-      # -----|-----
-      # `PATCH /v1/messages/123456 ` "text": "Hi!" `` | `UpdateMessage(message_id:
-      # "123456" text: "Hi!")`
-      # Note that when using `*` in the body mapping, it is not possible to
-      # have HTTP parameters, as all fields not bound by the path end in
-      # the body. This makes this option more rarely used in practice when
-      # defining REST APIs. The common usage of `*` is in custom methods
-      # which don't use the URL at all for transferring data.
-      # It is possible to define multiple HTTP methods for one RPC by using
-      # the `additional_bindings` option. Example:
-      # service Messaging `
-      # rpc GetMessage(GetMessageRequest) returns (Message) `
-      # option (google.api.http) = `
-      # get: "/v1/messages/`message_id`"
-      # additional_bindings `
-      # get: "/v1/users/`user_id`/messages/`message_id`"
-      # `
-      # `;
-      # `
-      # `
-      # message GetMessageRequest `
-      # string message_id = 1;
-      # string user_id = 2;
-      # `
-      # This enables the following two alternative HTTP JSON to RPC mappings:
-      # HTTP | gRPC
-      # -----|-----
-      # `GET /v1/messages/123456` | `GetMessage(message_id: "123456")`
-      # `GET /v1/users/me/messages/123456` | `GetMessage(user_id: "me" message_id:
-      # "123456")`
-      # ## Rules for HTTP mapping
-      # 1. Leaf request fields (recursive expansion nested messages in the request
-      # message) are classified into three categories:
-      # - Fields referred by the path template. They are passed via the URL path.
-      # - Fields referred by the HttpRule.body. They are passed via the HTTP
-      # request body.
-      # - All other fields are passed via the URL query parameters, and the
-      # parameter name is the field path in the request message. A repeated
-      # field can be represented as multiple query parameters under the same
-      # name.
-      # 2. If HttpRule.body is "*", there is no URL query parameter, all fields
-      # are passed via URL path and HTTP request body.
-      # 3. If HttpRule.body is omitted, there is no HTTP request body, all
-      # fields are passed via URL path and URL query parameters.
-      # ### Path template syntax
-      # Template = "/" Segments [ Verb ] ;
-      # Segments = Segment ` "/" Segment ` ;
-      # Segment  = "*" | "**" | LITERAL | Variable ;
-      # Variable = "`" FieldPath [ "=" Segments ] "`" ;
-      # FieldPath = IDENT ` "." IDENT ` ;
-      # Verb     = ":" LITERAL ;
-      # The syntax `*` matches a single URL path segment. The syntax `**` matches
-      # zero or more URL path segments, which must be the last part of the URL path
-      # except the `Verb`.
-      # The syntax `Variable` matches part of the URL path as specified by its
-      # template. A variable template must not contain other variables. If a variable
-      # matches a single path segment, its template may be omitted, e.g. ``var``
-      # is equivalent to ``var=*``.
-      # The syntax `LITERAL` matches literal text in the URL path. If the `LITERAL`
-      # contains any reserved character, such characters should be percent-encoded
-      # before the matching.
-      # If a variable contains exactly one path segment, such as `"`var`"` or
-      # `"`var=*`"`, when such a variable is expanded into a URL path on the client
-      # side, all characters except `[-_.~0-9a-zA-Z]` are percent-encoded. The
-      # server side does the reverse decoding. Such variables show up in the
-      # [Discovery
-      # Document](https://developers.google.com/discovery/v1/reference/apis) as
-      # ``var``.
-      # If a variable contains multiple path segments, such as `"`var=foo/*`"`
-      # or `"`var=**`"`, when such a variable is expanded into a URL path on the
-      # client side, all characters except `[-_.~/0-9a-zA-Z]` are percent-encoded.
-      # The server side does the reverse decoding, except "%2F" and "%2f" are left
-      # unchanged. Such variables show up in the
-      # [Discovery
-      # Document](https://developers.google.com/discovery/v1/reference/apis) as
-      # ``+var``.
-      # ## Using gRPC API Service Configuration
-      # gRPC API Service Configuration (service config) is a configuration language
-      # for configuring a gRPC service to become a user-facing product. The
-      # service config is simply the YAML representation of the `google.api.Service`
-      # proto message.
+      # as each field is a non-repeated field with a primitive (non-message) type. The
+      # path template controls how fields of the request message are mapped to the URL
+      # path. Example: service Messaging ` rpc GetMessage(GetMessageRequest) returns (
+      # Message) ` option (google.api.http) = ` get: "/v1/`name=messages/*`" `; ` `
+      # message GetMessageRequest ` string name = 1; // Mapped to URL path. ` message
+      # Message ` string text = 1; // The resource content. ` This enables an HTTP
+      # REST to gRPC mapping as below: HTTP | gRPC -----|----- `GET /v1/messages/
+      # 123456` | `GetMessage(name: "messages/123456")` Any fields in the request
+      # message which are not bound by the path template automatically become HTTP
+      # query parameters if there is no HTTP request body. For example: service
+      # Messaging ` rpc GetMessage(GetMessageRequest) returns (Message) ` option (
+      # google.api.http) = ` get:"/v1/messages/`message_id`" `; ` ` message
+      # GetMessageRequest ` message SubMessage ` string subfield = 1; ` string
+      # message_id = 1; // Mapped to URL path. int64 revision = 2; // Mapped to URL
+      # query parameter `revision`. SubMessage sub = 3; // Mapped to URL query
+      # parameter `sub.subfield`. ` This enables a HTTP JSON to RPC mapping as below:
+      # HTTP | gRPC -----|----- `GET /v1/messages/123456?revision=2&sub.subfield=foo` |
+      # `GetMessage(message_id: "123456" revision: 2 sub: SubMessage(subfield: "foo"))
+      # ` Note that fields which are mapped to URL query parameters must have a
+      # primitive type or a repeated primitive type or a non-repeated message type. In
+      # the case of a repeated type, the parameter can be repeated in the URL as `...?
+      # param=A&param=B`. In the case of a message type, each field of the message is
+      # mapped to a separate parameter, such as `...?foo.a=A&foo.b=B&foo.c=C`. For
+      # HTTP methods that allow a request body, the `body` field specifies the mapping.
+      # Consider a REST update method on the message resource collection: service
+      # Messaging ` rpc UpdateMessage(UpdateMessageRequest) returns (Message) ` option
+      # (google.api.http) = ` patch: "/v1/messages/`message_id`" body: "message" `; ` `
+      # message UpdateMessageRequest ` string message_id = 1; // mapped to the URL
+      # Message message = 2; // mapped to the body ` The following HTTP JSON to RPC
+      # mapping is enabled, where the representation of the JSON in the request body
+      # is determined by protos JSON encoding: HTTP | gRPC -----|----- `PATCH /v1/
+      # messages/123456 ` "text": "Hi!" `` | `UpdateMessage(message_id: "123456"
+      # message ` text: "Hi!" `)` The special name `*` can be used in the body mapping
+      # to define that every field not bound by the path template should be mapped to
+      # the request body. This enables the following alternative definition of the
+      # update method: service Messaging ` rpc UpdateMessage(Message) returns (Message)
+      # ` option (google.api.http) = ` patch: "/v1/messages/`message_id`" body: "*" `;
+      # ` ` message Message ` string message_id = 1; string text = 2; ` The following
+      # HTTP JSON to RPC mapping is enabled: HTTP | gRPC -----|----- `PATCH /v1/
+      # messages/123456 ` "text": "Hi!" `` | `UpdateMessage(message_id: "123456" text:
+      # "Hi!")` Note that when using `*` in the body mapping, it is not possible to
+      # have HTTP parameters, as all fields not bound by the path end in the body.
+      # This makes this option more rarely used in practice when defining REST APIs.
+      # The common usage of `*` is in custom methods which don't use the URL at all
+      # for transferring data. It is possible to define multiple HTTP methods for one
+      # RPC by using the `additional_bindings` option. Example: service Messaging `
+      # rpc GetMessage(GetMessageRequest) returns (Message) ` option (google.api.http)
+      # = ` get: "/v1/messages/`message_id`" additional_bindings ` get: "/v1/users/`
+      # user_id`/messages/`message_id`" ` `; ` ` message GetMessageRequest ` string
+      # message_id = 1; string user_id = 2; ` This enables the following two
+      # alternative HTTP JSON to RPC mappings: HTTP | gRPC -----|----- `GET /v1/
+      # messages/123456` | `GetMessage(message_id: "123456")` `GET /v1/users/me/
+      # messages/123456` | `GetMessage(user_id: "me" message_id: "123456")` ## Rules
+      # for HTTP mapping 1. Leaf request fields (recursive expansion nested messages
+      # in the request message) are classified into three categories: - Fields
+      # referred by the path template. They are passed via the URL path. - Fields
+      # referred by the HttpRule.body. They are passed via the HTTP request body. -
+      # All other fields are passed via the URL query parameters, and the parameter
+      # name is the field path in the request message. A repeated field can be
+      # represented as multiple query parameters under the same name. 2. If HttpRule.
+      # body is "*", there is no URL query parameter, all fields are passed via URL
+      # path and HTTP request body. 3. If HttpRule.body is omitted, there is no HTTP
+      # request body, all fields are passed via URL path and URL query parameters. ###
+      # Path template syntax Template = "/" Segments [ Verb ] ; Segments = Segment ` "/
+      # " Segment ` ; Segment = "*" | "**" | LITERAL | Variable ; Variable = "`"
+      # FieldPath [ "=" Segments ] "`" ; FieldPath = IDENT ` "." IDENT ` ; Verb = ":"
+      # LITERAL ; The syntax `*` matches a single URL path segment. The syntax `**`
+      # matches zero or more URL path segments, which must be the last part of the URL
+      # path except the `Verb`. The syntax `Variable` matches part of the URL path as
+      # specified by its template. A variable template must not contain other
+      # variables. If a variable matches a single path segment, its template may be
+      # omitted, e.g. ``var`` is equivalent to ``var=*``. The syntax `LITERAL` matches
+      # literal text in the URL path. If the `LITERAL` contains any reserved character,
+      # such characters should be percent-encoded before the matching. If a variable
+      # contains exactly one path segment, such as `"`var`"` or `"`var=*`"`, when such
+      # a variable is expanded into a URL path on the client side, all characters
+      # except `[-_.~0-9a-zA-Z]` are percent-encoded. The server side does the reverse
+      # decoding. Such variables show up in the [Discovery Document](https://
+      # developers.google.com/discovery/v1/reference/apis) as ``var``. If a variable
+      # contains multiple path segments, such as `"`var=foo/*`"` or `"`var=**`"`, when
+      # such a variable is expanded into a URL path on the client side, all characters
+      # except `[-_.~/0-9a-zA-Z]` are percent-encoded. The server side does the
+      # reverse decoding, except "%2F" and "%2f" are left unchanged. Such variables
+      # show up in the [Discovery Document](https://developers.google.com/discovery/v1/
+      # reference/apis) as ``+var``. ## Using gRPC API Service Configuration gRPC API
+      # Service Configuration (service config) is a configuration language for
+      # configuring a gRPC service to become a user-facing product. The service config
+      # is simply the YAML representation of the `google.api.Service` proto message.
       # As an alternative to annotating your proto file, you can configure gRPC
-      # transcoding in your service config YAML files. You do this by specifying a
-      # `HttpRule` that maps the gRPC method to a REST endpoint, achieving the same
-      # effect as the proto annotation. This can be particularly useful if you
-      # have a proto that is reused in multiple services. Note that any transcoding
-      # specified in the service config will override any matching transcoding
-      # configuration in the proto.
-      # Example:
-      # http:
-      # rules:
-      # # Selects a gRPC method and applies HttpRule to it.
-      # - selector: example.v1.Messaging.GetMessage
-      # get: /v1/messages/`message_id`/`sub.subfield`
-      # ## Special notes
-      # When gRPC Transcoding is used to map a gRPC to JSON REST endpoints, the
-      # proto to JSON conversion must follow the [proto3
-      # specification](https://developers.google.com/protocol-buffers/docs/proto3#json)
-      # .
-      # While the single segment variable follows the semantics of
-      # [RFC 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String
-      # Expansion, the multi segment variable **does not** follow RFC 6570 Section
-      # 3.2.3 Reserved Expansion. The reason is that the Reserved Expansion
-      # does not expand special characters like `?` and `#`, which would lead
-      # to invalid URLs. As the result, gRPC Transcoding uses a custom encoding
-      # for multi segment variables.
-      # The path variables **must not** refer to any repeated or mapped field,
-      # because client libraries are not capable of handling such variable expansion.
-      # The path variables **must not** capture the leading "/" character. The reason
-      # is that the most common use case "`var`" does not capture the leading "/"
-      # character. For consistency, all path variables must share the same behavior.
-      # Repeated message fields must not be mapped to URL query parameters, because
-      # no client library can support such complicated mapping.
-      # If an API needs to use a JSON array for request or response body, it can map
-      # the request or response body to a repeated field. However, some gRPC
-      # Transcoding implementations may not support this feature.
+      # transcoding in your service config YAML files. You do this by specifying a `
+      # HttpRule` that maps the gRPC method to a REST endpoint, achieving the same
+      # effect as the proto annotation. This can be particularly useful if you have a
+      # proto that is reused in multiple services. Note that any transcoding specified
+      # in the service config will override any matching transcoding configuration in
+      # the proto. Example: http: rules: # Selects a gRPC method and applies HttpRule
+      # to it. - selector: example.v1.Messaging.GetMessage get: /v1/messages/`
+      # message_id`/`sub.subfield` ## Special notes When gRPC Transcoding is used to
+      # map a gRPC to JSON REST endpoints, the proto to JSON conversion must follow
+      # the [proto3 specification](https://developers.google.com/protocol-buffers/docs/
+      # proto3#json). While the single segment variable follows the semantics of [RFC
+      # 6570](https://tools.ietf.org/html/rfc6570) Section 3.2.2 Simple String
+      # Expansion, the multi segment variable **does not** follow RFC 6570 Section 3.2.
+      # 3 Reserved Expansion. The reason is that the Reserved Expansion does not
+      # expand special characters like `?` and `#`, which would lead to invalid URLs.
+      # As the result, gRPC Transcoding uses a custom encoding for multi segment
+      # variables. The path variables **must not** refer to any repeated or mapped
+      # field, because client libraries are not capable of handling such variable
+      # expansion. The path variables **must not** capture the leading "/" character.
+      # The reason is that the most common use case "`var`" does not capture the
+      # leading "/" character. For consistency, all path variables must share the same
+      # behavior. Repeated message fields must not be mapped to URL query parameters,
+      # because no client library can support such complicated mapping. If an API
+      # needs to use a JSON array for request or response body, it can map the request
+      # or response body to a repeated field. However, some gRPC Transcoding
+      # implementations may not support this feature.
       class HttpRule
         include Google::Apis::Core::Hashable
       
-        # Additional HTTP bindings for the selector. Nested bindings must
-        # not contain an `additional_bindings` field themselves (that is,
-        # the nesting may only be one level deep).
+        # Additional HTTP bindings for the selector. Nested bindings must not contain an
+        # `additional_bindings` field themselves (that is, the nesting may only be one
+        # level deep).
         # Corresponds to the JSON property `additionalBindings`
         # @return [Array<Google::Apis::ServicemanagementV1::HttpRule>]
         attr_accessor :additional_bindings
       
-        # When this flag is set to true, HTTP requests will be allowed to invoke a
-        # half-duplex streaming method.
-        # Corresponds to the JSON property `allowHalfDuplex`
-        # @return [Boolean]
-        attr_accessor :allow_half_duplex
-        alias_method :allow_half_duplex?, :allow_half_duplex
-      
-        # The name of the request field whose value is mapped to the HTTP request
-        # body, or `*` for mapping all request fields not captured by the path
-        # pattern to the HTTP body, or omitted for not having any HTTP request body.
-        # NOTE: the referred field must be present at the top-level of the request
-        # message type.
+        # The name of the request field whose value is mapped to the HTTP request body,
+        # or `*` for mapping all request fields not captured by the path pattern to the
+        # HTTP body, or omitted for not having any HTTP request body. NOTE: the referred
+        # field must be present at the top-level of the request message type.
         # Corresponds to the JSON property `body`
         # @return [String]
         attr_accessor :body
@@ -2116,8 +1775,7 @@ module Google
         # @return [String]
         attr_accessor :delete
       
-        # Maps to HTTP GET. Used for listing and getting information about
-        # resources.
+        # Maps to HTTP GET. Used for listing and getting information about resources.
         # Corresponds to the JSON property `get`
         # @return [String]
         attr_accessor :get
@@ -2138,16 +1796,15 @@ module Google
         attr_accessor :put
       
         # Optional. The name of the response field whose value is mapped to the HTTP
-        # response body. When omitted, the entire response message will be used
-        # as the HTTP response body.
-        # NOTE: The referred field must be present at the top-level of the response
-        # message type.
+        # response body. When omitted, the entire response message will be used as the
+        # HTTP response body. NOTE: The referred field must be present at the top-level
+        # of the response message type.
         # Corresponds to the JSON property `responseBody`
         # @return [String]
         attr_accessor :response_body
       
-        # Selects a method to which this rule applies.
-        # Refer to selector for syntax details.
+        # Selects a method to which this rule applies. Refer to selector for syntax
+        # details.
         # Corresponds to the JSON property `selector`
         # @return [String]
         attr_accessor :selector
@@ -2159,7 +1816,6 @@ module Google
         # Update properties of this object
         def update!(**args)
           @additional_bindings = args[:additional_bindings] if args.key?(:additional_bindings)
-          @allow_half_duplex = args[:allow_half_duplex] if args.key?(:allow_half_duplex)
           @body = args[:body] if args.key?(:body)
           @custom = args[:custom] if args.key?(:custom)
           @delete = args[:delete] if args.key?(:delete)
@@ -2186,13 +1842,12 @@ module Google
         # @return [String]
         attr_accessor :query
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `valuePrefix`
         # @return [String]
         attr_accessor :value_prefix
@@ -2340,39 +1995,35 @@ module Google
         end
       end
       
-      # A description of a log type. Example in YAML format:
-      # - name: library.googleapis.com/activity_history
-      # description: The history of borrowing and returning library items.
-      # display_name: Activity
-      # labels:
-      # - key: /customer_id
+      # A description of a log type. Example in YAML format: - name: library.
+      # googleapis.com/activity_history description: The history of borrowing and
+      # returning library items. display_name: Activity labels: - key: /customer_id
       # description: Identifier of a library customer
       class LogDescriptor
         include Google::Apis::Core::Hashable
       
-        # A human-readable description of this log. This information appears in
-        # the documentation and can contain details.
+        # A human-readable description of this log. This information appears in the
+        # documentation and can contain details.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # The human-readable name for this log. This information appears on
-        # the user interface and should be concise.
+        # The human-readable name for this log. This information appears on the user
+        # interface and should be concise.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # The set of labels that are available to describe a specific log entry.
-        # Runtime requests that contain labels not specified here are
-        # considered invalid.
+        # The set of labels that are available to describe a specific log entry. Runtime
+        # requests that contain labels not specified here are considered invalid.
         # Corresponds to the JSON property `labels`
         # @return [Array<Google::Apis::ServicemanagementV1::LabelDescriptor>]
         attr_accessor :labels
       
-        # The name of the log. It must be less than 512 characters long and can
-        # include the following characters: upper- and lower-case alphanumeric
-        # characters [A-Za-z0-9], and punctuation characters including
-        # slash, underscore, hyphen, period [/_-.].
+        # The name of the log. It must be less than 512 characters long and can include
+        # the following characters: upper- and lower-case alphanumeric characters [A-Za-
+        # z0-9], and punctuation characters including slash, underscore, hyphen, period [
+        # /_-.].
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -2390,48 +2041,30 @@ module Google
         end
       end
       
-      # Logging configuration of the service.
-      # The following example shows how to configure logs to be sent to the
-      # producer and consumer projects. In the example, the `activity_history`
-      # log is sent to both the producer and consumer projects, whereas the
-      # `purchase_history` log is only sent to the producer project.
-      # monitored_resources:
-      # - type: library.googleapis.com/branch
-      # labels:
-      # - key: /city
-      # description: The city where the library branch is located in.
-      # - key: /name
-      # description: The name of the branch.
-      # logs:
-      # - name: activity_history
-      # labels:
-      # - key: /customer_id
-      # - name: purchase_history
-      # logging:
-      # producer_destinations:
-      # - monitored_resource: library.googleapis.com/branch
-      # logs:
-      # - activity_history
-      # - purchase_history
-      # consumer_destinations:
-      # - monitored_resource: library.googleapis.com/branch
-      # logs:
-      # - activity_history
+      # Logging configuration of the service. The following example shows how to
+      # configure logs to be sent to the producer and consumer projects. In the
+      # example, the `activity_history` log is sent to both the producer and consumer
+      # projects, whereas the `purchase_history` log is only sent to the producer
+      # project. monitored_resources: - type: library.googleapis.com/branch labels: -
+      # key: /city description: The city where the library branch is located in. - key:
+      # /name description: The name of the branch. logs: - name: activity_history
+      # labels: - key: /customer_id - name: purchase_history logging:
+      # producer_destinations: - monitored_resource: library.googleapis.com/branch
+      # logs: - activity_history - purchase_history consumer_destinations: -
+      # monitored_resource: library.googleapis.com/branch logs: - activity_history
       class Logging
         include Google::Apis::Core::Hashable
       
-        # Logging configurations for sending logs to the consumer project.
-        # There can be multiple consumer destinations, each one must have a
-        # different monitored resource type. A log can be used in at most
-        # one consumer destination.
+        # Logging configurations for sending logs to the consumer project. There can be
+        # multiple consumer destinations, each one must have a different monitored
+        # resource type. A log can be used in at most one consumer destination.
         # Corresponds to the JSON property `consumerDestinations`
         # @return [Array<Google::Apis::ServicemanagementV1::LoggingDestination>]
         attr_accessor :consumer_destinations
       
-        # Logging configurations for sending logs to the producer project.
-        # There can be multiple producer destinations, each one must have a
-        # different monitored resource type. A log can be used in at most
-        # one producer destination.
+        # Logging configurations for sending logs to the producer project. There can be
+        # multiple producer destinations, each one must have a different monitored
+        # resource type. A log can be used in at most one producer destination.
         # Corresponds to the JSON property `producerDestinations`
         # @return [Array<Google::Apis::ServicemanagementV1::LoggingDestination>]
         attr_accessor :producer_destinations
@@ -2447,21 +2080,20 @@ module Google
         end
       end
       
-      # Configuration of a specific logging destination (the producer project
-      # or the consumer project).
+      # Configuration of a specific logging destination (the producer project or the
+      # consumer project).
       class LoggingDestination
         include Google::Apis::Core::Hashable
       
-        # Names of the logs to be sent to this destination. Each name must
-        # be defined in the Service.logs section. If the log name is
-        # not a domain scoped name, it will be automatically prefixed with
-        # the service name followed by "/".
+        # Names of the logs to be sent to this destination. Each name must be defined in
+        # the Service.logs section. If the log name is not a domain scoped name, it will
+        # be automatically prefixed with the service name followed by "/".
         # Corresponds to the JSON property `logs`
         # @return [Array<String>]
         attr_accessor :logs
       
-        # The monitored resource type. The type must be defined in the
-        # Service.monitored_resources section.
+        # The monitored resource type. The type must be defined in the Service.
+        # monitored_resources section.
         # Corresponds to the JSON property `monitoredResource`
         # @return [String]
         attr_accessor :monitored_resource
@@ -2477,8 +2109,8 @@ module Google
         end
       end
       
-      # The full representation of a Service that is managed by
-      # Google Service Management.
+      # The full representation of a Service that is managed by Google Service
+      # Management.
       class ManagedService
         include Google::Apis::Core::Hashable
       
@@ -2487,8 +2119,8 @@ module Google
         # @return [String]
         attr_accessor :producer_project_id
       
-        # The name of the service. See the [overview](/service-management/overview)
-        # for naming requirements.
+        # The name of the service. See the [overview](/service-management/overview) for
+        # naming requirements.
         # Corresponds to the JSON property `serviceName`
         # @return [String]
         attr_accessor :service_name
@@ -2564,15 +2196,6 @@ module Google
       # Defines a metric type and its schema. Once a metric descriptor is created,
       # deleting or altering it stops data collection and makes the metric type's
       # existing data unusable.
-      # The following are specific rules for service defined Monitoring metric
-      # descriptors:
-      # * `type`, `metric_kind`, `value_type` and `description`
-      # fields are all required. The `unit` field must be specified
-      # if the `value_type` is any of DOUBLE, INT64, DISTRIBUTION.
-      # * Maximum of default 500 metric descriptors per service is allowed.
-      # * Maximum of default 10 labels per metric descriptor is allowed.
-      # The default maximum limit can be overridden. Please follow
-      # https://cloud.google.com/monitoring/quotas
       class MetricDescriptor
         include Google::Apis::Core::Hashable
       
@@ -2581,25 +2204,18 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # A concise name for the metric, which can be displayed in user interfaces.
-        # 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.
+        # A concise name for the metric, which can be displayed in user interfaces. 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.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # The set of labels that can be used to describe a specific
-        # instance of this metric type.
-        # The label key name must follow:
-        # * Only upper and lower-case letters, digits and underscores (_) are
-        # allowed.
-        # * Label name must start with a letter or digit.
-        # * The maximum length of a label name is 100 characters.
-        # For example, the
-        # `appengine.googleapis.com/http/server/response_latencies` metric
-        # type has a label for the HTTP response code, `response_code`, so
-        # you can look at latencies for successful responses or just
+        # The set of labels that can be used to describe a specific instance of this
+        # metric type. For example, the `appengine.googleapis.com/http/server/
+        # response_latencies` metric type has a label for the HTTP response code, `
+        # response_code`, so you can look at latencies for successful responses or just
         # for responses that failed.
         # Corresponds to the JSON property `labels`
         # @return [Array<Google::Apis::ServicemanagementV1::LabelDescriptor>]
@@ -2615,17 +2231,16 @@ module Google
         # @return [Google::Apis::ServicemanagementV1::MetricDescriptorMetadata]
         attr_accessor :metadata
       
-        # Whether the metric records instantaneous values, changes to a value, etc.
-        # Some combinations of `metric_kind` and `value_type` might not be supported.
+        # Whether the metric records instantaneous values, changes to a value, etc. Some
+        # combinations of `metric_kind` and `value_type` might not be supported.
         # Corresponds to the JSON property `metricKind`
         # @return [String]
         attr_accessor :metric_kind
       
-        # Read-only. If present, then a time
-        # series, which is identified partially by
-        # a metric type and a MonitoredResourceDescriptor, that is associated
-        # with this metric type can only be associated with one of the monitored
-        # resource types listed here.
+        # Read-only. If present, then a time series, which is identified partially by a
+        # metric type and a MonitoredResourceDescriptor, that is associated with this
+        # metric type can only be associated with one of the monitored resource types
+        # listed here.
         # Corresponds to the JSON property `monitoredResourceTypes`
         # @return [Array<String>]
         attr_accessor :monitored_resource_types
@@ -2635,116 +2250,68 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The metric type, including its DNS name prefix. The type is not
-        # URL-encoded.
-        # All service defined metrics must be prefixed with the service name, in the
-        # format of ``service name`/`relative metric name``, such as
-        # `cloudsql.googleapis.com/database/cpu/utilization`. The relative metric
-        # name must follow:
-        # * Only upper and lower-case letters, digits, '/' and underscores '_' are
-        # allowed.
-        # * The maximum number of characters allowed for the relative_metric_name is
-        # 100.
-        # All user-defined metric types have the DNS name
-        # `custom.googleapis.com`, `external.googleapis.com`, or
-        # `logging.googleapis.com/user/`.
-        # 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"
+        # The metric type, including its DNS name prefix. The type is not 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"
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # 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 may 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 may 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](http://unitsofmeasure.org/ucum.html) standard:
-        # **Basic units (UNIT)**
-        # * `bit`   bit
-        # * `By`    byte
-        # * `s`     second
-        # * `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)
-        # * `Pi`    pebi    (2^50)
-        # **Grammar**
-        # The grammar also includes these connectors:
-        # * `/`    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:
-        # Expression = Component ` "." Component ` ` "/" Component ` ;
-        # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
-        # | Annotation
-        # | "1"
-        # ;
-        # Annotation = "`" NAME "`" ;
-        # Notes:
-        # * `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 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").
+        # 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 may 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 may 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](http://unitsofmeasure.org/
+        # ucum.html) standard: **Basic units (UNIT)** * `bit` bit * `By` byte * `s`
+        # second * `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) * `Pi` pebi (2^50) **Grammar** The grammar also includes these
+        # connectors: * `/` 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: Expression = Component ` "." Component ` ` "/" Component `
+        # ; Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] | Annotation | "1" ;
+        # Annotation = "`" NAME "`" ; Notes: * `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 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").
         # Corresponds to the JSON property `unit`
         # @return [String]
         attr_accessor :unit
       
-        # Whether the measurement is an integer, a floating-point number, etc.
-        # Some combinations of `metric_kind` and `value_type` might not be supported.
+        # Whether the measurement is an integer, a floating-point number, etc. Some
+        # combinations of `metric_kind` and `value_type` might not be supported.
         # Corresponds to the JSON property `valueType`
         # @return [String]
         attr_accessor :value_type
@@ -2773,9 +2340,9 @@ module Google
       class MetricDescriptorMetadata
         include Google::Apis::Core::Hashable
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `ingestDelay`
         # @return [String]
         attr_accessor :ingest_delay
@@ -2787,8 +2354,8 @@ module Google
       
         # 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.
+        # excluding data loss due to errors. Metrics with a higher granularity have a
+        # smaller sampling period.
         # Corresponds to the JSON property `samplePeriod`
         # @return [String]
         attr_accessor :sample_period
@@ -2805,22 +2372,21 @@ module Google
         end
       end
       
-      # Bind API methods to metrics. Binding a method to a metric causes that
-      # metric's configured quota behaviors to apply to the method call.
+      # Bind API methods to metrics. Binding a method to a metric causes that metric's
+      # configured quota behaviors to apply to the method call.
       class MetricRule
         include Google::Apis::Core::Hashable
       
         # Metrics to update when the selected methods are called, and the associated
-        # cost applied to each metric.
-        # The key of the map is the metric name, and the values are the amount
-        # increased for the metric against which the quota limits are defined.
-        # The value must not be negative.
+        # cost applied to each metric. The key of the map is the metric name, and the
+        # values are the amount increased for the metric against which the quota limits
+        # are defined. The value must not be negative.
         # Corresponds to the JSON property `metricCosts`
         # @return [Hash<String,Fixnum>]
         attr_accessor :metric_costs
       
-        # Selects the methods to which this rule applies.
-        # Refer to selector for syntax details.
+        # Selects the methods to which this rule applies. Refer to selector for syntax
+        # details.
         # Corresponds to the JSON property `selector`
         # @return [String]
         attr_accessor :selector
@@ -2838,66 +2404,33 @@ module Google
       
       # Declares an API Interface to be included in this interface. The including
       # interface must redeclare all the methods from the included interface, but
-      # documentation and options are inherited as follows:
-      # - If after comment and whitespace stripping, the documentation
-      # string of the redeclared method is empty, it will be inherited
-      # from the original method.
-      # - Each annotation belonging to the service config (http,
-      # visibility) which is not set in the redeclared method will be
-      # inherited.
-      # - If an http annotation is inherited, the path pattern will be
-      # modified as follows. Any version prefix will be replaced by the
-      # version of the including interface plus the root path if
-      # specified.
-      # Example of a simple mixin:
-      # package google.acl.v1;
-      # service AccessControl `
-      # // Get the underlying ACL object.
-      # rpc GetAcl(GetAclRequest) returns (Acl) `
-      # option (google.api.http).get = "/v1/`resource=**`:getAcl";
-      # `
-      # `
-      # package google.storage.v2;
-      # service Storage `
-      # //       rpc GetAcl(GetAclRequest) returns (Acl);
-      # // Get a data record.
-      # rpc GetData(GetDataRequest) returns (Data) `
-      # option (google.api.http).get = "/v2/`resource=**`";
-      # `
-      # `
-      # Example of a mixin configuration:
-      # apis:
-      # - name: google.storage.v2.Storage
-      # mixins:
-      # - name: google.acl.v1.AccessControl
-      # The mixin construct implies that all methods in `AccessControl` are
-      # also declared with same name and request/response types in
-      # `Storage`. A documentation generator or annotation processor will
-      # see the effective `Storage.GetAcl` method after inherting
-      # documentation and annotations as follows:
-      # service Storage `
-      # // Get the underlying ACL object.
-      # rpc GetAcl(GetAclRequest) returns (Acl) `
-      # option (google.api.http).get = "/v2/`resource=**`:getAcl";
-      # `
-      # ...
-      # `
-      # Note how the version in the path pattern changed from `v1` to `v2`.
-      # If the `root` field in the mixin is specified, it should be a
-      # relative path under which inherited HTTP paths are placed. Example:
-      # apis:
-      # - name: google.storage.v2.Storage
-      # mixins:
-      # - name: google.acl.v1.AccessControl
-      # root: acls
-      # This implies the following inherited HTTP annotation:
-      # service Storage `
-      # // Get the underlying ACL object.
-      # rpc GetAcl(GetAclRequest) returns (Acl) `
-      # option (google.api.http).get = "/v2/acls/`resource=**`:getAcl";
-      # `
-      # ...
-      # `
+      # documentation and options are inherited as follows: - If after comment and
+      # whitespace stripping, the documentation string of the redeclared method is
+      # empty, it will be inherited from the original method. - Each annotation
+      # belonging to the service config (http, visibility) which is not set in the
+      # redeclared method will be inherited. - If an http annotation is inherited, the
+      # path pattern will be modified as follows. Any version prefix will be replaced
+      # by the version of the including interface plus the root path if specified.
+      # Example of a simple mixin: package google.acl.v1; service AccessControl ` //
+      # Get the underlying ACL object. rpc GetAcl(GetAclRequest) returns (Acl) `
+      # option (google.api.http).get = "/v1/`resource=**`:getAcl"; ` ` package google.
+      # storage.v2; service Storage ` // rpc GetAcl(GetAclRequest) returns (Acl); //
+      # Get a data record. rpc GetData(GetDataRequest) returns (Data) ` option (google.
+      # api.http).get = "/v2/`resource=**`"; ` ` Example of a mixin configuration:
+      # apis: - name: google.storage.v2.Storage mixins: - name: google.acl.v1.
+      # AccessControl The mixin construct implies that all methods in `AccessControl`
+      # are also declared with same name and request/response types in `Storage`. A
+      # documentation generator or annotation processor will see the effective `
+      # Storage.GetAcl` method after inheriting documentation and annotations as
+      # follows: service Storage ` // Get the underlying ACL object. rpc GetAcl(
+      # GetAclRequest) returns (Acl) ` option (google.api.http).get = "/v2/`resource=**
+      # `:getAcl"; ` ... ` Note how the version in the path pattern changed from `v1`
+      # to `v2`. If the `root` field in the mixin is specified, it should be a
+      # relative path under which inherited HTTP paths are placed. Example: apis: -
+      # name: google.storage.v2.Storage mixins: - name: google.acl.v1.AccessControl
+      # root: acls This implies the following inherited HTTP annotation: service
+      # Storage ` // Get the underlying ACL object. rpc GetAcl(GetAclRequest) returns (
+      # Acl) ` option (google.api.http).get = "/v2/acls/`resource=**`:getAcl"; ` ... `
       class Mixin
         include Google::Apis::Core::Hashable
       
@@ -2906,8 +2439,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # If non-empty specifies a path under which inherited HTTP paths
-        # are rooted.
+        # If non-empty specifies a path under which inherited HTTP paths are rooted.
         # Corresponds to the JSON property `root`
         # @return [String]
         attr_accessor :root
@@ -2923,51 +2455,32 @@ module Google
         end
       end
       
-      # An object that describes the schema of a MonitoredResource object using a
-      # type name and a set of labels.  For example, the monitored resource
-      # descriptor for Google Compute Engine VM instances has a type of
-      # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
-      # `"zone"` to identify particular VM instances.
-      # Different services can support different monitored resource types.
-      # The following are specific rules to service defined monitored resources for
-      # Monitoring and Logging:
-      # * The `type`, `display_name`, `description`, `labels` and `launch_stage`
-      # fields are all required.
-      # * The first label of the monitored resource descriptor must be
-      # `resource_container`. There are legacy monitored resource descritptors
-      # start with `project_id`.
-      # * It must include a `location` label.
-      # * Maximum of default 5 service defined monitored resource descriptors
-      # is allowed per service.
-      # * Maximum of default 10 labels per monitored resource is allowed.
-      # The default maximum limit can be overridden. Please follow
-      # https://cloud.google.com/monitoring/quotas
+      # An object that describes the schema of a MonitoredResource object using a type
+      # name and a set of labels. For example, the monitored resource descriptor for
+      # Google Compute Engine VM instances has a type of `"gce_instance"` and
+      # specifies the use of the labels `"instance_id"` and `"zone"` to identify
+      # particular VM instances. Different APIs can support different monitored
+      # resource types. APIs generally provide a `list` method that returns the
+      # monitored resource descriptors used by the API.
       class MonitoredResourceDescriptor
         include Google::Apis::Core::Hashable
       
-        # Optional. A detailed description of the monitored resource type that might
-        # be used in documentation.
+        # Optional. A detailed description of the monitored resource type that might be
+        # used in documentation.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
         # Optional. A concise name for the monitored resource type that might be
-        # displayed in user interfaces. It should be a Title Cased Noun Phrase,
-        # without any article or other determiners. For example,
-        # `"Google Cloud SQL Database"`.
+        # displayed in user interfaces. It should be a Title Cased Noun Phrase, without
+        # any article or other determiners. For example, `"Google Cloud SQL Database"`.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
         # Required. A set of labels used to describe instances of this monitored
-        # resource type.
-        # The label key name must follow:
-        # * Only upper and lower-case letters, digits and underscores (_) are
-        # allowed.
-        # * Label name must start with a letter or digit.
-        # * The maximum length of a label name is 100 characters.
-        # For example, an individual Google Cloud SQL database is
-        # identified by values for the labels `database_id` and `location`.
+        # resource type. For example, an individual Google Cloud SQL database is
+        # identified by values for the labels `"database_id"` and `"zone"`.
         # Corresponds to the JSON property `labels`
         # @return [Array<Google::Apis::ServicemanagementV1::LabelDescriptor>]
         attr_accessor :labels
@@ -2977,27 +2490,18 @@ module Google
         # @return [String]
         attr_accessor :launch_stage
       
-        # Optional. The resource name of the monitored resource descriptor:
-        # `"projects/`project_id`/monitoredResourceDescriptors/`type`"` where
-        # `type` is the value of the `type` field in this object and
-        # `project_id` is a project ID that provides API-specific context for
-        # accessing the type.  APIs that do not use project information can use the
-        # resource name format `"monitoredResourceDescriptors/`type`"`.
+        # Optional. The resource name of the monitored resource descriptor: `"projects/`
+        # project_id`/monitoredResourceDescriptors/`type`"` where `type` is the value of
+        # the `type` field in this object and `project_id` is a project ID that provides
+        # API-specific context for accessing the type. APIs that do not use project
+        # information can use the resource name format `"monitoredResourceDescriptors/`
+        # type`"`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Required. The monitored resource type. For example, the type
-        # `cloudsql_database` represents databases in Google Cloud SQL.
-        # All service defined monitored resource types must be prefixed with the
-        # service name, in the format of ``service name`/`relative resource name``.
-        # The relative resource name must follow:
-        # * Only upper and lower-case letters and digits are allowed.
-        # * It must start with upper case character and is recommended to use Upper
-        # Camel Case style.
-        # * The maximum number of characters allowed for the relative_resource_name
-        # is 100.
-        # Note there are legacy service monitored resources not following this rule.
+        # Required. The monitored resource type. For example, the type `"
+        # cloudsql_database"` represents databases in Google Cloud SQL.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -3017,75 +2521,47 @@ module Google
         end
       end
       
-      # Monitoring configuration of the service.
-      # The example below shows how to configure monitored resources and metrics
-      # 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/num_overdue` metric is only sent to the
-      # consumer project.
-      # monitored_resources:
-      # - type: library.googleapis.com/Branch
-      # display_name: "Library Branch"
-      # description: "A branch of a library."
-      # launch_stage: GA
-      # labels:
-      # - 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
-      # 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
-      # description: "The id of the customer."
-      # monitoring:
-      # producer_destinations:
-      # - monitored_resource: library.googleapis.com/Branch
-      # metrics:
-      # - library.googleapis.com/book/returned_count
-      # consumer_destinations:
-      # - monitored_resource: library.googleapis.com/Branch
-      # metrics:
-      # - library.googleapis.com/book/returned_count
-      # - library.googleapis.com/book/num_overdue
+      # Monitoring configuration of the service. The example below shows how to
+      # configure monitored resources and metrics 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/num_overdue` metric is only sent to
+      # the consumer project. monitored_resources: - type: library.googleapis.com/
+      # Branch display_name: "Library Branch" description: "A branch of a library."
+      # launch_stage: GA labels: - 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 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
+      # description: "The id of the customer." monitoring: producer_destinations: -
+      # monitored_resource: library.googleapis.com/Branch metrics: - library.
+      # googleapis.com/book/returned_count consumer_destinations: - monitored_resource:
+      # library.googleapis.com/Branch metrics: - library.googleapis.com/book/
+      # returned_count - library.googleapis.com/book/num_overdue
       class Monitoring
         include Google::Apis::Core::Hashable
       
-        # Monitoring configurations for sending metrics to the consumer project.
-        # 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.
+        # Monitoring configurations for sending metrics to the consumer project. 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.
         # Corresponds to the JSON property `consumerDestinations`
         # @return [Array<Google::Apis::ServicemanagementV1::MonitoringDestination>]
         attr_accessor :consumer_destinations
       
-        # Monitoring configurations for sending metrics to the producer project.
-        # 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.
+        # Monitoring configurations for sending metrics to the producer project. 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.
         # Corresponds to the JSON property `producerDestinations`
         # @return [Array<Google::Apis::ServicemanagementV1::MonitoringDestination>]
         attr_accessor :producer_destinations
@@ -3101,19 +2577,19 @@ module Google
         end
       end
       
-      # Configuration of a specific monitoring destination (the producer project
-      # or the consumer project).
+      # Configuration of a specific monitoring destination (the producer project or
+      # the consumer project).
       class MonitoringDestination
         include Google::Apis::Core::Hashable
       
-        # Types of the metrics to report to this monitoring destination.
-        # Each type must be defined in Service.metrics section.
+        # Types of the metrics to report to this monitoring destination. Each type must
+        # be defined in Service.metrics section.
         # Corresponds to the JSON property `metrics`
         # @return [Array<String>]
         attr_accessor :metrics
       
-        # The monitored resource type. The type must be defined in
-        # Service.monitored_resources section.
+        # The monitored resource type. The type must be defined in Service.
+        # monitored_resources section.
         # Corresponds to the JSON property `monitoredResource`
         # @return [String]
         attr_accessor :monitored_resource
@@ -3130,27 +2606,25 @@ module Google
       end
       
       # OAuth scopes are a way to define data and permissions on data. For example,
-      # there are scopes defined for "Read-only access to Google Calendar" and
-      # "Access to Cloud Platform". Users can consent to a scope for an application,
-      # giving it permission to access that data on their behalf.
-      # OAuth scope specifications should be fairly coarse grained; a user will need
-      # to see and understand the text description of what your scope means.
-      # In most cases: use one or at most two OAuth scopes for an entire family of
-      # products. If your product has multiple APIs, you should probably be sharing
-      # the OAuth scope across all of those APIs.
-      # When you need finer grained OAuth consent screens: talk with your product
-      # management about how developers will use them in practice.
-      # Please note that even though each of the canonical scopes is enough for a
-      # request to be accepted and passed to the backend, a request can still fail
-      # due to the backend requiring additional scopes or permissions.
+      # there are scopes defined for "Read-only access to Google Calendar" and "Access
+      # to Cloud Platform". Users can consent to a scope for an application, giving it
+      # permission to access that data on their behalf. OAuth scope specifications
+      # should be fairly coarse grained; a user will need to see and understand the
+      # text description of what your scope means. In most cases: use one or at most
+      # two OAuth scopes for an entire family of products. If your product has
+      # multiple APIs, you should probably be sharing the OAuth scope across all of
+      # those APIs. When you need finer grained OAuth consent screens: talk with your
+      # product management about how developers will use them in practice. Please note
+      # that even though each of the canonical scopes is enough for a request to be
+      # accepted and passed to the backend, a request can still fail due to the
+      # backend requiring additional scopes or permissions.
       class OAuthRequirements
         include Google::Apis::Core::Hashable
       
-        # The list of publicly documented OAuth scopes that are allowed access. An
-        # OAuth token containing any of these scopes will be accepted.
-        # Example:
-        # canonical_scopes: https://www.googleapis.com/auth/calendar,
-        # https://www.googleapis.com/auth/calendar.read
+        # The list of publicly documented OAuth scopes that are allowed access. An OAuth
+        # token containing any of these scopes will be accepted. Example:
+        # canonical_scopes: https://www.googleapis.com/auth/calendar, https://www.
+        # googleapis.com/auth/calendar.read
         # Corresponds to the JSON property `canonicalScopes`
         # @return [String]
         attr_accessor :canonical_scopes
@@ -3170,47 +2644,45 @@ module Google
       class Operation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
-        # If `true`, the operation is completed, and either `error` or `response` is
-        # available.
+        # If the value is `false`, it means the operation is still in progress. If `true`
+        # , the operation is completed, and either `error` or `response` is available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::ServicemanagementV1::Status]
         attr_accessor :error
       
-        # Service-specific metadata associated with the operation.  It typically
-        # contains progress information and common metadata such as create time.
-        # Some services might not provide such metadata.  Any method that returns a
-        # long-running operation should document the metadata type, if any.
+        # Service-specific metadata associated with the operation. It typically contains
+        # progress information and common metadata such as create time. Some services
+        # might not provide such metadata. Any method that returns a long-running
+        # operation should document the metadata type, if any.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # originally returns it. If you use the default HTTP mapping, the `name` should
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success.  If the original
-        # method returns no data on success, such as `Delete`, the response is
-        # `google.protobuf.Empty`.  If the original method is standard
-        # `Get`/`Create`/`Update`, the response should be the resource.  For other
-        # methods, the response should have the type `XxxResponse`, where `Xxx`
-        # is the original method name.  For example, if the original method name
-        # is `TakeSnapshot()`, the inferred response type is
-        # `TakeSnapshotResponse`.
+        # The normal response of the operation in case of success. If the original
+        # method returns no data on success, such as `Delete`, the response is `google.
+        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
+        # the response should be the resource. For other methods, the response should
+        # have the type `XxxResponse`, where `Xxx` is the original method name. For
+        # example, if the original method name is `TakeSnapshot()`, the inferred
+        # response type is `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -3238,8 +2710,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :progress_percentage
       
-        # The full name of the resources that this operation is directly
-        # associated with.
+        # The full name of the resources that this operation is directly associated with.
         # Corresponds to the JSON property `resourceNames`
         # @return [Array<String>]
         attr_accessor :resource_names
@@ -3273,17 +2744,17 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The option's name. For protobuf built-in options (options defined in
-        # descriptor.proto), this is the short name. For example, `"map_entry"`.
-        # For custom options, it should be the fully-qualified name. For example,
-        # `"google.api.http"`.
+        # descriptor.proto), this is the short name. For example, `"map_entry"`. For
+        # custom options, it should be the fully-qualified name. For example, `"google.
+        # api.http"`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The option's value packed in an Any message. If the value is a primitive,
-        # the corresponding wrapper type defined in google/protobuf/wrappers.proto
-        # should be used. If the value is an enum, it should be stored as an int32
-        # value using the google.protobuf.Int32Value type.
+        # The option's value packed in an Any message. If the value is a primitive, the
+        # corresponding wrapper type defined in google/protobuf/wrappers.proto should be
+        # used. If the value is an enum, it should be stored as an int32 value using the
+        # google.protobuf.Int32Value type.
         # Corresponds to the JSON property `value`
         # @return [Hash<String,Object>]
         attr_accessor :value
@@ -3304,32 +2775,25 @@ module Google
       class Page
         include Google::Apis::Core::Hashable
       
-        # 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 (== include `path` ==) to
+        # include content from a Markdown file.
         # Corresponds to the JSON property `content`
         # @return [String]
         attr_accessor :content
       
-        # The name of the page. It will be used as an identity of the page to
-        # generate URI of the page, text of the link to this page in navigation,
-        # etc. The full page name (start from the root page name to this page
-        # concatenated with `.`) can be used as reference to the page in your
-        # documentation. For example:
-        # <pre><code>pages:
-        # - name: Tutorial
-        # content: &#40;== include tutorial.md ==&#41;
-        # subpages:
-        # - name: Java
-        # content: &#40;== include tutorial_java.md ==&#41;
-        # </code></pre>
-        # You can reference `Java` page using Markdown reference link syntax:
-        # `Java`.
+        # The name of the page. It will be used as an identity of the page to generate
+        # URI of the page, text of the link to this page in navigation, etc. The full
+        # page name (start from the root page name to this page concatenated with `.`)
+        # can be used as reference to the page in your documentation. For example: pages:
+        # - name: Tutorial content: (== include tutorial.md ==) subpages: - name: Java
+        # content: (== include tutorial_java.md ==) You can reference `Java` page using
+        # Markdown reference link syntax: `Java`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Subpages of this page. The order of subpages specified here will be
-        # honored in the generated docset.
+        # Subpages of this page. The order of subpages specified here will be honored in
+        # the generated docset.
         # Corresponds to the JSON property `subpages`
         # @return [Array<Google::Apis::ServicemanagementV1::Page>]
         attr_accessor :subpages
@@ -3347,66 +2811,32 @@ module Google
       end
       
       # An Identity and Access Management (IAM) policy, which specifies access
-      # controls for Google Cloud resources.
-      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
-      # `members` to a single `role`. Members can be user accounts, service accounts,
-      # Google groups, and domains (such as G Suite). A `role` is a named list of
-      # permissions; each `role` can be an IAM predefined role or a user-created
-      # custom role.
-      # For some types of Google Cloud resources, a `binding` can also specify a
-      # `condition`, which is a logical expression that allows access to a resource
-      # only if the expression evaluates to `true`. A condition can add constraints
-      # based on attributes of the request, the resource, or both. To learn which
-      # resources support conditions in their IAM policies, see the
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
-      # policies).
-      # **JSON example:**
-      # `
-      # "bindings": [
-      # `
-      # "role": "roles/resourcemanager.organizationAdmin",
-      # "members": [
-      # "user:mike@example.com",
-      # "group:admins@example.com",
-      # "domain:google.com",
-      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
-      # ]
-      # `,
-      # `
-      # "role": "roles/resourcemanager.organizationViewer",
-      # "members": [
-      # "user:eve@example.com"
-      # ],
-      # "condition": `
-      # "title": "expirable access",
-      # "description": "Does not grant access after Sep 2020",
-      # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
-      # ",
-      # `
-      # `
-      # ],
-      # "etag": "BwWWja0YfJA=",
-      # "version": 3
-      # `
-      # **YAML example:**
-      # bindings:
-      # - members:
-      # - user:mike@example.com
-      # - group:admins@example.com
-      # - domain:google.com
-      # - serviceAccount:my-project-id@appspot.gserviceaccount.com
-      # role: roles/resourcemanager.organizationAdmin
-      # - members:
-      # - user:eve@example.com
-      # role: roles/resourcemanager.organizationViewer
-      # condition:
-      # title: expirable access
-      # description: Does not grant access after Sep 2020
-      # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
-      # - etag: BwWWja0YfJA=
-      # - version: 3
-      # For a description of IAM and its features, see the
-      # [IAM documentation](https://cloud.google.com/iam/docs/).
+      # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
+      # A `binding` binds one or more `members` to a single `role`. Members can be
+      # user accounts, service accounts, Google groups, and domains (such as G Suite).
+      # A `role` is a named list of permissions; each `role` can be an IAM predefined
+      # role or a user-created custom role. For some types of Google Cloud resources,
+      # a `binding` can also specify a `condition`, which is a logical expression that
+      # allows access to a resource only if the expression evaluates to `true`. A
+      # condition can add constraints based on attributes of the request, the resource,
+      # or both. To learn which resources support conditions in their IAM policies,
+      # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
+      # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
+      # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
+      # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
+      # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
+      # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
+      # title": "expirable access", "description": "Does not grant access after Sep
+      # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
+      # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
+      # members: - user:mike@example.com - group:admins@example.com - domain:google.
+      # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
+      # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
+      # roles/resourcemanager.organizationViewer condition: title: expirable access
+      # description: Does not grant access after Sep 2020 expression: request.time <
+      # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a
+      # description of IAM and its features, see the [IAM documentation](https://cloud.
+      # google.com/iam/docs/).
       class Policy
         include Google::Apis::Core::Hashable
       
@@ -3415,48 +2845,44 @@ module Google
         # @return [Array<Google::Apis::ServicemanagementV1::AuditConfig>]
         attr_accessor :audit_configs
       
-        # Associates a list of `members` to a `role`. Optionally, may specify a
-        # `condition` that determines how and when the `bindings` are applied. Each
-        # of the `bindings` must contain at least one member.
+        # Associates a list of `members` to a `role`. Optionally, may specify a `
+        # condition` that determines how and when the `bindings` are applied. Each of
+        # the `bindings` must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::ServicemanagementV1::Binding>]
         attr_accessor :bindings
       
-        # `etag` is used for optimistic concurrency control as a way to help
-        # prevent simultaneous updates of a policy from overwriting each other.
-        # It is strongly suggested that systems make use of the `etag` in the
-        # read-modify-write cycle to perform policy updates in order to avoid race
-        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
-        # systems are expected to put that etag in the request to `setIamPolicy` to
-        # ensure that their change will be applied to the same version of the policy.
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
-        # the conditions in the version `3` policy are lost.
+        # `etag` is used for optimistic concurrency control as a way to help prevent
+        # simultaneous updates of a policy from overwriting each other. It is strongly
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
+        # to perform policy updates in order to avoid race conditions: An `etag` is
+        # returned in the response to `getIamPolicy`, and systems are expected to put
+        # that etag in the request to `setIamPolicy` to ensure that their change will be
+        # applied to the same version of the policy. **Important:** If you use IAM
+        # Conditions, you must include the `etag` field whenever you call `setIamPolicy`.
+        # If you omit this field, then IAM allows you to overwrite a version `3` policy
+        # with a version `1` policy, and all of the conditions in the version `3` policy
+        # are lost.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :etag
       
-        # Specifies the format of the policy.
-        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
-        # are rejected.
-        # Any operation that affects conditional role bindings must specify version
-        # `3`. This requirement applies to the following operations:
-        # * Getting a policy that includes a conditional role binding
-        # * Adding a conditional role binding to a policy
-        # * Changing a conditional role binding in a policy
-        # * Removing any role binding, with or without a condition, from a policy
-        # that includes conditions
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
-        # the conditions in the version `3` policy are lost.
-        # If a policy does not include any conditions, operations on that policy may
-        # specify any valid version or leave the field unset.
-        # To learn which resources support conditions in their IAM policies, see the
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
-        # policies).
+        # Specifies the format of the policy. Valid values are `0`, `1`, and `3`.
+        # Requests that specify an invalid value are rejected. Any operation that
+        # affects conditional role bindings must specify version `3`. This requirement
+        # applies to the following operations: * Getting a policy that includes a
+        # conditional role binding * Adding a conditional role binding to a policy *
+        # Changing a conditional role binding in a policy * Removing any role binding,
+        # with or without a condition, from a policy that includes conditions **
+        # Important:** If you use IAM Conditions, you must include the `etag` field
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
+        # to overwrite a version `3` policy with a version `1` policy, and all of the
+        # conditions in the version `3` policy are lost. If a policy does not include
+        # any conditions, operations on that policy may specify any valid version or
+        # leave the field unset. To learn which resources support conditions in their
+        # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/
+        # conditions/resource-policies).
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -3474,46 +2900,25 @@ module Google
         end
       end
       
-      # Quota configuration helps to achieve fairness and budgeting in service
-      # usage.
-      # 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.
-      # - The quota.limits defines limits on the metrics, which will be used for
-      # quota checks at runtime.
-      # An example quota configuration in yaml format:
-      # quota:
-      # limits:
-      # - name: apiWriteQpsPerProject
-      # metric: library.googleapis.com/write_calls
-      # unit: "1/min/`project`"  # rate limit for consumer projects
-      # 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
-      # # consuming at twice rate as the DeleteBook method.
-      # metric_rules:
-      # - selector: "*"
-      # metric_costs:
-      # library.googleapis.com/read_calls: 1
-      # - selector: google.example.library.v1.LibraryService.UpdateBook
-      # metric_costs:
-      # library.googleapis.com/write_calls: 2
-      # - selector: google.example.library.v1.LibraryService.DeleteBook
-      # metric_costs:
-      # library.googleapis.com/write_calls: 1
-      # Corresponding Metric definition:
-      # metrics:
-      # - name: library.googleapis.com/read_calls
-      # display_name: Read requests
-      # metric_kind: DELTA
-      # value_type: INT64
-      # - name: library.googleapis.com/write_calls
-      # display_name: Write requests
-      # metric_kind: DELTA
-      # value_type: INT64
+      # Quota configuration helps to achieve fairness and budgeting in service usage.
+      # 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. - The quota.
+      # limits defines limits on the metrics, which will be used for quota checks at
+      # runtime. An example quota configuration in yaml format: quota: limits: - name:
+      # apiWriteQpsPerProject metric: library.googleapis.com/write_calls unit: "1/min/`
+      # project`" # rate limit for consumer projects 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 # consuming at twice rate as
+      # the DeleteBook method. metric_rules: - selector: "*" metric_costs: library.
+      # googleapis.com/read_calls: 1 - selector: google.example.library.v1.
+      # LibraryService.UpdateBook metric_costs: library.googleapis.com/write_calls: 2 -
+      # selector: google.example.library.v1.LibraryService.DeleteBook metric_costs:
+      # library.googleapis.com/write_calls: 1 Corresponding Metric definition: metrics:
+      # - name: library.googleapis.com/read_calls display_name: Read requests
+      # metric_kind: DELTA value_type: INT64 - name: library.googleapis.com/
+      # write_calls display_name: Write requests metric_kind: DELTA value_type: INT64
       class Quota
         include Google::Apis::Core::Hashable
       
@@ -3522,8 +2927,8 @@ module Google
         # @return [Array<Google::Apis::ServicemanagementV1::QuotaLimit>]
         attr_accessor :limits
       
-        # List of `MetricRule` definitions, each one mapping a selected method to one
-        # or more metrics.
+        # List of `MetricRule` definitions, each one mapping a selected method to one or
+        # more metrics.
         # Corresponds to the JSON property `metricRules`
         # @return [Array<Google::Apis::ServicemanagementV1::MetricRule>]
         attr_accessor :metric_rules
@@ -3540,95 +2945,89 @@ module Google
       end
       
       # `QuotaLimit` defines a specific limit that applies over a specified duration
-      # for a limit type. There can be at most one limit for a duration and limit
-      # type combination defined within a `QuotaGroup`.
+      # for a limit type. There can be at most one limit for a duration and limit type
+      # combination defined within a `QuotaGroup`.
       class QuotaLimit
         include Google::Apis::Core::Hashable
       
-        # Default number of tokens that can be consumed during the specified
-        # duration. This is the number of tokens assigned when a client
-        # application developer activates the service for his/her project.
-        # Specifying a value of 0 will block all requests. This can be used if you
-        # are provisioning quota to selected consumers and blocking others.
-        # Similarly, a value of -1 will indicate an unlimited quota. No other
-        # negative values are allowed.
-        # Used by group-based quotas only.
+        # Default number of tokens that can be consumed during the specified duration.
+        # This is the number of tokens assigned when a client application developer
+        # activates the service for his/her project. Specifying a value of 0 will block
+        # all requests. This can be used if you are provisioning quota to selected
+        # consumers and blocking others. Similarly, a value of -1 will indicate an
+        # unlimited quota. No other negative values are allowed. Used by group-based
+        # quotas only.
         # Corresponds to the JSON property `defaultLimit`
         # @return [Fixnum]
         attr_accessor :default_limit
       
-        # Optional. User-visible, extended description for this quota limit.
-        # Should be used only when more context is needed to understand this limit
-        # than provided by the limit's display name (see: `display_name`).
+        # Optional. User-visible, extended description for this quota limit. Should be
+        # used only when more context is needed to understand this limit than provided
+        # by the limit's display name (see: `display_name`).
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # User-visible display name for this limit.
-        # Optional. If not set, the UI will provide a default display name based on
-        # the quota configuration. This field can be used to override the default
-        # display name generated from the configuration.
+        # User-visible display name for this limit. Optional. If not set, the UI will
+        # provide a default display name based on the quota configuration. This field
+        # can be used to override the default display name generated from the
+        # configuration.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Duration of this limit in textual notation. Must be "100s" or "1d".
-        # Used by group-based quotas only.
+        # Duration of this limit in textual notation. Must be "100s" or "1d". Used by
+        # group-based quotas only.
         # Corresponds to the JSON property `duration`
         # @return [String]
         attr_accessor :duration
       
-        # Free tier value displayed in the Developers Console for this limit.
-        # The free tier is the number of tokens that will be subtracted from the
-        # billed amount when billing is enabled.
-        # This field can only be set on a limit with duration "1d", in a billable
-        # group; it is invalid on any other limit. If this field is not set, it
-        # defaults to 0, indicating that there is no free tier for this service.
-        # Used by group-based quotas only.
+        # Free tier value displayed in the Developers Console for this limit. The free
+        # tier is the number of tokens that will be subtracted from the billed amount
+        # when billing is enabled. This field can only be set on a limit with duration "
+        # 1d", in a billable group; it is invalid on any other limit. If this field is
+        # not set, it defaults to 0, indicating that there is no free tier for this
+        # service. Used by group-based quotas only.
         # Corresponds to the JSON property `freeTier`
         # @return [Fixnum]
         attr_accessor :free_tier
       
-        # Maximum number of tokens that can be consumed during the specified
-        # duration. Client application developers can override the default limit up
-        # to this maximum. If specified, this value cannot be set to a value less
-        # than the default limit. If not specified, it is set to the default limit.
-        # To allow clients to apply overrides with no upper bound, set this to -1,
-        # indicating unlimited maximum quota.
-        # Used by group-based quotas only.
+        # Maximum number of tokens that can be consumed during the specified duration.
+        # Client application developers can override the default limit up to this
+        # maximum. If specified, this value cannot be set to a value less than the
+        # default limit. If not specified, it is set to the default limit. To allow
+        # clients to apply overrides with no upper bound, set this to -1, indicating
+        # unlimited maximum quota. Used by group-based quotas only.
         # Corresponds to the JSON property `maxLimit`
         # @return [Fixnum]
         attr_accessor :max_limit
       
-        # 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
+        # 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.
         # Corresponds to the JSON property `metric`
         # @return [String]
         attr_accessor :metric
       
-        # Name of the quota limit.
-        # 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.
+        # Name of the quota limit. 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.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # 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.
-        # Here are some examples:
-        # * "1/min/`project`" for quota per minute per project.
-        # Note: the order of unit components is insignificant.
-        # The "1" at the beginning is required to follow the metric unit syntax.
+        # 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. Here are
+        # some examples: * "1/min/`project`" for quota per minute per project. Note: the
+        # order of unit components is insignificant. The "1" at the beginning is
+        # required to follow the metric unit syntax.
         # Corresponds to the JSON property `unit`
         # @return [String]
         attr_accessor :unit
       
         # 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.
+        # integer value that is the maximum number of requests allowed for the specified
+        # unit. Currently only STANDARD is supported.
         # Corresponds to the JSON property `values`
         # @return [Hash<String,Fixnum>]
         attr_accessor :values
@@ -3652,39 +3051,26 @@ module Google
         end
       end
       
-      # Defines a proto annotation that describes a string field that refers to
-      # an API resource.
+      # Defines a proto annotation that describes a string field that refers to an API
+      # resource.
       class ResourceReference
         include Google::Apis::Core::Hashable
       
-        # The resource type of a child collection that the annotated field
-        # references. This is useful for annotating the `parent` field that
-        # doesn't have a fixed resource type.
-        # Example:
-        # message ListLogEntriesRequest `
-        # string parent = 1 [(google.api.resource_reference) = `
-        # child_type: "logging.googleapis.com/LogEntry"
-        # `;
-        # `
+        # The resource type of a child collection that the annotated field references.
+        # This is useful for annotating the `parent` field that doesn't have a fixed
+        # resource type. Example: message ListLogEntriesRequest ` string parent = 1 [(
+        # google.api.resource_reference) = ` child_type: "logging.googleapis.com/
+        # LogEntry" `; `
         # Corresponds to the JSON property `childType`
         # @return [String]
         attr_accessor :child_type
       
-        # The resource type that the annotated field references.
-        # Example:
-        # message Subscription `
-        # string topic = 2 [(google.api.resource_reference) = `
-        # type: "pubsub.googleapis.com/Topic"
-        # `];
-        # `
-        # Occasionally, a field may reference an arbitrary resource. In this case,
-        # APIs use the special value * in their resource reference.
-        # Example:
-        # message GetIamPolicyRequest `
-        # string resource = 2 [(google.api.resource_reference) = `
-        # type: "*"
-        # `];
-        # `
+        # The resource type that the annotated field references. Example: message
+        # Subscription ` string topic = 2 [(google.api.resource_reference) = ` type: "
+        # pubsub.googleapis.com/Topic" `]; ` Occasionally, a field may reference an
+        # arbitrary resource. In this case, APIs use the special value * in their
+        # resource reference. Example: message GetIamPolicyRequest ` string resource = 2
+        # [(google.api.resource_reference) = ` type: "*" `]; `
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -3701,8 +3087,8 @@ module Google
       end
       
       # A rollout resource that defines how service configuration versions are pushed
-      # to control plane systems. Typically, you create a new version of the
-      # service config, and then create a Rollout to push the service config.
+      # to control plane systems. Typically, you create a new version of the service
+      # config, and then create a Rollout to push the service config.
       class Rollout
         include Google::Apis::Core::Hashable
       
@@ -3711,26 +3097,25 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # This field is deprecated and will be deleted. Please remove usage of
-        # this field.
+        # This field is deprecated and will be deleted. Please remove usage of this
+        # field.
         # Corresponds to the JSON property `createdBy`
         # @return [String]
         attr_accessor :created_by
       
-        # Strategy used to delete a service. This strategy is a placeholder only
-        # used by the system generated rollout to delete a service.
+        # Strategy used to delete a service. This strategy is a placeholder only used by
+        # the system generated rollout to delete a service.
         # Corresponds to the JSON property `deleteServiceStrategy`
         # @return [Google::Apis::ServicemanagementV1::DeleteServiceStrategy]
         attr_accessor :delete_service_strategy
       
         # Optional. Unique identifier of this Rollout. Must be no longer than 63
-        # characters
-        # and only lower case letters, digits, '.', '_' and '-' are allowed.
+        # characters and only lower case letters, digits, '.', '_' and '-' are allowed.
         # If not specified by client, the server will generate one. The generated id
-        # will have the form of <date><revision number>, where "date" is the create
-        # date in ISO 8601 format.  "revision number" is a monotonically increasing
-        # positive number that is reset every day for each service.
-        # An example of the generated rollout_id is '2016-02-16r1'
+        # will have the form of , where "date" is the create date in ISO 8601 format. "
+        # revision number" is a monotonically increasing positive number that is reset
+        # every day for each service. An example of the generated rollout_id is '2016-02-
+        # 16r1'
         # Corresponds to the JSON property `rolloutId`
         # @return [String]
         attr_accessor :rollout_id
@@ -3740,39 +3125,21 @@ module Google
         # @return [String]
         attr_accessor :service_name
       
-        # The status of this rollout. Readonly. In case of a failed rollout,
-        # the system will automatically rollback to the current Rollout
-        # version. Readonly.
+        # The status of this rollout. Readonly. In case of a failed rollout, the system
+        # will automatically rollback to the current Rollout version. Readonly.
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
       
-        # Strategy that specifies how clients of Google Service Controller want to
-        # send traffic to use different config versions. This is generally
-        # used by API proxy to split traffic based on your configured percentage for
-        # each config version.
-        # One example of how to gradually rollout a new service configuration using
-        # this
-        # strategy:
-        # Day 1
-        # Rollout `
-        # id: "example.googleapis.com/rollout_20160206"
-        # traffic_percent_strategy `
-        # percentages: `
-        # "example.googleapis.com/20160201": 70.00
-        # "example.googleapis.com/20160206": 30.00
-        # `
-        # `
-        # `
-        # Day 2
-        # Rollout `
-        # id: "example.googleapis.com/rollout_20160207"
-        # traffic_percent_strategy: `
-        # percentages: `
-        # "example.googleapis.com/20160206": 100.00
-        # `
-        # `
-        # `
+        # Strategy that specifies how clients of Google Service Controller want to send
+        # traffic to use different config versions. This is generally used by API proxy
+        # to split traffic based on your configured percentage for each config version.
+        # One example of how to gradually rollout a new service configuration using this
+        # strategy: Day 1 Rollout ` id: "example.googleapis.com/rollout_20160206"
+        # traffic_percent_strategy ` percentages: ` "example.googleapis.com/20160201":
+        # 70.00 "example.googleapis.com/20160206": 30.00 ` ` ` Day 2 Rollout ` id: "
+        # example.googleapis.com/rollout_20160207" traffic_percent_strategy: `
+        # percentages: ` "example.googleapis.com/20160206": 100.00 ` ` `
         # Corresponds to the JSON property `trafficPercentStrategy`
         # @return [Google::Apis::ServicemanagementV1::TrafficPercentStrategy]
         attr_accessor :traffic_percent_strategy
@@ -3794,50 +3161,32 @@ module Google
       end
       
       # `Service` is the root object of Google service configuration schema. It
-      # describes basic information about a service, such as the name and the
-      # title, and delegates other aspects to sub-sections. Each sub-section is
-      # either a proto message or a repeated proto message that configures a
-      # specific aspect, such as auth. See each proto message definition for details.
-      # Example:
-      # type: google.api.Service
-      # config_version: 3
-      # name: calendar.googleapis.com
-      # title: Google Calendar API
-      # apis:
-      # - name: google.calendar.v3.Calendar
-      # authentication:
-      # providers:
-      # - id: google_calendar_auth
-      # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
-      # issuer: https://securetoken.google.com
-      # rules:
-      # - selector: "*"
-      # requirements:
-      # provider_id: google_calendar_auth
+      # describes basic information about a service, such as the name and the title,
+      # and delegates other aspects to sub-sections. Each sub-section is either a
+      # proto message or a repeated proto message that configures a specific aspect,
+      # such as auth. See each proto message definition for details. Example: type:
+      # google.api.Service config_version: 3 name: calendar.googleapis.com title:
+      # Google Calendar API apis: - name: google.calendar.v3.Calendar authentication:
+      # providers: - id: google_calendar_auth jwks_uri: https://www.googleapis.com/
+      # oauth2/v1/certs issuer: https://securetoken.google.com rules: - selector: "*"
+      # requirements: provider_id: google_calendar_auth
       class Service
         include Google::Apis::Core::Hashable
       
-        # A list of API interfaces exported by this service. Only the `name` field
-        # of the google.protobuf.Api needs to be provided by the configuration
-        # author, as the remaining fields will be derived from the IDL during the
-        # normalization process. It is an error to specify an API interface here
-        # which cannot be resolved against the associated IDL files.
+        # A list of API interfaces exported by this service. Only the `name` field of
+        # the google.protobuf.Api needs to be provided by the configuration author, as
+        # the remaining fields will be derived from the IDL during the normalization
+        # process. It is an error to specify an API interface here which cannot be
+        # resolved against the associated IDL files.
         # Corresponds to the JSON property `apis`
         # @return [Array<Google::Apis::ServicemanagementV1::Api>]
         attr_accessor :apis
       
-        # `Authentication` defines the authentication configuration for an API.
-        # Example for an API targeted for external use:
-        # name: calendar.googleapis.com
-        # authentication:
-        # providers:
-        # - id: google_calendar_auth
-        # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
-        # issuer: https://securetoken.google.com
-        # rules:
-        # - selector: "*"
-        # requirements:
-        # provider_id: google_calendar_auth
+        # `Authentication` defines the authentication configuration for an API. Example
+        # for an API targeted for external use: name: calendar.googleapis.com
+        # authentication: providers: - id: google_calendar_auth jwks_uri: https://www.
+        # googleapis.com/oauth2/v1/certs issuer: https://securetoken.google.com rules: -
+        # selector: "*" requirements: provider_id: google_calendar_auth
         # Corresponds to the JSON property `authentication`
         # @return [Google::Apis::ServicemanagementV1::Authentication]
         attr_accessor :authentication
@@ -3847,211 +3196,133 @@ module Google
         # @return [Google::Apis::ServicemanagementV1::Backend]
         attr_accessor :backend
       
-        # Billing related configuration of the service.
-        # The following example shows how to configure monitored resources and metrics
-        # 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/billing_branch
-        # labels:
-        # - 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/billing_branch
-        # metrics:
-        # - library.googleapis.com/book/borrowed_count
+        # Billing related configuration of the service. The following example shows how
+        # to configure monitored resources and metrics 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/
+        # billing_branch labels: - 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/billing_branch metrics: - library.
+        # googleapis.com/book/borrowed_count
         # Corresponds to the JSON property `billing`
         # @return [Google::Apis::ServicemanagementV1::Billing]
         attr_accessor :billing
       
-        # 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`.
+        # This field is obsolete. Its value must be set to `3`.
         # Corresponds to the JSON property `configVersion`
         # @return [Fixnum]
         attr_accessor :config_version
       
-        # `Context` defines which contexts an API requests.
-        # Example:
-        # context:
-        # rules:
-        # - selector: "*"
-        # requested:
-        # - google.rpc.context.ProjectContext
-        # - google.rpc.context.OriginContext
-        # The above specifies that all methods in the API request
-        # `google.rpc.context.ProjectContext` and
-        # `google.rpc.context.OriginContext`.
-        # Available context types are defined in package
-        # `google.rpc.context`.
-        # This also provides mechanism to whitelist 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.
+        # `Context` defines which contexts an API requests. Example: context: rules: -
+        # selector: "*" requested: - google.rpc.context.ProjectContext - google.rpc.
+        # context.OriginContext The above specifies that all methods in the API request `
+        # google.rpc.context.ProjectContext` and `google.rpc.context.OriginContext`.
+        # 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--bin” and “x-goog-ext--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.
         # Corresponds to the JSON property `context`
         # @return [Google::Apis::ServicemanagementV1::Context]
         attr_accessor :context
       
-        # Selects and configures the service controller used by the service.  The
-        # service controller handles features like abuse, quota, billing, logging,
-        # monitoring, etc.
+        # Selects and configures the service controller used by the service. The service
+        # controller handles features like abuse, quota, billing, logging, monitoring,
+        # etc.
         # Corresponds to the JSON property `control`
         # @return [Google::Apis::ServicemanagementV1::Control]
         attr_accessor :control
       
-        # Customize service error responses.  For example, list any service
-        # specific protobuf types that can appear in error detail lists of
-        # error responses.
-        # Example:
-        # custom_error:
-        # types:
-        # - google.foo.v1.CustomError
-        # - google.foo.v1.AnotherError
+        # Customize service error responses. For example, list any service specific
+        # protobuf types that can appear in error detail lists of error responses.
+        # Example: custom_error: types: - google.foo.v1.CustomError - google.foo.v1.
+        # AnotherError
         # Corresponds to the JSON property `customError`
         # @return [Google::Apis::ServicemanagementV1::CustomError]
         attr_accessor :custom_error
       
-        # `Documentation` provides the information for describing a service.
-        # Example:
-        # <pre><code>documentation:
-        # summary: >
-        # The Google Calendar API gives access
-        # to most calendar features.
-        # pages:
-        # - name: Overview
-        # content: &#40;== include google/foo/overview.md ==&#41;
-        # - name: Tutorial
-        # content: &#40;== include google/foo/tutorial.md ==&#41;
-        # subpages;
-        # - name: Java
-        # content: &#40;== include google/foo/tutorial_java.md ==&#41;
-        # rules:
-        # - selector: google.calendar.Calendar.Get
-        # description: >
-        # ...
-        # - selector: google.calendar.Calendar.Put
-        # description: >
-        # ...
-        # </code></pre>
-        # Documentation is provided in markdown syntax. In addition to
-        # standard markdown features, definition lists, tables and fenced
-        # code blocks are supported. Section headers can be provided and are
-        # interpreted relative to the section nesting of the context where
-        # a documentation fragment is embedded.
-        # Documentation from the IDL is merged with documentation defined
-        # via the config at normalization time, where documentation provided
-        # by config rules overrides IDL provided.
-        # A number of constructs specific to the API platform are supported
-        # in documentation text.
-        # In order to reference a proto element, the following
-        # notation can be used:
-        # <pre><code>&#91;fully.qualified.proto.name]&#91;]</code></pre>
-        # To override the display text used for the link, this can be used:
-        # <pre><code>&#91;display text]&#91;fully.qualified.proto.name]</code></pre>
-        # Text can be excluded from doc using the following notation:
-        # <pre><code>&#40;-- internal comment --&#41;</code></pre>
-        # A few directives are available in documentation. Note that
-        # directives must appear on a single line to be properly
-        # identified. The `include` directive includes a markdown file from
-        # an external source:
-        # <pre><code>&#40;== include path/to/file ==&#41;</code></pre>
-        # The `resource_for` directive marks a message to be the resource of
-        # a collection in REST view. If it is not specified, tools attempt
-        # to infer the resource from the operations in a collection:
-        # <pre><code>&#40;== resource_for v1.shelves.books ==&#41;</code></pre>
-        # The directive `suppress_warning` does not directly affect documentation
-        # and is documented together with service config validation.
+        # `Documentation` provides the information for describing a service. Example:
+        # documentation: summary: > The Google Calendar API gives access to most
+        # calendar features. pages: - name: Overview content: (== include google/foo/
+        # overview.md ==) - name: Tutorial content: (== include google/foo/tutorial.md ==
+        # ) subpages; - name: Java content: (== include google/foo/tutorial_java.md ==)
+        # rules: - selector: google.calendar.Calendar.Get description: > ... - selector:
+        # google.calendar.Calendar.Put description: > ... Documentation is provided in
+        # markdown syntax. In addition to standard markdown features, definition lists,
+        # tables and fenced code blocks are supported. Section headers can be provided
+        # and are interpreted relative to the section nesting of the context where a
+        # documentation fragment is embedded. Documentation from the IDL is merged with
+        # documentation defined via the config at normalization time, where
+        # documentation provided by config rules overrides IDL provided. A number of
+        # constructs specific to the API platform are supported in documentation text.
+        # In order to reference a proto element, the following notation can be used: [
+        # fully.qualified.proto.name][] To override the display text used for the link,
+        # this can be used: [display text][fully.qualified.proto.name] Text can be
+        # excluded from doc using the following notation: (-- internal comment --) A few
+        # directives are available in documentation. Note that directives must appear on
+        # a single line to be properly identified. The `include` directive includes a
+        # markdown file from an external source: (== include path/to/file ==) The `
+        # resource_for` directive marks a message to be the resource of a collection in
+        # REST view. If it is not specified, tools attempt to infer the resource from
+        # the operations in a collection: (== resource_for v1.shelves.books ==) The
+        # directive `suppress_warning` does not directly affect documentation and is
+        # documented together with service config validation.
         # Corresponds to the JSON property `documentation`
         # @return [Google::Apis::ServicemanagementV1::Documentation]
         attr_accessor :documentation
       
-        # Configuration for network endpoints.  If this is empty, then an endpoint
-        # with the same name as the service is automatically generated to service all
-        # defined APIs.
+        # Configuration for network endpoints. If this is empty, then an endpoint with
+        # the same name as the service is automatically generated to service all defined
+        # APIs.
         # Corresponds to the JSON property `endpoints`
         # @return [Array<Google::Apis::ServicemanagementV1::Endpoint>]
         attr_accessor :endpoints
       
-        # A list of all enum types included in this API service.  Enums
-        # referenced directly or indirectly by the `apis` are automatically
-        # included.  Enums which are not referenced but shall be included
-        # should be listed here by name. Example:
-        # enums:
-        # - name: google.someapi.v1.SomeEnum
+        # A list of all enum types included in this API service. Enums referenced
+        # directly or indirectly by the `apis` are automatically included. Enums which
+        # are not referenced but shall be included should be listed here by name.
+        # Example: enums: - name: google.someapi.v1.SomeEnum
         # Corresponds to the JSON property `enums`
         # @return [Array<Google::Apis::ServicemanagementV1::Enum>]
         attr_accessor :enums
       
         # Defines the HTTP configuration for an API service. It contains a list of
-        # HttpRule, each specifying the mapping of an RPC method
-        # to one or more HTTP REST API methods.
+        # HttpRule, each specifying the mapping of an RPC method to one or more HTTP
+        # REST API methods.
         # Corresponds to the JSON property `http`
         # @return [Google::Apis::ServicemanagementV1::Http]
         attr_accessor :http
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Logging configuration of the service.
-        # The following example shows how to configure logs to be sent to the
-        # producer and consumer projects. In the example, the `activity_history`
-        # log is sent to both the producer and consumer projects, whereas the
-        # `purchase_history` log is only sent to the producer project.
-        # monitored_resources:
-        # - type: library.googleapis.com/branch
-        # labels:
-        # - key: /city
-        # description: The city where the library branch is located in.
-        # - key: /name
-        # description: The name of the branch.
-        # logs:
-        # - name: activity_history
-        # labels:
-        # - key: /customer_id
-        # - name: purchase_history
-        # logging:
-        # producer_destinations:
-        # - monitored_resource: library.googleapis.com/branch
-        # logs:
-        # - activity_history
-        # - purchase_history
-        # consumer_destinations:
-        # - monitored_resource: library.googleapis.com/branch
-        # logs:
-        # - activity_history
+        # Logging configuration of the service. The following example shows how to
+        # configure logs to be sent to the producer and consumer projects. In the
+        # example, the `activity_history` log is sent to both the producer and consumer
+        # projects, whereas the `purchase_history` log is only sent to the producer
+        # project. monitored_resources: - type: library.googleapis.com/branch labels: -
+        # key: /city description: The city where the library branch is located in. - key:
+        # /name description: The name of the branch. logs: - name: activity_history
+        # labels: - key: /customer_id - name: purchase_history logging:
+        # producer_destinations: - monitored_resource: library.googleapis.com/branch
+        # logs: - activity_history - purchase_history consumer_destinations: -
+        # monitored_resource: library.googleapis.com/branch logs: - activity_history
         # Corresponds to the JSON property `logging`
         # @return [Google::Apis::ServicemanagementV1::Logging]
         attr_accessor :logging
@@ -4066,70 +3337,41 @@ module Google
         # @return [Array<Google::Apis::ServicemanagementV1::MetricDescriptor>]
         attr_accessor :metrics
       
-        # Defines the monitored resources used by this service. This is required
-        # by the Service.monitoring and Service.logging configurations.
+        # Defines the monitored resources used by this service. This is required by the
+        # Service.monitoring and Service.logging configurations.
         # Corresponds to the JSON property `monitoredResources`
         # @return [Array<Google::Apis::ServicemanagementV1::MonitoredResourceDescriptor>]
         attr_accessor :monitored_resources
       
-        # Monitoring configuration of the service.
-        # The example below shows how to configure monitored resources and metrics
-        # 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/num_overdue` metric is only sent to the
-        # consumer project.
-        # monitored_resources:
-        # - type: library.googleapis.com/Branch
-        # display_name: "Library Branch"
-        # description: "A branch of a library."
-        # launch_stage: GA
-        # labels:
-        # - 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
-        # 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
-        # description: "The id of the customer."
-        # monitoring:
-        # producer_destinations:
-        # - monitored_resource: library.googleapis.com/Branch
-        # metrics:
-        # - library.googleapis.com/book/returned_count
-        # consumer_destinations:
-        # - monitored_resource: library.googleapis.com/Branch
-        # metrics:
-        # - library.googleapis.com/book/returned_count
-        # - library.googleapis.com/book/num_overdue
+        # Monitoring configuration of the service. The example below shows how to
+        # configure monitored resources and metrics 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/num_overdue` metric is only sent to
+        # the consumer project. monitored_resources: - type: library.googleapis.com/
+        # Branch display_name: "Library Branch" description: "A branch of a library."
+        # launch_stage: GA labels: - 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 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
+        # description: "The id of the customer." monitoring: producer_destinations: -
+        # monitored_resource: library.googleapis.com/Branch metrics: - library.
+        # googleapis.com/book/returned_count consumer_destinations: - monitored_resource:
+        # library.googleapis.com/Branch metrics: - library.googleapis.com/book/
+        # returned_count - library.googleapis.com/book/num_overdue
         # Corresponds to the JSON property `monitoring`
         # @return [Google::Apis::ServicemanagementV1::Monitoring]
         attr_accessor :monitoring
       
-        # 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.
+        # 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.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -4139,46 +3381,25 @@ module Google
         # @return [String]
         attr_accessor :producer_project_id
       
-        # Quota configuration helps to achieve fairness and budgeting in service
-        # usage.
-        # 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.
-        # - The quota.limits defines limits on the metrics, which will be used for
-        # quota checks at runtime.
-        # An example quota configuration in yaml format:
-        # quota:
-        # limits:
-        # - name: apiWriteQpsPerProject
-        # metric: library.googleapis.com/write_calls
-        # unit: "1/min/`project`"  # rate limit for consumer projects
-        # 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
-        # # consuming at twice rate as the DeleteBook method.
-        # metric_rules:
-        # - selector: "*"
-        # metric_costs:
-        # library.googleapis.com/read_calls: 1
-        # - selector: google.example.library.v1.LibraryService.UpdateBook
-        # metric_costs:
-        # library.googleapis.com/write_calls: 2
-        # - selector: google.example.library.v1.LibraryService.DeleteBook
-        # metric_costs:
-        # library.googleapis.com/write_calls: 1
-        # Corresponding Metric definition:
-        # metrics:
-        # - name: library.googleapis.com/read_calls
-        # display_name: Read requests
-        # metric_kind: DELTA
-        # value_type: INT64
-        # - name: library.googleapis.com/write_calls
-        # display_name: Write requests
-        # metric_kind: DELTA
-        # value_type: INT64
+        # Quota configuration helps to achieve fairness and budgeting in service usage.
+        # 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. - The quota.
+        # limits defines limits on the metrics, which will be used for quota checks at
+        # runtime. An example quota configuration in yaml format: quota: limits: - name:
+        # apiWriteQpsPerProject metric: library.googleapis.com/write_calls unit: "1/min/`
+        # project`" # rate limit for consumer projects 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 # consuming at twice rate as
+        # the DeleteBook method. metric_rules: - selector: "*" metric_costs: library.
+        # googleapis.com/read_calls: 1 - selector: google.example.library.v1.
+        # LibraryService.UpdateBook metric_costs: library.googleapis.com/write_calls: 2 -
+        # selector: google.example.library.v1.LibraryService.DeleteBook metric_costs:
+        # library.googleapis.com/write_calls: 1 Corresponding Metric definition: metrics:
+        # - name: library.googleapis.com/read_calls display_name: Read requests
+        # metric_kind: DELTA value_type: INT64 - name: library.googleapis.com/
+        # write_calls display_name: Write requests metric_kind: DELTA value_type: INT64
         # Corresponds to the JSON property `quota`
         # @return [Google::Apis::ServicemanagementV1::Quota]
         attr_accessor :quota
@@ -4188,20 +3409,18 @@ module Google
         # @return [Google::Apis::ServicemanagementV1::SourceInfo]
         attr_accessor :source_info
       
-        # ### System parameter configuration
-        # A system parameter is a special kind of parameter defined by the API
-        # system, not by an individual API. It is typically mapped to an HTTP header
-        # and/or a URL query parameter. This configuration specifies which methods
-        # change the names of the system parameters.
+        # ### System parameter configuration A system parameter is a special kind of
+        # parameter defined by the API system, not by an individual API. It is typically
+        # mapped to an HTTP header and/or a URL query parameter. This configuration
+        # specifies which methods change the names of the system parameters.
         # Corresponds to the JSON property `systemParameters`
         # @return [Google::Apis::ServicemanagementV1::SystemParameters]
         attr_accessor :system_parameters
       
-        # A list of all proto message types included in this API service.
-        # It serves similar purpose as [google.api.Service.types], except that
-        # these types are not needed by user-defined APIs. Therefore, they will not
-        # show up in the generated discovery doc. This field should only be used
-        # to define system APIs in ESF.
+        # A list of all proto message types included in this API service. It serves
+        # similar purpose as [google.api.Service.types], except that these types are not
+        # needed by user-defined APIs. Therefore, they will not show up in the generated
+        # discovery doc. This field should only be used to define system APIs in ESF.
         # Corresponds to the JSON property `systemTypes`
         # @return [Array<Google::Apis::ServicemanagementV1::Type>]
         attr_accessor :system_types
@@ -4211,12 +3430,10 @@ module Google
         # @return [String]
         attr_accessor :title
       
-        # A list of all proto message types included in this API service.
-        # Types referenced directly or indirectly by the `apis` are
-        # automatically included.  Messages which are not referenced but
-        # shall be included, such as types used by the `google.protobuf.Any` type,
-        # should be listed here by name. Example:
-        # types:
+        # A list of all proto message types included in this API service. Types
+        # referenced directly or indirectly by the `apis` are automatically included.
+        # Messages which are not referenced but shall be included, such as types used by
+        # the `google.protobuf.Any` type, should be listed here by name. Example: types:
         # - name: google.protobuf.Int32
         # Corresponds to the JSON property `types`
         # @return [Array<Google::Apis::ServicemanagementV1::Type>]
@@ -4263,121 +3480,44 @@ module Google
         end
       end
       
-      # The per-product per-project service identity for a service.
-      # Use this field to configure per-product per-project service identity.
-      # Example of a service identity configuration.
-      # usage:
-      # service_identity:
-      # - service_account_parent: "projects/123456789"
-      # display_name: "Cloud XXX Service Agent"
-      # description: "Used as the identity of Cloud XXX to access resources"
-      class ServiceIdentity
-        include Google::Apis::Core::Hashable
-      
-        # Optional. A user-specified opaque description of the service account.
-        # Must be less than or equal to 256 UTF-8 bytes.
-        # Corresponds to the JSON property `description`
-        # @return [String]
-        attr_accessor :description
-      
-        # Optional. A user-specified name for the service account.
-        # Must be less than or equal to 100 UTF-8 bytes.
-        # Corresponds to the JSON property `displayName`
-        # @return [String]
-        attr_accessor :display_name
-      
-        # A service account project that hosts the service accounts.
-        # An example name would be:
-        # `projects/123456789`
-        # Corresponds to the JSON property `serviceAccountParent`
-        # @return [String]
-        attr_accessor :service_account_parent
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @description = args[:description] if args.key?(:description)
-          @display_name = args[:display_name] if args.key?(:display_name)
-          @service_account_parent = args[:service_account_parent] if args.key?(:service_account_parent)
-        end
-      end
-      
       # Request message for `SetIamPolicy` method.
       class SetIamPolicyRequest
         include Google::Apis::Core::Hashable
       
         # An Identity and Access Management (IAM) policy, which specifies access
-        # controls for Google Cloud resources.
-        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
-        # `members` to a single `role`. Members can be user accounts, service accounts,
-        # Google groups, and domains (such as G Suite). A `role` is a named list of
-        # permissions; each `role` can be an IAM predefined role or a user-created
-        # custom role.
-        # For some types of Google Cloud resources, a `binding` can also specify a
-        # `condition`, which is a logical expression that allows access to a resource
-        # only if the expression evaluates to `true`. A condition can add constraints
-        # based on attributes of the request, the resource, or both. To learn which
-        # resources support conditions in their IAM policies, see the
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
-        # policies).
-        # **JSON example:**
-        # `
-        # "bindings": [
-        # `
-        # "role": "roles/resourcemanager.organizationAdmin",
-        # "members": [
-        # "user:mike@example.com",
-        # "group:admins@example.com",
-        # "domain:google.com",
-        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
-        # ]
-        # `,
-        # `
-        # "role": "roles/resourcemanager.organizationViewer",
-        # "members": [
-        # "user:eve@example.com"
-        # ],
-        # "condition": `
-        # "title": "expirable access",
-        # "description": "Does not grant access after Sep 2020",
-        # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
-        # ",
-        # `
-        # `
-        # ],
-        # "etag": "BwWWja0YfJA=",
-        # "version": 3
-        # `
-        # **YAML example:**
-        # bindings:
-        # - members:
-        # - user:mike@example.com
-        # - group:admins@example.com
-        # - domain:google.com
-        # - serviceAccount:my-project-id@appspot.gserviceaccount.com
-        # role: roles/resourcemanager.organizationAdmin
-        # - members:
-        # - user:eve@example.com
-        # role: roles/resourcemanager.organizationViewer
-        # condition:
-        # title: expirable access
-        # description: Does not grant access after Sep 2020
-        # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
-        # - etag: BwWWja0YfJA=
-        # - version: 3
-        # For a description of IAM and its features, see the
-        # [IAM documentation](https://cloud.google.com/iam/docs/).
+        # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
+        # A `binding` binds one or more `members` to a single `role`. Members can be
+        # user accounts, service accounts, Google groups, and domains (such as G Suite).
+        # A `role` is a named list of permissions; each `role` can be an IAM predefined
+        # role or a user-created custom role. For some types of Google Cloud resources,
+        # a `binding` can also specify a `condition`, which is a logical expression that
+        # allows access to a resource only if the expression evaluates to `true`. A
+        # condition can add constraints based on attributes of the request, the resource,
+        # or both. To learn which resources support conditions in their IAM policies,
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
+        # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
+        # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
+        # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
+        # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
+        # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
+        # title": "expirable access", "description": "Does not grant access after Sep
+        # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
+        # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
+        # members: - user:mike@example.com - group:admins@example.com - domain:google.
+        # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
+        # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
+        # roles/resourcemanager.organizationViewer condition: title: expirable access
+        # description: Does not grant access after Sep 2020 expression: request.time <
+        # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a
+        # description of IAM and its features, see the [IAM documentation](https://cloud.
+        # google.com/iam/docs/).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::ServicemanagementV1::Policy]
         attr_accessor :policy
       
         # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
-        # the fields in the mask will be modified. If no mask is provided, the
-        # following default mask is used:
-        # `paths: "bindings, etag"`
+        # the fields in the mask will be modified. If no mask is provided, the following
+        # default mask is used: `paths: "bindings, etag"`
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask
@@ -4393,13 +3533,13 @@ module Google
         end
       end
       
-      # `SourceContext` represents information about the source of a
-      # protobuf element, like the file in which it is defined.
+      # `SourceContext` represents information about the source of a protobuf element,
+      # like the file in which it is defined.
       class SourceContext
         include Google::Apis::Core::Hashable
       
         # The path-qualified name of the .proto file that contained the associated
-        # protobuf element.  For example: `"google/protobuf/source_context.proto"`.
+        # protobuf element. For example: `"google/protobuf/source_context.proto"`.
         # Corresponds to the JSON property `fileName`
         # @return [String]
         attr_accessor :file_name
@@ -4433,12 +3573,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -4447,15 +3587,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -4507,9 +3647,9 @@ module Google
         # @return [Google::Apis::ServicemanagementV1::ConfigSource]
         attr_accessor :config_source
       
-        # Optional. If set, this will result in the generation of a
-        # `google.api.Service` configuration based on the `ConfigSource` provided,
-        # but the generated config and the sources will NOT be persisted.
+        # Optional. If set, this will result in the generation of a `google.api.Service`
+        # configuration based on the `ConfigSource` provided, but the generated config
+        # and the sources will NOT be persisted.
         # Corresponds to the JSON property `validateOnly`
         # @return [Boolean]
         attr_accessor :validate_only
@@ -4531,26 +3671,15 @@ module Google
         include Google::Apis::Core::Hashable
       
         # `Service` is the root object of Google service configuration schema. It
-        # describes basic information about a service, such as the name and the
-        # title, and delegates other aspects to sub-sections. Each sub-section is
-        # either a proto message or a repeated proto message that configures a
-        # specific aspect, such as auth. See each proto message definition for details.
-        # Example:
-        # type: google.api.Service
-        # config_version: 3
-        # name: calendar.googleapis.com
-        # title: Google Calendar API
-        # apis:
-        # - name: google.calendar.v3.Calendar
-        # authentication:
-        # providers:
-        # - id: google_calendar_auth
-        # jwks_uri: https://www.googleapis.com/oauth2/v1/certs
-        # issuer: https://securetoken.google.com
-        # rules:
-        # - selector: "*"
-        # requirements:
-        # provider_id: google_calendar_auth
+        # describes basic information about a service, such as the name and the title,
+        # and delegates other aspects to sub-sections. Each sub-section is either a
+        # proto message or a repeated proto message that configures a specific aspect,
+        # such as auth. See each proto message definition for details. Example: type:
+        # google.api.Service config_version: 3 name: calendar.googleapis.com title:
+        # Google Calendar API apis: - name: google.calendar.v3.Calendar authentication:
+        # providers: - id: google_calendar_auth jwks_uri: https://www.googleapis.com/
+        # oauth2/v1/certs issuer: https://securetoken.google.com rules: - selector: "*"
+        # requirements: provider_id: google_calendar_auth
         # Corresponds to the JSON property `serviceConfig`
         # @return [Google::Apis::ServicemanagementV1::Service]
         attr_accessor :service_config
@@ -4571,8 +3700,7 @@ module Google
       class SystemParameter
         include Google::Apis::Core::Hashable
       
-        # Define the HTTP header name to use for the parameter. It is case
-        # insensitive.
+        # Define the HTTP header name to use for the parameter. It is case insensitive.
         # Corresponds to the JSON property `httpHeader`
         # @return [String]
         attr_accessor :http_header
@@ -4600,23 +3728,20 @@ module Google
         end
       end
       
-      # Define a system parameter rule mapping system parameter definitions to
-      # methods.
+      # Define a system parameter rule mapping system parameter definitions to methods.
       class SystemParameterRule
         include Google::Apis::Core::Hashable
       
-        # Define parameters. Multiple names may be defined for a parameter.
-        # For a given method call, only one of them should be used. If multiple
-        # names are used the behavior is implementation-dependent.
-        # If none of the specified names are present the behavior is
-        # parameter-dependent.
+        # Define parameters. Multiple names may be defined for a parameter. For a given
+        # method call, only one of them should be used. If multiple names are used the
+        # behavior is implementation-dependent. If none of the specified names are
+        # present the behavior is parameter-dependent.
         # Corresponds to the JSON property `parameters`
         # @return [Array<Google::Apis::ServicemanagementV1::SystemParameter>]
         attr_accessor :parameters
       
         # Selects the methods to which this rule applies. Use '*' to indicate all
-        # methods in all APIs.
-        # Refer to selector for syntax details.
+        # methods in all APIs. Refer to selector for syntax details.
         # Corresponds to the JSON property `selector`
         # @return [String]
         attr_accessor :selector
@@ -4632,36 +3757,23 @@ module Google
         end
       end
       
-      # ### System parameter configuration
-      # A system parameter is a special kind of parameter defined by the API
-      # system, not by an individual API. It is typically mapped to an HTTP header
-      # and/or a URL query parameter. This configuration specifies which methods
-      # change the names of the system parameters.
+      # ### System parameter configuration A system parameter is a special kind of
+      # parameter defined by the API system, not by an individual API. It is typically
+      # mapped to an HTTP header and/or a URL query parameter. This configuration
+      # specifies which methods change the names of the system parameters.
       class SystemParameters
         include Google::Apis::Core::Hashable
       
-        # Define system parameters.
-        # The parameters defined here will override the default parameters
-        # implemented by the system. If this field is missing from the service
-        # config, default system parameters will be used. Default system parameters
-        # and names is implementation-dependent.
-        # Example: define api key for all methods
-        # system_parameters
-        # rules:
-        # - selector: "*"
-        # parameters:
-        # - name: api_key
-        # url_query_parameter: api_key
-        # Example: define 2 api key names for a specific method.
-        # system_parameters
-        # rules:
-        # - selector: "/ListShelves"
-        # parameters:
-        # - name: api_key
-        # http_header: Api-Key1
-        # - name: api_key
-        # http_header: Api-Key2
-        # **NOTE:** All service configuration rules follow "last one wins" order.
+        # Define system parameters. The parameters defined here will override the
+        # default parameters implemented by the system. If this field is missing from
+        # the service config, default system parameters will be used. Default system
+        # parameters and names is implementation-dependent. Example: define api key for
+        # all methods system_parameters rules: - selector: "*" parameters: - name:
+        # api_key url_query_parameter: api_key Example: define 2 api key names for a
+        # specific method. system_parameters rules: - selector: "/ListShelves"
+        # parameters: - name: api_key http_header: Api-Key1 - name: api_key http_header:
+        # Api-Key2 **NOTE:** All service configuration rules follow "last one wins"
+        # order.
         # Corresponds to the JSON property `rules`
         # @return [Array<Google::Apis::ServicemanagementV1::SystemParameterRule>]
         attr_accessor :rules
@@ -4680,10 +3792,9 @@ module Google
       class TestIamPermissionsRequest
         include Google::Apis::Core::Hashable
       
-        # The set of permissions to check for the `resource`. Permissions with
-        # wildcards (such as '*' or 'storage.*') are not allowed. For more
-        # information see
-        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+        # The set of permissions to check for the `resource`. Permissions with wildcards
+        # (such as '*' or 'storage.*') are not allowed. For more information see [IAM
+        # Overview](https://cloud.google.com/iam/docs/overview#permissions).
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -4702,8 +3813,7 @@ module Google
       class TestIamPermissionsResponse
         include Google::Apis::Core::Hashable
       
-        # A subset of `TestPermissionsRequest.permissions` that the caller is
-        # allowed.
+        # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -4718,38 +3828,21 @@ module Google
         end
       end
       
-      # Strategy that specifies how clients of Google Service Controller want to
-      # send traffic to use different config versions. This is generally
-      # used by API proxy to split traffic based on your configured percentage for
-      # each config version.
-      # One example of how to gradually rollout a new service configuration using
-      # this
-      # strategy:
-      # Day 1
-      # Rollout `
-      # id: "example.googleapis.com/rollout_20160206"
-      # traffic_percent_strategy `
-      # percentages: `
-      # "example.googleapis.com/20160201": 70.00
-      # "example.googleapis.com/20160206": 30.00
-      # `
-      # `
-      # `
-      # Day 2
-      # Rollout `
-      # id: "example.googleapis.com/rollout_20160207"
-      # traffic_percent_strategy: `
-      # percentages: `
-      # "example.googleapis.com/20160206": 100.00
-      # `
-      # `
-      # `
+      # Strategy that specifies how clients of Google Service Controller want to send
+      # traffic to use different config versions. This is generally used by API proxy
+      # to split traffic based on your configured percentage for each config version.
+      # One example of how to gradually rollout a new service configuration using this
+      # strategy: Day 1 Rollout ` id: "example.googleapis.com/rollout_20160206"
+      # traffic_percent_strategy ` percentages: ` "example.googleapis.com/20160201":
+      # 70.00 "example.googleapis.com/20160206": 30.00 ` ` ` Day 2 Rollout ` id: "
+      # example.googleapis.com/rollout_20160207" traffic_percent_strategy: `
+      # percentages: ` "example.googleapis.com/20160206": 100.00 ` ` `
       class TrafficPercentStrategy
         include Google::Apis::Core::Hashable
       
-        # Maps service configuration IDs to their corresponding traffic percentage.
-        # Key is the service configuration ID, Value is the traffic percentage
-        # which must be greater than 0.0 and the sum must equal to 100.0.
+        # Maps service configuration IDs to their corresponding traffic percentage. Key
+        # is the service configuration ID, Value is the traffic percentage which must be
+        # greater than 0.0 and the sum must equal to 100.0.
         # Corresponds to the JSON property `percentages`
         # @return [Hash<String,Float>]
         attr_accessor :percentages
@@ -4788,8 +3881,8 @@ module Google
         # @return [Array<Google::Apis::ServicemanagementV1::Option>]
         attr_accessor :options
       
-        # `SourceContext` represents information about the source of a
-        # protobuf element, like the file in which it is defined.
+        # `SourceContext` represents information about the source of a protobuf element,
+        # like the file in which it is defined.
         # Corresponds to the JSON property `sourceContext`
         # @return [Google::Apis::ServicemanagementV1::SourceContext]
         attr_accessor :source_context
@@ -4818,8 +3911,8 @@ module Google
       class UndeleteServiceResponse
         include Google::Apis::Core::Hashable
       
-        # The full representation of a Service that is managed by
-        # Google Service Management.
+        # The full representation of a Service that is managed by Google Service
+        # Management.
         # Corresponds to the JSON property `service`
         # @return [Google::Apis::ServicemanagementV1::ManagedService]
         attr_accessor :service
@@ -4839,41 +3932,28 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The full resource name of a channel used for sending notifications to the
-        # service producer.
-        # Google Service Management currently only supports
-        # [Google Cloud Pub/Sub](https://cloud.google.com/pubsub) as a notification
-        # channel. To use Google Cloud Pub/Sub as the channel, this must be the name
-        # of a Cloud Pub/Sub topic that uses the Cloud Pub/Sub topic name format
-        # documented in https://cloud.google.com/pubsub/docs/overview.
+        # service producer. Google Service Management currently only supports [Google
+        # Cloud Pub/Sub](https://cloud.google.com/pubsub) as a notification channel. To
+        # use Google Cloud Pub/Sub as the channel, this must be the name of a Cloud Pub/
+        # Sub topic that uses the Cloud Pub/Sub topic name format documented in https://
+        # cloud.google.com/pubsub/docs/overview.
         # Corresponds to the JSON property `producerNotificationChannel`
         # @return [String]
         attr_accessor :producer_notification_channel
       
         # 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'.
+        # service. Each requirement is of the form /; for example 'serviceusage.
+        # googleapis.com/billing-enabled'.
         # Corresponds to the JSON property `requirements`
         # @return [Array<String>]
         attr_accessor :requirements
       
-        # A list of usage rules that apply to individual API methods.
-        # **NOTE:** All service configuration rules follow "last one wins" order.
+        # A list of usage rules that apply to individual API methods. **NOTE:** All
+        # service configuration rules follow "last one wins" order.
         # Corresponds to the JSON property `rules`
         # @return [Array<Google::Apis::ServicemanagementV1::UsageRule>]
         attr_accessor :rules
       
-        # The per-product per-project service identity for a service.
-        # Use this field to configure per-product per-project service identity.
-        # Example of a service identity configuration.
-        # usage:
-        # service_identity:
-        # - service_account_parent: "projects/123456789"
-        # display_name: "Cloud XXX Service Agent"
-        # description: "Used as the identity of Cloud XXX to access resources"
-        # Corresponds to the JSON property `serviceIdentity`
-        # @return [Google::Apis::ServicemanagementV1::ServiceIdentity]
-        attr_accessor :service_identity
-      
         def initialize(**args)
            update!(**args)
         end
@@ -4883,49 +3963,39 @@ module Google
           @producer_notification_channel = args[:producer_notification_channel] if args.key?(:producer_notification_channel)
           @requirements = args[:requirements] if args.key?(:requirements)
           @rules = args[:rules] if args.key?(:rules)
-          @service_identity = args[:service_identity] if args.key?(:service_identity)
         end
       end
       
-      # Usage configuration rules for the service.
-      # NOTE: Under development.
-      # Use this rule to configure unregistered calls for the service. Unregistered
-      # calls are calls that do not contain consumer project identity.
-      # (Example: calls that do not contain an API key).
-      # By default, API methods do not allow unregistered calls, and each method call
-      # must be identified by a consumer project identity. Use this rule to
-      # allow/disallow unregistered calls.
-      # Example of an API that wants to allow unregistered calls for entire service.
-      # usage:
-      # rules:
-      # - selector: "*"
-      # allow_unregistered_calls: true
-      # Example of a method that wants to allow unregistered calls.
-      # usage:
-      # rules:
-      # - selector: "google.example.library.v1.LibraryService.CreateBook"
-      # allow_unregistered_calls: true
+      # Usage configuration rules for the service. NOTE: Under development. Use this
+      # rule to configure unregistered calls for the service. Unregistered calls are
+      # calls that do not contain consumer project identity. (Example: calls that do
+      # not contain an API key). By default, API methods do not allow unregistered
+      # calls, and each method call must be identified by a consumer project identity.
+      # Use this rule to allow/disallow unregistered calls. Example of an API that
+      # wants to allow unregistered calls for entire service. usage: rules: - selector:
+      # "*" allow_unregistered_calls: true Example of a method that wants to allow
+      # unregistered calls. usage: rules: - selector: "google.example.library.v1.
+      # LibraryService.CreateBook" allow_unregistered_calls: true
       class UsageRule
         include Google::Apis::Core::Hashable
       
-        # If true, the selected method allows unregistered calls, e.g. calls
-        # that don't identify any user or application.
+        # If true, the selected method allows unregistered calls, e.g. calls that don't
+        # identify any user or application.
         # Corresponds to the JSON property `allowUnregisteredCalls`
         # @return [Boolean]
         attr_accessor :allow_unregistered_calls
         alias_method :allow_unregistered_calls?, :allow_unregistered_calls
       
         # Selects the methods to which this rule applies. Use '*' to indicate all
-        # methods in all APIs.
-        # Refer to selector for syntax details.
+        # methods in all APIs. Refer to selector for syntax details.
         # Corresponds to the JSON property `selector`
         # @return [String]
         attr_accessor :selector
       
-        # If true, the selected method should skip service control and the control
-        # plane features, such as quota and billing, will not be available.
-        # This flag is used by Google Cloud Endpoints to bypass checks for internal
-        # methods, such as service health check methods.
+        # If true, the selected method should skip service control and the control plane
+        # features, such as quota and billing, will not be available. This flag is used
+        # by Google Cloud Endpoints to bypass checks for internal methods, such as
+        # service health check methods.
         # Corresponds to the JSON property `skipServiceControl`
         # @return [Boolean]
         attr_accessor :skip_service_control