google-api-client 0.41.1 → 0.43.0

data/generated/google/apis/servicemanagement_v1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/service-management/
     module ServicemanagementV1
       VERSION = 'V1'
-      REVISION = '20200619'
+      REVISION = '20200727'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -2566,8 +2566,8 @@ module Google
       # existing data unusable.
       # The following are specific rules for service defined Monitoring metric
       # descriptors:
-      # * `type`, `metric_kind`, `value_type`, `description`, `display_name`,
-      # `launch_stage` fields are all required. The `unit` field must be specified
+      # * `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.
@@ -3652,6 +3652,54 @@ module Google
         end
       end
       
+      # 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"
+        # `;
+        # `
+        # 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: "*"
+        # `];
+        # `
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @child_type = args[:child_type] if args.key?(:child_type)
+          @type = args[:type] if args.key?(:type)
+        end
+      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.

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

@@ -442,6 +442,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ResourceReference
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Rollout
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1253,6 +1259,14 @@ module Google
         end
       end
       
+      class ResourceReference
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :child_type, as: 'childType'
+          property :type, as: 'type'
+        end
+      end
+      
       class Rollout
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/servicenetworking_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started
     module ServicenetworkingV1
       VERSION = 'V1'
-      REVISION = '20200615'
+      REVISION = '20200801'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -42,9 +42,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The network that the consumer is using to connect with services.
-        # Must be in the form of projects/`project`/global/networks/`network`
-        # `project` is the project number, as in '12345'
-        # `network` is the network name.
+        # Must be in the form of projects/`project`/global/networks/`network` `project`
+        # is the project number, as in '12345' `network` is the network name.
         # Corresponds to the JSON property `consumerNetwork`
         # @return [String]
         attr_accessor :consumer_network
@@ -55,8 +54,7 @@ module Google
         attr_accessor :dns_record_set
       
         # Required. The name of the private DNS zone in the shared producer host project
-        # to
-        # which the record set will be added.
+        # to which the record set will be added.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -93,9 +91,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The network that the consumer is using to connect with services.
-        # Must be in the form of projects/`project`/global/networks/`network`
-        # `project` is the project number, as in '12345'
-        # `network` is the network name.
+        # Must be in the form of projects/`project`/global/networks/`network` `project`
+        # is the project number, as in '12345' `network` is the network name.
         # Corresponds to the JSON property `consumerNetwork`
         # @return [String]
         attr_accessor :consumer_network
@@ -106,9 +103,8 @@ module Google
         attr_accessor :dns_suffix
       
         # Required. The name for both the private zone in the shared producer host
-        # project and
-        # the peering zone in the consumer project. Must be unique within both
-        # projects. The name must be 1-63 characters long, must begin with a letter,
+        # project and the peering zone in the consumer project. Must be unique within
+        # both projects. The name must be 1-63 characters long, must begin with a letter,
         # end with a letter or digit, and only contain lowercase letters, digits or
         # dashes.
         # Corresponds to the JSON property `name`
@@ -167,16 +163,14 @@ module Google
         end
       end
       
-      # Request for AddRoles to allow Service Producers to add roles in the shared
-      # VPC host project for them to use.
+      # Request for AddRoles to allow Service Producers to add roles in the shared VPC
+      # host project for them to use.
       class AddRolesRequest
         include Google::Apis::Core::Hashable
       
         # Required. The network that the consumer is using to connect with services.
-        # Must be in
-        # the form of projects/`project`/global/networks/`network`
-        # `project` is a project number, as in '12345'
-        # `network` is a network name.
+        # Must be in the form of projects/`project`/global/networks/`network` `project`
+        # is a project number, as in '12345' `network` is a network name.
         # Corresponds to the JSON property `consumerNetwork`
         # @return [String]
         attr_accessor :consumer_network
@@ -221,21 +215,20 @@ module Google
       class AddSubnetworkRequest
         include Google::Apis::Core::Hashable
       
-        # Required. A resource that represents the service consumer, such as
-        # `projects/123456`. The project number can be different from the
-        # value in the consumer network parameter. For example, the network might be
-        # part of a Shared VPC network. In those cases, Service Networking validates
-        # that this resource belongs to that Shared VPC.
+        # Required. A resource that represents the service consumer, such as `projects/
+        # 123456`. The project number can be different from the value in the consumer
+        # network parameter. For example, the network might be part of a Shared VPC
+        # network. In those cases, Service Networking validates that this resource
+        # belongs to that Shared VPC.
         # Corresponds to the JSON property `consumer`
         # @return [String]
         attr_accessor :consumer
       
-        # Required. The name of the service consumer's VPC network. The network
-        # must have an existing private connection that was provisioned through the
-        # connections.create method. The name must be in the following format:
-        # `projects/`project`/global/networks/`network``, where `project`
-        # is a project number, such as `12345`. `network` is the name of a
-        # VPC network in the project.
+        # Required. The name of the service consumer's VPC network. The network must
+        # have an existing private connection that was provisioned through the
+        # connections.create method. The name must be in the following format: `projects/
+        # `project`/global/networks/`network``, where `project` is a project number,
+        # such as `12345`. `network` is the name of a VPC network in the project.
         # Corresponds to the JSON property `consumerNetwork`
         # @return [String]
         attr_accessor :consumer_network
@@ -245,46 +238,46 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # Required. The prefix length of the subnet's IP address range.  Use CIDR
-        # range notation, such as `30` to provision a subnet with an
-        # `x.x.x.x/30` CIDR range. The IP address range is drawn from a
-        # pool of available ranges in the service consumer's allocated range.
+        # Required. The prefix length of the subnet's IP address range. Use CIDR range
+        # notation, such as `30` to provision a subnet with an `x.x.x.x/30` CIDR range.
+        # The IP address range is drawn from a pool of available ranges in the service
+        # consumer's allocated range.
         # Corresponds to the JSON property `ipPrefixLength`
         # @return [Fixnum]
         attr_accessor :ip_prefix_length
       
-        # Optional. The private IPv6 google access type for the VMs in this subnet.
-        # For information about the access types that can be set using this field,
-        # see [subnetwork](/compute/docs/reference/rest/v1/subnetworks)
-        # in the Compute API documentation.
+        # Optional. The private IPv6 google access type for the VMs in this subnet. For
+        # information about the access types that can be set using this field, see [
+        # subnetwork](/compute/docs/reference/rest/v1/subnetworks) in the Compute API
+        # documentation.
         # Corresponds to the JSON property `privateIpv6GoogleAccess`
         # @return [String]
         attr_accessor :private_ipv6_google_access
       
-        # Required. The name of a [region](/compute/docs/regions-zones)
-        # for the subnet, such `europe-west1`.
+        # Required. The name of a [region](/compute/docs/regions-zones) for the subnet,
+        # such `europe-west1`.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
       
-        # Optional. The starting address of a range. The address must be a valid
-        # IPv4 address in the x.x.x.x format. This value combined with the IP prefix
-        # range is the CIDR range for the subnet. The range must be within the
-        # allocated range that is assigned to the private connection. If the CIDR
-        # range isn't available, the call fails.
+        # Optional. The starting address of a range. The address must be a valid IPv4
+        # address in the x.x.x.x format. This value combined with the IP prefix range is
+        # the CIDR range for the subnet. The range must be within the allocated range
+        # that is assigned to the private connection. If the CIDR range isn't available,
+        # the call fails.
         # Corresponds to the JSON property `requestedAddress`
         # @return [String]
         attr_accessor :requested_address
       
         # Required. A name for the new subnet. For information about the naming
-        # requirements, see [subnetwork](/compute/docs/reference/rest/v1/subnetworks)
-        # in the Compute API documentation.
+        # requirements, see [subnetwork](/compute/docs/reference/rest/v1/subnetworks) in
+        # the Compute API documentation.
         # Corresponds to the JSON property `subnetwork`
         # @return [String]
         attr_accessor :subnetwork
       
-        # A list of members that are granted the `compute.networkUser`
-        # role on the subnet.
+        # A list of members that are granted the `compute.networkUser` role on the
+        # subnet.
         # Corresponds to the JSON property `subnetworkUsers`
         # @return [Array<String>]
         attr_accessor :subnetwork_users
@@ -307,14 +300,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
       
@@ -328,8 +320,8 @@ module Google
         # @return [Array<Google::Apis::ServicenetworkingV1::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
@@ -339,8 +331,8 @@ module Google
         # @return [Array<Google::Apis::ServicenetworkingV1::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::ServicenetworkingV1::SourceContext]
         attr_accessor :source_context
@@ -350,23 +342,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
@@ -387,85 +375,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::ServicenetworkingV1::JwtLocation>]
         attr_accessor :jwt_locations
@@ -485,34 +451,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
@@ -528,18 +486,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
       
@@ -548,8 +499,8 @@ module Google
         # @return [Array<Google::Apis::ServicenetworkingV1::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::ServicenetworkingV1::AuthenticationRule>]
         attr_accessor :rules
@@ -565,13 +516,11 @@ 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
       
@@ -582,19 +531,18 @@ module Google
         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::ServicenetworkingV1::OAuthRequirements]
         attr_accessor :oauth
@@ -604,8 +552,8 @@ module Google
         # @return [Array<Google::Apis::ServicenetworkingV1::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
@@ -627,8 +575,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::ServicenetworkingV1::BackendRule>]
         attr_accessor :rules
@@ -647,21 +595,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
@@ -672,18 +612,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
@@ -694,8 +634,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
@@ -705,29 +645,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
@@ -750,42 +682,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::ServicenetworkingV1::BillingDestination>]
         attr_accessor :consumer_destinations
@@ -800,19 +718,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
@@ -848,37 +766,33 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The name of service consumer's VPC network that's connected with service
-        # producer network, in the following format:
-        # `projects/`project`/global/networks/`network``.
-        # ``project`` is a project number, such as in `12345` that includes
-        # the VPC service consumer's VPC network. ``network`` is the name of the
-        # service consumer's VPC network.
+        # producer network, in the following format: `projects/`project`/global/networks/
+        # `network``. ``project`` is a project number, such as in `12345` that includes
+        # the VPC service consumer's VPC network. ``network`` is the name of the service
+        # consumer's VPC network.
         # Corresponds to the JSON property `network`
         # @return [String]
         attr_accessor :network
       
         # Output only. The name of the VPC Network Peering connection that was created
-        # by the
-        # service producer.
+        # by the service producer.
         # Corresponds to the JSON property `peering`
         # @return [String]
         attr_accessor :peering
       
-        # The name of one or more allocated IP address ranges for this service
-        # producer of type `PEERING`.
-        # Note that invoking CreateConnection method with a different range when
-        # connection is already established will not modify already provisioned
-        # service producer subnetworks.
-        # If CreateConnection method is invoked repeatedly to reconnect when peering
-        # connection had been disconnected on the consumer side, leaving this field
-        # empty will restore previously allocated IP ranges.
+        # The name of one or more allocated IP address ranges for this service producer
+        # of type `PEERING`. Note that invoking CreateConnection method with a different
+        # range when connection is already established will not modify already
+        # provisioned service producer subnetworks. If CreateConnection method is
+        # invoked repeatedly to reconnect when peering connection had been disconnected
+        # on the consumer side, leaving this field empty will restore previously
+        # allocated IP ranges.
         # Corresponds to the JSON property `reservedPeeringRanges`
         # @return [Array<String>]
         attr_accessor :reserved_peering_ranges
       
         # Output only. The name of the peering service that's associated with this
-        # connection, in
-        # the following format: `services/`service name``.
+        # connection, in the following format: `services/`service name``.
         # Corresponds to the JSON property `service`
         # @return [String]
         attr_accessor :service
@@ -901,9 +815,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. Project number of the consumer that is launching the service
-        # instance. It
-        # can own the network that is peered with Google or, be a service project in
-        # an XPN where the host project has the network.
+        # instance. It can own the network that is peered with Google or, be a service
+        # project in an XPN where the host project has the network.
         # Corresponds to the JSON property `projectNum`
         # @return [Fixnum]
         attr_accessor :project_num
@@ -918,39 +831,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 whitelist 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::ServicenetworkingV1::ContextRule>]
         attr_accessor :rules
@@ -970,14 +868,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
@@ -992,8 +890,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
@@ -1012,14 +910,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
@@ -1034,19 +932,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::ServicenetworkingV1::CustomErrorRule>]
         attr_accessor :rules
@@ -1071,15 +965,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
@@ -1125,9 +1019,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The network that the consumer is using to connect with services.
-        # Must be in the form of projects/`project`/global/networks/`network`
-        # `project` is a project number, as in '12345'
-        # `network` is network name.
+        # Must be in the form of projects/`project`/global/networks/`network` `project`
+        # is a project number, as in '12345' `network` is network name.
         # Corresponds to the JSON property `consumerNetwork`
         # @return [String]
         attr_accessor :consumer_network
@@ -1190,9 +1083,9 @@ module Google
         # @return [String]
         attr_accessor :dns_suffix
       
-        # User assigned name for this resource. Must be unique within the project.
-        # The name must be 1-63 characters long, must begin with a letter, end with
-        # a letter or digit, and only contain lowercase letters, digits or dashes.
+        # User assigned name for this resource. Must be unique within the project. The
+        # name must be 1-63 characters long, must begin with a letter, end with a letter
+        # or digit, and only contain lowercase letters, digits or dashes.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1208,56 +1101,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
       
@@ -1266,19 +1135,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
@@ -1288,22 +1149,20 @@ module Google
         # @return [Array<Google::Apis::ServicenetworkingV1::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::ServicenetworkingV1::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
@@ -1327,8 +1186,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
@@ -1360,13 +1219,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      # service Foo `
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # A generic empty message that you can re-use to avoid defining duplicated empty
+      # messages in your APIs. A typical example is to use it as the request or the
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -1384,9 +1241,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The network that the consumer is using to connect with services.
-        # Must be in the form of projects/`project`/global/networks/`network`
-        # `project` is a project number, as in '12345'
-        # `network` is network name.
+        # Must be in the form of projects/`project`/global/networks/`network` `project`
+        # is a project number, as in '12345' `network` is network name.
         # Corresponds to the JSON property `consumerNetwork`
         # @return [String]
         attr_accessor :consumer_network
@@ -1401,35 +1257,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`
@@ -1443,10 +1292,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
@@ -1483,8 +1331,8 @@ module Google
         # @return [Array<Google::Apis::ServicenetworkingV1::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::ServicenetworkingV1::SourceContext]
         attr_accessor :source_context
@@ -1573,8 +1421,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
@@ -1590,8 +1438,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
@@ -1625,21 +1473,19 @@ module Google
         # @return [String]
         attr_accessor :ip_cidr_range
       
-        # Subnetwork name.
-        # See https://cloud.google.com/compute/docs/vpc/
+        # Subnetwork name. See https://cloud.google.com/compute/docs/vpc/
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
         # In the Shared VPC host project, the VPC network that's peered with the
-        # consumer network. For example:
-        # `projects/1234321/global/networks/host-network`
+        # consumer network. For example: `projects/1234321/global/networks/host-network`
         # Corresponds to the JSON property `network`
         # @return [String]
         attr_accessor :network
       
-        # This is a discovered subnet that is not within the current consumer
-        # allocated ranges.
+        # This is a discovered subnet that is not within the current consumer allocated
+        # ranges.
         # Corresponds to the JSON property `outsideAllocation`
         # @return [Boolean]
         attr_accessor :outside_allocation
@@ -1659,23 +1505,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::ServicenetworkingV1::HttpRule>]
         attr_accessor :rules
@@ -1691,251 +1536,156 @@ 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::ServicenetworkingV1::HttpRule>]
         attr_accessor :additional_bindings
       
-        # When this flag is set to true, HTTP requests will be allowed to invoke a
-        # half-duplex streaming method.
+        # 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
@@ -1950,8 +1700,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
@@ -1972,16 +1721,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
@@ -2020,13 +1768,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
@@ -2074,8 +1821,8 @@ module Google
         end
       end
       
-      # ListConnectionsResponse is the response to list peering states for the
-      # given service and consumer project.
+      # ListConnectionsResponse is the response to list peering states for the given
+      # service and consumer project.
       class ListConnectionsResponse
         include Google::Apis::Core::Hashable
       
@@ -2119,39 +1866,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::ServicenetworkingV1::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
@@ -2169,48 +1912,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::ServicenetworkingV1::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::ServicenetworkingV1::LoggingDestination>]
         attr_accessor :producer_destinations
@@ -2226,21 +1951,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
@@ -2315,16 +2039,13 @@ 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`, `description`, `display_name`,
-      # `launch_stage` 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
+      # 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
       
@@ -2333,26 +2054,21 @@ 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
-        # for responses that failed.
+        # 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 for responses that failed.
         # Corresponds to the JSON property `labels`
         # @return [Array<Google::Apis::ServicenetworkingV1::LabelDescriptor>]
         attr_accessor :labels
@@ -2367,17 +2083,16 @@ module Google
         # @return [Google::Apis::ServicenetworkingV1::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
@@ -2387,116 +2102,73 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The metric type, including its DNS name prefix. The type is not
-        # URL-encoded.
+        # 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:
+        # 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"
+        # 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"
         # 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
@@ -2525,9 +2197,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
@@ -2539,8 +2211,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
@@ -2557,22 +2229,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
@@ -2590,66 +2261,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 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"; ` ... `
       class Mixin
         include Google::Apis::Core::Hashable
       
@@ -2658,8 +2296,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
@@ -2675,51 +2312,42 @@ 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 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
       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. 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`.
         # Corresponds to the JSON property `labels`
         # @return [Array<Google::Apis::ServicenetworkingV1::LabelDescriptor>]
         attr_accessor :labels
@@ -2729,27 +2357,25 @@ 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. 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.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -2769,75 +2395,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::ServicenetworkingV1::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::ServicenetworkingV1::MonitoringDestination>]
         attr_accessor :producer_destinations
@@ -2853,19 +2451,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
@@ -2882,27 +2480,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
@@ -2922,47 +2518,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::ServicenetworkingV1::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
@@ -2987,17 +2581,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
@@ -3018,32 +2612,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::ServicenetworkingV1::Page>]
         attr_accessor :subpages
@@ -3064,20 +2651,17 @@ module Google
       class PolicyBinding
         include Google::Apis::Core::Hashable
       
-        # Required. Member to bind the role with. See
-        # /iam/docs/reference/rest/v1/Policy#Binding for how to format each member.
-        # Eg.
-        # - user:myuser@mydomain.com
-        # - serviceAccount:my-service-account@app.gserviceaccount.com
+        # Required. Member to bind the role with. See /iam/docs/reference/rest/v1/Policy#
+        # Binding for how to format each member. Eg. - user:myuser@mydomain.com -
+        # serviceAccount:my-service-account@app.gserviceaccount.com
         # Corresponds to the JSON property `member`
         # @return [String]
         attr_accessor :member
       
         # Required. Role to apply. Only whitelisted roles can be used at the specified
-        # granularity. The role must be one of the following:
-        # - 'roles/container.hostServiceAgentUser' applied on the shared VPC host
-        # project
-        # - 'roles/compute.securityAdmin' applied on the shared VPC host project
+        # granularity. The role must be one of the following: - 'roles/container.
+        # hostServiceAgentUser' applied on the shared VPC host project - 'roles/compute.
+        # securityAdmin' applied on the shared VPC host project
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -3093,46 +2677,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
       
@@ -3141,8 +2704,8 @@ module Google
         # @return [Array<Google::Apis::ServicenetworkingV1::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::ServicenetworkingV1::MetricRule>]
         attr_accessor :metric_rules
@@ -3159,95 +2722,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
@@ -3275,15 +2832,14 @@ module Google
       class Range
         include Google::Apis::Core::Hashable
       
-        # CIDR range in "10.x.x.x/y" format that is within the
-        # allocated ranges and currently unused.
+        # CIDR range in "10.x.x.x/y" format that is within the allocated ranges and
+        # currently unused.
         # Corresponds to the JSON property `ipCidrRange`
         # @return [String]
         attr_accessor :ip_cidr_range
       
         # In the Shared VPC host project, the VPC network that's peered with the
-        # consumer network. For example:
-        # `projects/1234321/global/networks/host-network`
+        # consumer network. For example: `projects/1234321/global/networks/host-network`
         # Corresponds to the JSON property `network`
         # @return [String]
         attr_accessor :network
@@ -3304,19 +2860,17 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The size of the desired subnet. Use usual CIDR range notation. For
-        # example,
-        # '30' to find unused x.x.x.x/30 CIDR range. The goal is to determine if one
-        # of the allocated ranges has enough free space for a subnet of the requested
-        # size.
+        # example, '30' to find unused x.x.x.x/30 CIDR range. The goal is to determine
+        # if one of the allocated ranges has enough free space for a subnet of the
+        # requested size.
         # Corresponds to the JSON property `ipPrefixLength`
         # @return [Fixnum]
         attr_accessor :ip_prefix_length
       
-        # Optional. DO NOT USE - Under development.
-        # The size of the desired secondary ranges for the subnet. Use usual CIDR
-        # range notation. For example, '30' to find unused x.x.x.x/30 CIDR range. The
-        # goal is to determine that the allocated ranges have enough free space for
-        # all the requested secondary ranges.
+        # Optional. DO NOT USE - Under development. The size of the desired secondary
+        # ranges for the subnet. Use usual CIDR range notation. For example, '30' to
+        # find unused x.x.x.x/30 CIDR range. The goal is to determine that the allocated
+        # ranges have enough free space for all the requested secondary ranges.
         # Corresponds to the JSON property `secondaryRangeIpPrefixLengths`
         # @return [Array<Fixnum>]
         attr_accessor :secondary_range_ip_prefix_lengths
@@ -3353,9 +2907,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The network that the consumer is using to connect with services.
-        # Must be in the form of projects/`project`/global/networks/`network`
-        # `project` is the project number, as in '12345'
-        # `network` is the network name.
+        # Must be in the form of projects/`project`/global/networks/`network` `project`
+        # is the project number, as in '12345' `network` is the network name.
         # Corresponds to the JSON property `consumerNetwork`
         # @return [String]
         attr_accessor :consumer_network
@@ -3366,8 +2919,7 @@ module Google
         attr_accessor :dns_record_set
       
         # Required. The name of the private DNS zone in the shared producer host project
-        # from
-        # which the record set will be removed.
+        # from which the record set will be removed.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -3417,16 +2969,14 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The network that the consumer is using to connect with services.
-        # Must be in the form of projects/`project`/global/networks/`network`
-        # `project` is the project number, as in '12345'
-        # `network` is the network name.
+        # Must be in the form of projects/`project`/global/networks/`network` `project`
+        # is the project number, as in '12345' `network` is the network name.
         # Corresponds to the JSON property `consumerNetwork`
         # @return [String]
         attr_accessor :consumer_network
       
         # Required. The name for both the private zone in the shared producer host
-        # project and
-        # the peering zone in the consumer project.
+        # project and the peering zone in the consumer project.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -3471,15 +3021,15 @@ module Google
         attr_accessor :name
       
         # Fully-qualified URL of the VPC network in the producer host tenant project
-        # that this route applies to. For example:
-        # `projects/123456/global/networks/host-network`
+        # that this route applies to. For example: `projects/123456/global/networks/host-
+        # network`
         # Corresponds to the JSON property `network`
         # @return [String]
         attr_accessor :network
       
         # Fully-qualified URL of the gateway that should handle matching packets that
-        # this route applies to. For example:
-        # `projects/123456/global/gateways/default-internet-gateway`
+        # this route applies to. For example: `projects/123456/global/gateways/default-
+        # internet-gateway`
         # Corresponds to the JSON property `nextHopGateway`
         # @return [String]
         attr_accessor :next_hop_gateway
@@ -3502,18 +3052,17 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The prefix length of the IP range. Use usual CIDR range notation.
-        # For
-        # example, '30' to find unused x.x.x.x/30 CIDR range. Actual range will be
-        # determined using allocated range for the consumer peered network and
-        # returned in the result.
+        # For example, '30' to find unused x.x.x.x/30 CIDR range. Actual range will be
+        # determined using allocated range for the consumer peered network and returned
+        # in the result.
         # Corresponds to the JSON property `ipPrefixLength`
         # @return [Fixnum]
         attr_accessor :ip_prefix_length
       
-        # Network name in the consumer project. This network must have been
-        # already peered with a shared VPC network using CreateConnection
-        # method. Must be in a form 'projects/`project`/global/networks/`network`'.
-        # `project` is a project number, as in '12345' `network` is network name.
+        # Network name in the consumer project. This network must have been already
+        # peered with a shared VPC network using CreateConnection method. Must be in a
+        # form 'projects/`project`/global/networks/`network`'. `project` is a project
+        # number, as in '12345' `network` is network name.
         # Corresponds to the JSON property `network`
         # @return [String]
         attr_accessor :network
@@ -3530,50 +3079,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::ServicenetworkingV1::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::ServicenetworkingV1::Authentication]
         attr_accessor :authentication
@@ -3583,211 +3114,136 @@ module Google
         # @return [Google::Apis::ServicenetworkingV1::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::ServicenetworkingV1::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`.
+        # 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`.
         # 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 whitelist 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::ServicenetworkingV1::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::ServicenetworkingV1::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::ServicenetworkingV1::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::ServicenetworkingV1::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::ServicenetworkingV1::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::ServicenetworkingV1::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::ServicenetworkingV1::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::ServicenetworkingV1::Logging]
         attr_accessor :logging
@@ -3802,70 +3258,41 @@ module Google
         # @return [Array<Google::Apis::ServicenetworkingV1::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::ServicenetworkingV1::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::ServicenetworkingV1::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
@@ -3875,46 +3302,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::ServicenetworkingV1::Quota]
         attr_accessor :quota
@@ -3924,20 +3330,18 @@ module Google
         # @return [Google::Apis::ServicenetworkingV1::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::ServicenetworkingV1::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::ServicenetworkingV1::Type>]
         attr_accessor :system_types
@@ -3947,12 +3351,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::ServicenetworkingV1::Type>]
@@ -3999,32 +3401,28 @@ 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"
+      # 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.
+        # 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.
+        # 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`
+        # 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
@@ -4041,13 +3439,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
@@ -4081,12 +3479,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
       
@@ -4095,15 +3493,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
@@ -4130,21 +3528,19 @@ module Google
         # @return [String]
         attr_accessor :ip_cidr_range
       
-        # Subnetwork name.
-        # See https://cloud.google.com/compute/docs/vpc/
+        # Subnetwork name. See https://cloud.google.com/compute/docs/vpc/
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
         # In the Shared VPC host project, the VPC network that's peered with the
-        # consumer network. For example:
-        # `projects/1234321/global/networks/host-network`
+        # consumer network. For example: `projects/1234321/global/networks/host-network`
         # Corresponds to the JSON property `network`
         # @return [String]
         attr_accessor :network
       
-        # This is a discovered subnet that is not within the current consumer
-        # allocated ranges.
+        # This is a discovered subnet that is not within the current consumer allocated
+        # ranges.
         # Corresponds to the JSON property `outsideAllocation`
         # @return [Boolean]
         attr_accessor :outside_allocation
@@ -4169,8 +3565,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
@@ -4198,23 +3593,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::ServicenetworkingV1::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
@@ -4230,36 +3622,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::ServicenetworkingV1::SystemParameterRule>]
         attr_accessor :rules
@@ -4298,8 +3677,8 @@ module Google
         # @return [Array<Google::Apis::ServicenetworkingV1::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::ServicenetworkingV1::SourceContext]
         attr_accessor :source_context
@@ -4340,15 +3719,13 @@ module Google
       
       # Request to update a record set from a private managed DNS zone in the shared
       # producer host project. The name, type, ttl, and data values of the existing
-      # record set must all exactly match an existing record set in the specified
-      # zone.
+      # record set must all exactly match an existing record set in the specified zone.
       class UpdateDnsRecordSetRequest
         include Google::Apis::Core::Hashable
       
         # Required. The network that the consumer is using to connect with services.
-        # Must be in the form of projects/`project`/global/networks/`network`
-        # `project` is the project number, as in '12345'
-        # `network` is the network name.
+        # Must be in the form of projects/`project`/global/networks/`network` `project`
+        # is the project number, as in '12345' `network` is the network name.
         # Corresponds to the JSON property `consumerNetwork`
         # @return [String]
         attr_accessor :consumer_network
@@ -4364,8 +3741,7 @@ module Google
         attr_accessor :new_dns_record_set
       
         # Required. The name of the private DNS zone in the shared producer host project
-        # from
-        # which the record set will be removed.
+        # from which the record set will be removed.
         # Corresponds to the JSON property `zone`
         # @return [String]
         attr_accessor :zone
@@ -4388,37 +3764,33 @@ 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::ServicenetworkingV1::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"
+        # 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::ServicenetworkingV1::ServiceIdentity]
         attr_accessor :service_identity
@@ -4436,45 +3808,36 @@ module Google
         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
@@ -4497,9 +3860,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The network that the consumer is using to connect with services.
-        # Must be in
-        # the form of projects/`project`/global/networks/`network` `project` is a
-        # project number, as in '12345' `network` is network name.
+        # Must be in the form of projects/`project`/global/networks/`network` `project`
+        # is a project number, as in '12345' `network` is network name.
         # Corresponds to the JSON property `consumerNetwork`
         # @return [String]
         attr_accessor :consumer_network
@@ -4514,13 +3876,12 @@ module Google
         # @return [Google::Apis::ServicenetworkingV1::RangeReservation]
         attr_accessor :range_reservation
       
-        # The validations will be performed in the order listed in the
-        # ValidationError enum. The first failure will return. If a validation is not
-        # requested, then the next one will be performed.
-        # SERVICE_NETWORKING_NOT_ENABLED and NETWORK_NOT_PEERED checks are performed
-        # for all requests where validation is requested. NETWORK_NOT_FOUND and
-        # NETWORK_DISCONNECTED checks are done for requests that have
-        # validate_network set to true.
+        # The validations will be performed in the order listed in the ValidationError
+        # enum. The first failure will return. If a validation is not requested, then
+        # the next one will be performed. SERVICE_NETWORKING_NOT_ENABLED and
+        # NETWORK_NOT_PEERED checks are performed for all requests where validation is
+        # requested. NETWORK_NOT_FOUND and NETWORK_DISCONNECTED checks are done for
+        # requests that have validate_network set to true.
         # Corresponds to the JSON property `validateNetwork`
         # @return [Boolean]
         attr_accessor :validate_network