google-api-client 0.32.1 → 0.36.0

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

@@ -250,6 +250,41 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Enables VPC service controls for a connection.
+        # @param [String] parent
+        #   The service that is managing peering connectivity for a service producer's
+        #   organization. For Google services that support this functionality, this
+        #   value is `services/servicenetworking.googleapis.com`.
+        # @param [Google::Apis::ServicenetworkingV1::EnableVpcServiceControlsRequest] enable_vpc_service_controls_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ServicenetworkingV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServicenetworkingV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def enable_vpc_service_controls(parent, enable_vpc_service_controls_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1/{+parent}:enableVpcServiceControls', options)
+          command.request_representation = Google::Apis::ServicenetworkingV1::EnableVpcServiceControlsRequest::Representation
+          command.request_object = enable_vpc_service_controls_request_object
+          command.response_representation = Google::Apis::ServicenetworkingV1::Operation::Representation
+          command.response_class = Google::Apis::ServicenetworkingV1::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Service producers can use this method to find a currently unused range
         # within consumer allocated ranges.   This returned range is not reserved,
         # and not guaranteed to remain unused.
@@ -259,9 +294,9 @@ module Google
         # notation).
         # Operation<response: Range>
         # @param [String] parent
-        #   Required. This is in a form services/`service`.
-        #   `service` the name of the private access management service, for example
-        #   'service-peering.example.com'.
+        #   Required. This is in a form services/`service`. `service` the name of the
+        #   private
+        #   access management service, for example 'service-peering.example.com'.
         # @param [Google::Apis::ServicenetworkingV1::SearchRangeRequest] search_range_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -292,6 +327,45 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Service producers use this method to validate if the consumer provided
+        # network, project and the requested range is valid. This allows them to use
+        # a fail-fast mechanism for consumer requests, and not have to wait for
+        # AddSubnetwork operation completion to determine if user request is invalid.
+        # @param [String] parent
+        #   Required. This is in a form services/`service` where `service` is the name of
+        #   the
+        #   private access management service. For example
+        #   'service-peering.example.com'.
+        # @param [Google::Apis::ServicenetworkingV1::ValidateConsumerConfigRequest] validate_consumer_config_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ServicenetworkingV1::ValidateConsumerConfigResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServicenetworkingV1::ValidateConsumerConfigResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def validate_service_consumer_config(parent, validate_consumer_config_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}:validate', options)
+          command.request_representation = Google::Apis::ServicenetworkingV1::ValidateConsumerConfigRequest::Representation
+          command.request_object = validate_consumer_config_request_object
+          command.response_representation = Google::Apis::ServicenetworkingV1::ValidateConsumerConfigResponse::Representation
+          command.response_class = Google::Apis::ServicenetworkingV1::ValidateConsumerConfigResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a private connection that establishes a VPC Network Peering
         # connection to a VPC network in the service producer's organization.
         # The administrator of the service consumer's VPC network invokes this

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 = '20190922'
+      REVISION = '20191203'
 
       # 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_v1beta/classes.rb

@@ -1867,42 +1867,19 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # The unit in which the metric value is reported. It is only applicable
-        # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
-        # supported units are a subset of [The Unified Code for Units of
-        # Measure](http://unitsofmeasure.org/ucum.html) standard:
-        # **Basic units (UNIT)**
-        # * `bit`   bit
-        # * `By`    byte
-        # * `s`     second
-        # * `min`   minute
-        # * `h`     hour
-        # * `d`     day
-        # **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)
+        # * `Ki`    kibi    (2^10)
+        # * `Mi`    mebi    (2^20)
+        # * `Gi`    gibi    (2^30)
+        # * `Ti`    tebi    (2^40)
+        # * `Pi`    pebi    (2^50)
         # **Grammar**
         # The grammar also includes these connectors:
-        # * `/`    division (as an infix operator, e.g. `1/s`).
-        # * `.`    multiplication (as an infix operator, e.g. `GBy.d`)
+        # * `/`    division or ratio (as an infix operator). For examples,
+        # `kBy/`email`` or `MiBy/10ms` (although you should almost never
+        # have `/s` in a metric `unit`; rates should always be computed at
+        # query time from the underlying cumulative or delta value).
+        # * `.`    multiplication or composition (as an infix operator). For
+        # examples, `GBy.d` or `k`watt`.h`.
         # The grammar for a unit is as follows:
         # Expression = Component ` "." Component ` ` "/" Component ` ;
         # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
@@ -1911,14 +1888,25 @@ module Google
         # ;
         # Annotation = "`" NAME "`" ;
         # Notes:
-        # * `Annotation` is just a comment if it follows a `UNIT` and is
-        # equivalent to `1` if it is used alone. For examples,
-        # ``requests`/s == 1/s`, `By`transmitted`/s == By/s`.
+        # * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
+        # is used alone, then the unit is equivalent to `1`. For examples,
+        # ``request`/s == 1/s`, `By`transmitted`/s == By/s`.
         # * `NAME` is a sequence of non-blank printable ASCII characters not
-        # containing '`' or '`'.
-        # * `1` represents dimensionless value 1, such as in `1/s`.
-        # * `%` represents dimensionless value 1/100, and annotates values giving
-        # a percentage.
+        # containing ``` or ```.
+        # * `1` represents a unitary [dimensionless
+        # unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
+        # as in `1/s`. It is typically used when none of the basic units are
+        # appropriate. For example, "new users per day" can be represented as
+        # `1/d` or ``new-users`/d` (and a metric value `5` would mean "5 new
+        # users). Alternatively, "thousands of page views per day" would be
+        # represented as `1000/d` or `k1/d` or `k`page_views`/d` (and a metric
+        # value of `5.3` would mean "5300 page views per day").
+        # * `%` represents dimensionless value of 1/100, and annotates values giving
+        # a percentage (so the metric values are typically in the range of 0..100,
+        # and a metric value `3` means "3 percent").
+        # * `10^2.%` indicates a metric contains a ratio, typically in the range
+        # 0..1, that will be multiplied by 100 and displayed as a percentage
+        # (so a metric value `0.03` means "3 percent").
         # Corresponds to the JSON property `unit`
         # @return [String]
         attr_accessor :unit
@@ -2903,8 +2891,9 @@ module Google
         attr_accessor :http
       
         # A unique ID for a specific instance of this message, typically assigned
-        # by the client for tracking purpose. If empty, the server may choose to
-        # generate one instead. Must be no longer than 60 characters.
+        # 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

data/generated/google/apis/servicenetworking_v1beta.rb

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

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

@@ -1505,8 +1505,9 @@ module Google
         attr_accessor :http
       
         # A unique ID for a specific instance of this message, typically assigned
-        # by the client for tracking purpose. If empty, the server may choose to
-        # generate one instead. Must be no longer than 60 characters.
+        # 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
@@ -1959,6 +1960,61 @@ module Google
         end
       end
       
+      # Response message for getting service identity.
+      class GoogleApiServiceusageV1beta1GetServiceIdentityResponse
+        include Google::Apis::Core::Hashable
+      
+        # Service identity for a service. This is the identity that service producer
+        # should use to access consumer resources.
+        # Corresponds to the JSON property `identity`
+        # @return [Google::Apis::ServiceusageV1::GoogleApiServiceusageV1beta1ServiceIdentity]
+        attr_accessor :identity
+      
+        # Service identity state.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @identity = args[:identity] if args.key?(:identity)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
+      # Service identity for a service. This is the identity that service producer
+      # should use to access consumer resources.
+      class GoogleApiServiceusageV1beta1ServiceIdentity
+        include Google::Apis::Core::Hashable
+      
+        # The email address of the service account that a service producer would use
+        # to access consumer resources.
+        # Corresponds to the JSON property `email`
+        # @return [String]
+        attr_accessor :email
+      
+        # The unique and stable id of the service account.
+        # https://cloud.google.com/iam/reference/rest/v1/projects.serviceAccounts#
+        # ServiceAccount
+        # Corresponds to the JSON property `uniqueId`
+        # @return [String]
+        attr_accessor :unique_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @email = args[:email] if args.key?(:email)
+          @unique_id = args[:unique_id] if args.key?(:unique_id)
+        end
+      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.
@@ -2645,42 +2701,19 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # The unit in which the metric value is reported. It is only applicable
-        # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
-        # supported units are a subset of [The Unified Code for Units of
-        # Measure](http://unitsofmeasure.org/ucum.html) standard:
-        # **Basic units (UNIT)**
-        # * `bit`   bit
-        # * `By`    byte
-        # * `s`     second
-        # * `min`   minute
-        # * `h`     hour
-        # * `d`     day
-        # **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)
+        # * `Ki`    kibi    (2^10)
+        # * `Mi`    mebi    (2^20)
+        # * `Gi`    gibi    (2^30)
+        # * `Ti`    tebi    (2^40)
+        # * `Pi`    pebi    (2^50)
         # **Grammar**
         # The grammar also includes these connectors:
-        # * `/`    division (as an infix operator, e.g. `1/s`).
-        # * `.`    multiplication (as an infix operator, e.g. `GBy.d`)
+        # * `/`    division or ratio (as an infix operator). For examples,
+        # `kBy/`email`` or `MiBy/10ms` (although you should almost never
+        # have `/s` in a metric `unit`; rates should always be computed at
+        # query time from the underlying cumulative or delta value).
+        # * `.`    multiplication or composition (as an infix operator). For
+        # examples, `GBy.d` or `k`watt`.h`.
         # The grammar for a unit is as follows:
         # Expression = Component ` "." Component ` ` "/" Component ` ;
         # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
@@ -2689,14 +2722,25 @@ module Google
         # ;
         # Annotation = "`" NAME "`" ;
         # Notes:
-        # * `Annotation` is just a comment if it follows a `UNIT` and is
-        # equivalent to `1` if it is used alone. For examples,
-        # ``requests`/s == 1/s`, `By`transmitted`/s == By/s`.
+        # * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
+        # is used alone, then the unit is equivalent to `1`. For examples,
+        # ``request`/s == 1/s`, `By`transmitted`/s == By/s`.
         # * `NAME` is a sequence of non-blank printable ASCII characters not
-        # containing '`' or '`'.
-        # * `1` represents dimensionless value 1, such as in `1/s`.
-        # * `%` represents dimensionless value 1/100, and annotates values giving
-        # a percentage.
+        # containing ``` or ```.
+        # * `1` represents a unitary [dimensionless
+        # unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
+        # as in `1/s`. It is typically used when none of the basic units are
+        # appropriate. For example, "new users per day" can be represented as
+        # `1/d` or ``new-users`/d` (and a metric value `5` would mean "5 new
+        # users). Alternatively, "thousands of page views per day" would be
+        # represented as `1000/d` or `k1/d` or `k`page_views`/d` (and a metric
+        # value of `5.3` would mean "5300 page views per day").
+        # * `%` represents dimensionless value of 1/100, and annotates values giving
+        # a percentage (so the metric values are typically in the range of 0..100,
+        # and a metric value `3` means "3 percent").
+        # * `10^2.%` indicates a metric contains a ratio, typically in the range
+        # 0..1, that will be multiplied by 100 and displayed as a percentage
+        # (so a metric value `0.03` means "3 percent").
         # Corresponds to the JSON property `unit`
         # @return [String]
         attr_accessor :unit

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

@@ -244,6 +244,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleApiServiceusageV1beta1GetServiceIdentityResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleApiServiceusageV1beta1ServiceIdentity
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Http
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -853,6 +865,23 @@ module Google
         end
       end
       
+      class GoogleApiServiceusageV1beta1GetServiceIdentityResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :identity, as: 'identity', class: Google::Apis::ServiceusageV1::GoogleApiServiceusageV1beta1ServiceIdentity, decorator: Google::Apis::ServiceusageV1::GoogleApiServiceusageV1beta1ServiceIdentity::Representation
+      
+          property :state, as: 'state'
+        end
+      end
+      
+      class GoogleApiServiceusageV1beta1ServiceIdentity
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :email, as: 'email'
+          property :unique_id, as: 'uniqueId'
+        end
+      end
+      
       class Http
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/serviceusage_v1.rb

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

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

@@ -1483,8 +1483,9 @@ module Google
         attr_accessor :http
       
         # A unique ID for a specific instance of this message, typically assigned
-        # by the client for tracking purpose. If empty, the server may choose to
-        # generate one instead. Must be no longer than 60 characters.
+        # 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
@@ -1937,6 +1938,61 @@ module Google
         end
       end
       
+      # Response message for getting service identity.
+      class GoogleApiServiceusageV1beta1GetServiceIdentityResponse
+        include Google::Apis::Core::Hashable
+      
+        # Service identity for a service. This is the identity that service producer
+        # should use to access consumer resources.
+        # Corresponds to the JSON property `identity`
+        # @return [Google::Apis::ServiceusageV1beta1::GoogleApiServiceusageV1beta1ServiceIdentity]
+        attr_accessor :identity
+      
+        # Service identity state.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @identity = args[:identity] if args.key?(:identity)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
+      # Service identity for a service. This is the identity that service producer
+      # should use to access consumer resources.
+      class GoogleApiServiceusageV1beta1ServiceIdentity
+        include Google::Apis::Core::Hashable
+      
+        # The email address of the service account that a service producer would use
+        # to access consumer resources.
+        # Corresponds to the JSON property `email`
+        # @return [String]
+        attr_accessor :email
+      
+        # The unique and stable id of the service account.
+        # https://cloud.google.com/iam/reference/rest/v1/projects.serviceAccounts#
+        # ServiceAccount
+        # Corresponds to the JSON property `uniqueId`
+        # @return [String]
+        attr_accessor :unique_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @email = args[:email] if args.key?(:email)
+          @unique_id = args[:unique_id] if args.key?(:unique_id)
+        end
+      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.
@@ -2623,42 +2679,19 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # The unit in which the metric value is reported. It is only applicable
-        # if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
-        # supported units are a subset of [The Unified Code for Units of
-        # Measure](http://unitsofmeasure.org/ucum.html) standard:
-        # **Basic units (UNIT)**
-        # * `bit`   bit
-        # * `By`    byte
-        # * `s`     second
-        # * `min`   minute
-        # * `h`     hour
-        # * `d`     day
-        # **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)
+        # * `Ki`    kibi    (2^10)
+        # * `Mi`    mebi    (2^20)
+        # * `Gi`    gibi    (2^30)
+        # * `Ti`    tebi    (2^40)
+        # * `Pi`    pebi    (2^50)
         # **Grammar**
         # The grammar also includes these connectors:
-        # * `/`    division (as an infix operator, e.g. `1/s`).
-        # * `.`    multiplication (as an infix operator, e.g. `GBy.d`)
+        # * `/`    division or ratio (as an infix operator). For examples,
+        # `kBy/`email`` or `MiBy/10ms` (although you should almost never
+        # have `/s` in a metric `unit`; rates should always be computed at
+        # query time from the underlying cumulative or delta value).
+        # * `.`    multiplication or composition (as an infix operator). For
+        # examples, `GBy.d` or `k`watt`.h`.
         # The grammar for a unit is as follows:
         # Expression = Component ` "." Component ` ` "/" Component ` ;
         # Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ]
@@ -2667,14 +2700,25 @@ module Google
         # ;
         # Annotation = "`" NAME "`" ;
         # Notes:
-        # * `Annotation` is just a comment if it follows a `UNIT` and is
-        # equivalent to `1` if it is used alone. For examples,
-        # ``requests`/s == 1/s`, `By`transmitted`/s == By/s`.
+        # * `Annotation` is just a comment if it follows a `UNIT`. If the annotation
+        # is used alone, then the unit is equivalent to `1`. For examples,
+        # ``request`/s == 1/s`, `By`transmitted`/s == By/s`.
         # * `NAME` is a sequence of non-blank printable ASCII characters not
-        # containing '`' or '`'.
-        # * `1` represents dimensionless value 1, such as in `1/s`.
-        # * `%` represents dimensionless value 1/100, and annotates values giving
-        # a percentage.
+        # containing ``` or ```.
+        # * `1` represents a unitary [dimensionless
+        # unit](https://en.wikipedia.org/wiki/Dimensionless_quantity) of 1, such
+        # as in `1/s`. It is typically used when none of the basic units are
+        # appropriate. For example, "new users per day" can be represented as
+        # `1/d` or ``new-users`/d` (and a metric value `5` would mean "5 new
+        # users). Alternatively, "thousands of page views per day" would be
+        # represented as `1000/d` or `k1/d` or `k`page_views`/d` (and a metric
+        # value of `5.3` would mean "5300 page views per day").
+        # * `%` represents dimensionless value of 1/100, and annotates values giving
+        # a percentage (so the metric values are typically in the range of 0..100,
+        # and a metric value `3` means "3 percent").
+        # * `10^2.%` indicates a metric contains a ratio, typically in the range
+        # 0..1, that will be multiplied by 100 and displayed as a percentage
+        # (so a metric value `0.03` means "3 percent").
         # Corresponds to the JSON property `unit`
         # @return [String]
         attr_accessor :unit

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

@@ -238,6 +238,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleApiServiceusageV1beta1GetServiceIdentityResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleApiServiceusageV1beta1ServiceIdentity
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Http
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -852,6 +864,23 @@ module Google
         end
       end
       
+      class GoogleApiServiceusageV1beta1GetServiceIdentityResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :identity, as: 'identity', class: Google::Apis::ServiceusageV1beta1::GoogleApiServiceusageV1beta1ServiceIdentity, decorator: Google::Apis::ServiceusageV1beta1::GoogleApiServiceusageV1beta1ServiceIdentity::Representation
+      
+          property :state, as: 'state'
+        end
+      end
+      
+      class GoogleApiServiceusageV1beta1ServiceIdentity
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :email, as: 'email'
+          property :unique_id, as: 'uniqueId'
+        end
+      end
+      
       class Http
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/serviceusage_v1beta1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/service-usage/
     module ServiceusageV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20190921'
+      REVISION = '20191203'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'