google-api-client 0.23.0 → 0.23.1

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

@@ -0,0 +1,423 @@
+# Copyright 2015 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module ServiceusageV1
+      # Service Usage API
+      #
+      # Enables services that service consumers want to use on Google Cloud Platform,
+      #  lists the available or enabled services, or disables services that service
+      #  consumers no longer use.
+      #
+      # @example
+      #    require 'google/apis/serviceusage_v1'
+      #
+      #    Serviceusage = Google::Apis::ServiceusageV1 # Alias the module
+      #    service = Serviceusage::ServiceUsageService.new
+      #
+      # @see https://cloud.google.com/service-usage/
+      class ServiceUsageService < Google::Apis::Core::BaseService
+        # @return [String]
+        #  API key. Your API key identifies your project and provides you with API access,
+        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
+        attr_accessor :key
+
+        # @return [String]
+        #  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.
+        attr_accessor :quota_user
+
+        def initialize
+          super('https://serviceusage.googleapis.com/', '')
+          @batch_path = 'batch'
+        end
+        
+        # Starts asynchronous cancellation on a long-running operation.  The server
+        # makes a best effort to cancel the operation, but success is not
+        # guaranteed.  If the server doesn't support this method, it returns
+        # `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
+        # Operations.GetOperation or
+        # other methods to check whether the cancellation succeeded or whether the
+        # operation completed despite cancellation. On successful cancellation,
+        # the operation is not deleted; instead, it becomes an operation with
+        # an Operation.error value with a google.rpc.Status.code of 1,
+        # corresponding to `Code.CANCELLED`.
+        # @param [String] name
+        #   The name of the operation resource to be cancelled.
+        # @param [Google::Apis::ServiceusageV1::CancelOperationRequest] cancel_operation_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::ServiceusageV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServiceusageV1::Empty]
+        #
+        # @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 cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+name}:cancel', options)
+          command.request_representation = Google::Apis::ServiceusageV1::CancelOperationRequest::Representation
+          command.request_object = cancel_operation_request_object
+          command.response_representation = Google::Apis::ServiceusageV1::Empty::Representation
+          command.response_class = Google::Apis::ServiceusageV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a long-running operation. This method indicates that the client is
+        # no longer interested in the operation result. It does not cancel the
+        # operation. If the server doesn't support this method, it returns
+        # `google.rpc.Code.UNIMPLEMENTED`.
+        # @param [String] name
+        #   The name of the operation resource to be deleted.
+        # @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::ServiceusageV1::Empty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServiceusageV1::Empty]
+        #
+        # @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 delete_operation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:delete, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::ServiceusageV1::Empty::Representation
+          command.response_class = Google::Apis::ServiceusageV1::Empty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the latest state of a long-running operation.  Clients can use this
+        # method to poll the operation result at intervals as recommended by the API
+        # service.
+        # @param [String] name
+        #   The name of the operation resource.
+        # @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::ServiceusageV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServiceusageV1::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 get_operation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::ServiceusageV1::Operation::Representation
+          command.response_class = Google::Apis::ServiceusageV1::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists operations that match the specified filter in the request. If the
+        # server doesn't support this method, it returns `UNIMPLEMENTED`.
+        # NOTE: the `name` binding allows API services to override the binding
+        # to use different resource name schemes, such as `users/*/operations`. To
+        # override the binding, API services can add a binding such as
+        # `"/v1/`name=users/*`/operations"` to their service configuration.
+        # For backwards compatibility, the default name includes the operations
+        # collection id, however overriding users must ensure the name binding
+        # is the parent resource, without the operations collection id.
+        # @param [String] filter
+        #   The standard list filter.
+        # @param [String] name
+        #   The name of the operation's parent resource.
+        # @param [Fixnum] page_size
+        #   The standard list page size.
+        # @param [String] page_token
+        #   The standard list page token.
+        # @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::ServiceusageV1::ListOperationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServiceusageV1::ListOperationsResponse]
+        #
+        # @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 list_operations(filter: nil, name: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/operations', options)
+          command.response_representation = Google::Apis::ServiceusageV1::ListOperationsResponse::Representation
+          command.response_class = Google::Apis::ServiceusageV1::ListOperationsResponse
+          command.query['filter'] = filter unless filter.nil?
+          command.query['name'] = name unless name.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Enable multiple services on a project. The operation is atomic: if enabling
+        # any service fails, then the entire batch fails, and no state changes occur.
+        # Operation<response: BatchEnableServicesResponse>
+        # @param [String] parent
+        #   Parent to enable services on.
+        #   An example name would be:
+        #   `projects/123`
+        #   where `123` is the project number (not project ID).
+        #   The `BatchEnableServices` method currently only supports projects.
+        # @param [Google::Apis::ServiceusageV1::BatchEnableServicesRequest] batch_enable_services_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::ServiceusageV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServiceusageV1::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 batch_enable_services(parent, batch_enable_services_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+parent}/services:batchEnable', options)
+          command.request_representation = Google::Apis::ServiceusageV1::BatchEnableServicesRequest::Representation
+          command.request_object = batch_enable_services_request_object
+          command.response_representation = Google::Apis::ServiceusageV1::Operation::Representation
+          command.response_class = Google::Apis::ServiceusageV1::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
+        
+        # Disable a service so that it can no longer be used with a project.
+        # This prevents unintended usage that may cause unexpected billing
+        # charges or security leaks.
+        # It is not valid to call the disable method on a service that is not
+        # currently enabled. Callers will receive a `FAILED_PRECONDITION` status if
+        # the target service is not currently enabled.
+        # Operation<response: DisableServiceResponse>
+        # @param [String] name
+        #   Name of the consumer and service to disable the service on.
+        #   The enable and disable methods currently only support projects.
+        #   An example name would be:
+        #   `projects/123/services/serviceusage.googleapis.com`
+        #   where `123` is the project number (not project ID).
+        # @param [Google::Apis::ServiceusageV1::DisableServiceRequest] disable_service_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::ServiceusageV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServiceusageV1::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 disable_service(name, disable_service_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+name}:disable', options)
+          command.request_representation = Google::Apis::ServiceusageV1::DisableServiceRequest::Representation
+          command.request_object = disable_service_request_object
+          command.response_representation = Google::Apis::ServiceusageV1::Operation::Representation
+          command.response_class = Google::Apis::ServiceusageV1::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Enable a service so that it can be used with a project.
+        # Operation<response: EnableServiceResponse>
+        # @param [String] name
+        #   Name of the consumer and service to enable the service on.
+        #   The `EnableService` and `DisableService` methods currently only support
+        #   projects.
+        #   Enabling a service requires that the service is public or is shared with
+        #   the user enabling the service.
+        #   An example name would be:
+        #   `projects/123/services/serviceusage.googleapis.com`
+        #   where `123` is the project number (not project ID).
+        # @param [Google::Apis::ServiceusageV1::EnableServiceRequest] enable_service_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::ServiceusageV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServiceusageV1::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_service(name, enable_service_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/{+name}:enable', options)
+          command.request_representation = Google::Apis::ServiceusageV1::EnableServiceRequest::Representation
+          command.request_object = enable_service_request_object
+          command.response_representation = Google::Apis::ServiceusageV1::Operation::Representation
+          command.response_class = Google::Apis::ServiceusageV1::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns the service configuration and enabled state for a given service.
+        # @param [String] name
+        #   Name of the consumer and service to get the `ConsumerState` for.
+        #   An example name would be:
+        #   `projects/123/services/serviceusage.googleapis.com`
+        #   where `123` is the project number (not project ID).
+        # @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::ServiceusageV1::GoogleApiServiceusageV1Service] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServiceusageV1::GoogleApiServiceusageV1Service]
+        #
+        # @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 get_service(name, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+name}', options)
+          command.response_representation = Google::Apis::ServiceusageV1::GoogleApiServiceusageV1Service::Representation
+          command.response_class = Google::Apis::ServiceusageV1::GoogleApiServiceusageV1Service
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # List all services available to the specified project, and the current
+        # state of those services with respect to the project. The list includes
+        # all public services, all services for which the calling user has the
+        # `servicemanagement.services.bind` permission, and all services that have
+        # already been enabled on the project. The list can be filtered to
+        # only include services in a specific state, for example to only include
+        # services enabled on the project.
+        # @param [String] parent
+        #   Parent to search for services on.
+        #   An example name would be:
+        #   `projects/123`
+        #   where `123` is the project number (not project ID).
+        # @param [String] filter
+        #   Only list services that conform to the given filter.
+        #   The allowed filter strings are `state:ENABLED` and `state:DISABLED`.
+        # @param [Fixnum] page_size
+        #   Requested size of the next page of data.
+        #   Requested page size cannot exceed 200.
+        #   If not set, the default page size is 50.
+        # @param [String] page_token
+        #   Token identifying which result to start with, which is returned by a
+        #   previous list call.
+        # @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::ServiceusageV1::ListServicesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ServiceusageV1::ListServicesResponse]
+        #
+        # @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 list_services(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/{+parent}/services', options)
+          command.response_representation = Google::Apis::ServiceusageV1::ListServicesResponse::Representation
+          command.response_class = Google::Apis::ServiceusageV1::ListServicesResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+
+        protected
+
+        def apply_command_defaults(command)
+          command.query['key'] = key unless key.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+        end
+      end
+    end
+  end
+end

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 = '20180520'
+      REVISION = '20180630'
 
       # 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

@@ -946,7 +946,26 @@ 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 ````.
+      class Empty
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Provides error messages for the failing services.
       class EnableFailure
         include Google::Apis::Core::Hashable
       
@@ -1699,6 +1718,26 @@ module Google
         end
       end
       
+      # The operation metadata returned for the batchend services operation.
+      class GoogleApiServiceusageV1OperationMetadata
+        include Google::Apis::Core::Hashable
+      
+        # The full name of the resources that this operation is directly
+        # associated with.
+        # Corresponds to the JSON property `resourceNames`
+        # @return [Array<String>]
+        attr_accessor :resource_names
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @resource_names = args[:resource_names] if args.key?(:resource_names)
+        end
+      end
+      
       # A service that is available for use by the consumer.
       class GoogleApiServiceusageV1Service
         include Google::Apis::Core::Hashable
@@ -1903,6 +1942,26 @@ module Google
         end
       end
       
+      # The operation metadata returned for the batchend services operation.
+      class GoogleApiServiceusageV1beta1OperationMetadata
+        include Google::Apis::Core::Hashable
+      
+        # The full name of the resources that this operation is directly
+        # associated with.
+        # Corresponds to the JSON property `resourceNames`
+        # @return [Array<String>]
+        attr_accessor :resource_names
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @resource_names = args[:resource_names] if args.key?(:resource_names)
+        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.
@@ -2692,6 +2751,11 @@ module Google
         # @return [Array<Google::Apis::ServiceusageV1beta1::LabelDescriptor>]
         attr_accessor :labels
       
+        # Additional annotations that can be used to guide the usage of a metric.
+        # Corresponds to the JSON property `metadata`
+        # @return [Google::Apis::ServiceusageV1beta1::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.
         # Corresponds to the JSON property `metricKind`
@@ -2784,6 +2848,7 @@ module Google
           @description = args[:description] if args.key?(:description)
           @display_name = args[:display_name] if args.key?(:display_name)
           @labels = args[:labels] if args.key?(:labels)
+          @metadata = args[:metadata] if args.key?(:metadata)
           @metric_kind = args[:metric_kind] if args.key?(:metric_kind)
           @name = args[:name] if args.key?(:name)
           @type = args[:type] if args.key?(:type)
@@ -2792,6 +2857,42 @@ module Google
         end
       end
       
+      # Additional annotations that can be used to guide the usage of a metric.
+      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.
+        # Corresponds to the JSON property `ingestDelay`
+        # @return [String]
+        attr_accessor :ingest_delay
+      
+        # The launch stage of the metric definition.
+        # Corresponds to the JSON property `launchStage`
+        # @return [String]
+        attr_accessor :launch_stage
+      
+        # 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.
+        # Corresponds to the JSON property `samplePeriod`
+        # @return [String]
+        attr_accessor :sample_period
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @ingest_delay = args[:ingest_delay] if args.key?(:ingest_delay)
+          @launch_stage = args[:launch_stage] if args.key?(:launch_stage)
+          @sample_period = args[:sample_period] if args.key?(:sample_period)
+        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.
       class MetricRule