google-apis-serviceusage_v1 0.28.0 → 0.76.0

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

@@ -22,6 +22,46 @@ module Google
   module Apis
     module ServiceusageV1
       
+      # Metadata for the `AddEnableRules` method.
+      class AddEnableRulesMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # The response message of `AddEnableRules` method.
+      class AddEnableRulesResponse
+        include Google::Apis::Core::Hashable
+      
+        # The values added to the parent consumer policy.
+        # Corresponds to the JSON property `addedValues`
+        # @return [Array<String>]
+        attr_accessor :added_values
+      
+        # The parent consumer policy. It can be `projects/12345/consumerPolicies/default`
+        # , or `folders/12345/consumerPolicies/default`, or `organizations/12345/
+        # consumerPolicies/default`.
+        # Corresponds to the JSON property `parent`
+        # @return [String]
+        attr_accessor :parent
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @added_values = args[:added_values] if args.key?(:added_values)
+          @parent = args[:parent] if args.key?(:parent)
+        end
+      end
+      
       # Quota policy created by quota administrator.
       class AdminQuotaPolicy
         include Google::Apis::Core::Hashable
@@ -33,7 +73,7 @@ module Google
         attr_accessor :container
       
         # If this map is nonempty, then this policy applies only to specific values for
-        # dimensions defined in the limit unit. For example, an policy on a limit with
+        # dimensions defined in the limit unit. For example, a policy on a limit with
         # the unit `1/`project`/`region`` could contain an entry with the key `region`
         # and the value `us-east-1`; the policy is only applied to quota consumed in
         # that region. This map has the following restrictions: * If `region` appears as
@@ -87,16 +127,125 @@ module Google
         end
       end
       
+      # A message to group the analysis information.
+      class Analysis
+        include Google::Apis::Core::Hashable
+      
+        # An analysis result including blockers and warnings.
+        # Corresponds to the JSON property `analysis`
+        # @return [Google::Apis::ServiceusageV1::AnalysisResult]
+        attr_accessor :analysis
+      
+        # Output only. The type of analysis.
+        # Corresponds to the JSON property `analysisType`
+        # @return [String]
+        attr_accessor :analysis_type
+      
+        # Output only. The user friendly display name of the analysis type. E.g. service
+        # dependency analysis, service resource usage analysis, etc.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # The names of the service that has analysis result of warnings or blockers.
+        # Example: `services/storage.googleapis.com`.
+        # Corresponds to the JSON property `service`
+        # @return [String]
+        attr_accessor :service
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @analysis = args[:analysis] if args.key?(:analysis)
+          @analysis_type = args[:analysis_type] if args.key?(:analysis_type)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @service = args[:service] if args.key?(:service)
+        end
+      end
+      
+      # An analysis result including blockers and warnings.
+      class AnalysisResult
+        include Google::Apis::Core::Hashable
+      
+        # Blocking information that would prevent the policy changes at runtime.
+        # Corresponds to the JSON property `blockers`
+        # @return [Array<Google::Apis::ServiceusageV1::Impact>]
+        attr_accessor :blockers
+      
+        # Warning information indicating that the policy changes might be unsafe, but
+        # will not block the changes at runtime.
+        # Corresponds to the JSON property `warnings`
+        # @return [Array<Google::Apis::ServiceusageV1::Impact>]
+        attr_accessor :warnings
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @blockers = args[:blockers] if args.key?(:blockers)
+          @warnings = args[:warnings] if args.key?(:warnings)
+        end
+      end
+      
+      # Metadata for the `AnalyzeConsumerPolicy` method.
+      class AnalyzeConsumerPolicyMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # The response of analyzing a consumer policy update.
+      class AnalyzeConsumerPolicyResponse
+        include Google::Apis::Core::Hashable
+      
+        # The list of analyses returned from performing the intended policy update
+        # analysis. The analysis is grouped by service name and different analysis types.
+        # The empty analysis list means that the consumer policy can be updated without
+        # any warnings or blockers.
+        # Corresponds to the JSON property `analysis`
+        # @return [Array<Google::Apis::ServiceusageV1::Analysis>]
+        attr_accessor :analysis
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @analysis = args[:analysis] if args.key?(:analysis)
+        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.
+      # https://cloud.google.com/apis/design/glossary for detailed terminology. New
+      # usages of this message as an alternative to ServiceDescriptorProto are
+      # strongly discouraged. This message does not reliability preserve all
+      # information necessary to model the schema and preserve semantics. Instead make
+      # use of FileDescriptorSet which preserves the necessary information.
       class Api
         include Google::Apis::Core::Hashable
       
+        # The source edition string, only valid when syntax is SYNTAX_EDITIONS.
+        # Corresponds to the JSON property `edition`
+        # @return [String]
+        attr_accessor :edition
+      
         # The methods of this interface, in unspecified order.
         # Corresponds to the JSON property `methods`
         # @return [Array<Google::Apis::ServiceusageV1::MethodProp>]
@@ -152,6 +301,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @edition = args[:edition] if args.key?(:edition)
           @methods_prop = args[:methods_prop] if args.key?(:methods_prop)
           @mixins = args[:mixins] if args.key?(:mixins)
           @name = args[:name] if args.key?(:name)
@@ -162,6 +312,66 @@ module Google
         end
       end
       
+      # Aspect represents Generic aspect. It is used to configure an aspect without
+      # making direct changes to service.proto
+      class Aspect
+        include Google::Apis::Core::Hashable
+      
+        # The type of this aspect configuration.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # Optional. Rules of the Configuration.
+        # Corresponds to the JSON property `rules`
+        # @return [Array<Google::Apis::ServiceusageV1::AspectRule>]
+        attr_accessor :rules
+      
+        # Content of the configuration. The underlying schema should be defined by
+        # Aspect owners as protobuf message under `google/api/configaspects/proto`.
+        # Corresponds to the JSON property `spec`
+        # @return [Hash<String,Object>]
+        attr_accessor :spec
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+          @rules = args[:rules] if args.key?(:rules)
+          @spec = args[:spec] if args.key?(:spec)
+        end
+      end
+      
+      # Rule-based configuration for an aspect.
+      class AspectRule
+        include Google::Apis::Core::Hashable
+      
+        # Required. Rules of the configuration. The underlying schema should be defined
+        # by Aspect owners as protobuf message under `google/api/configaspects/proto`.
+        # Corresponds to the JSON property `config`
+        # @return [Hash<String,Object>]
+        attr_accessor :config
+      
+        # Required. Selects the RPC methods to which this rule applies. Refer to
+        # selector for syntax details.
+        # Corresponds to the JSON property `selector`
+        # @return [String]
+        attr_accessor :selector
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @config = args[:config] if args.key?(:config)
+          @selector = args[:selector] if args.key?(:selector)
+        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).
       class AuthProvider
@@ -419,6 +629,14 @@ module Google
         # @return [String]
         attr_accessor :jwt_audience
       
+        # The load balancing policy used for connection to the application backend.
+        # Defined as an arbitrary string to accomondate custom load balancing policies
+        # supported by the underlying channel, but suggest most users use one of the
+        # standard policies, such as the default, "RoundRobin".
+        # Corresponds to the JSON property `loadBalancingPolicy`
+        # @return [String]
+        attr_accessor :load_balancing_policy
+      
         # Deprecated, do not use.
         # Corresponds to the JSON property `minDeadline`
         # @return [Float]
@@ -430,7 +648,14 @@ module Google
         # @return [Float]
         attr_accessor :operation_deadline
       
-        # 
+        # The map between request protocol and the backend address.
+        # Corresponds to the JSON property `overridesByRequestProtocol`
+        # @return [Hash<String,Google::Apis::ServiceusageV1::BackendRule>]
+        attr_accessor :overrides_by_request_protocol
+      
+        # Path translation specifies how to combine the backend address with the request
+        # path in order to produce the appropriate forwarding URL for the request. See
+        # PathTranslation for more details.
         # Corresponds to the JSON property `pathTranslation`
         # @return [String]
         attr_accessor :path_translation
@@ -464,8 +689,10 @@ module Google
           @deadline = args[:deadline] if args.key?(:deadline)
           @disable_auth = args[:disable_auth] if args.key?(:disable_auth)
           @jwt_audience = args[:jwt_audience] if args.key?(:jwt_audience)
+          @load_balancing_policy = args[:load_balancing_policy] if args.key?(:load_balancing_policy)
           @min_deadline = args[:min_deadline] if args.key?(:min_deadline)
           @operation_deadline = args[:operation_deadline] if args.key?(:operation_deadline)
+          @overrides_by_request_protocol = args[:overrides_by_request_protocol] if args.key?(:overrides_by_request_protocol)
           @path_translation = args[:path_translation] if args.key?(:path_translation)
           @protocol = args[:protocol] if args.key?(:protocol)
           @selector = args[:selector] if args.key?(:selector)
@@ -580,6 +807,140 @@ module Google
         end
       end
       
+      # `BatchingConfigProto` defines the batching configuration for an API method.
+      class BatchingConfigProto
+        include Google::Apis::Core::Hashable
+      
+        # `BatchingDescriptorProto` specifies the fields of the request message to be
+        # used for batching, and, optionally, the fields of the response message to be
+        # used for demultiplexing.
+        # Corresponds to the JSON property `batchDescriptor`
+        # @return [Google::Apis::ServiceusageV1::BatchingDescriptorProto]
+        attr_accessor :batch_descriptor
+      
+        # `BatchingSettingsProto` specifies a set of batching thresholds, each of which
+        # acts as a trigger to send a batch of messages as a request. At least one
+        # threshold must be positive nonzero.
+        # Corresponds to the JSON property `thresholds`
+        # @return [Google::Apis::ServiceusageV1::BatchingSettingsProto]
+        attr_accessor :thresholds
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @batch_descriptor = args[:batch_descriptor] if args.key?(:batch_descriptor)
+          @thresholds = args[:thresholds] if args.key?(:thresholds)
+        end
+      end
+      
+      # `BatchingDescriptorProto` specifies the fields of the request message to be
+      # used for batching, and, optionally, the fields of the response message to be
+      # used for demultiplexing.
+      class BatchingDescriptorProto
+        include Google::Apis::Core::Hashable
+      
+        # The repeated field in the request message to be aggregated by batching.
+        # Corresponds to the JSON property `batchedField`
+        # @return [String]
+        attr_accessor :batched_field
+      
+        # A list of the fields in the request message. Two requests will be batched
+        # together only if the values of every field specified in `
+        # request_discriminator_fields` is equal between the two requests.
+        # Corresponds to the JSON property `discriminatorFields`
+        # @return [Array<String>]
+        attr_accessor :discriminator_fields
+      
+        # Optional. When present, indicates the field in the response message to be used
+        # to demultiplex the response into multiple response messages, in correspondence
+        # with the multiple request messages originally batched together.
+        # Corresponds to the JSON property `subresponseField`
+        # @return [String]
+        attr_accessor :subresponse_field
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @batched_field = args[:batched_field] if args.key?(:batched_field)
+          @discriminator_fields = args[:discriminator_fields] if args.key?(:discriminator_fields)
+          @subresponse_field = args[:subresponse_field] if args.key?(:subresponse_field)
+        end
+      end
+      
+      # `BatchingSettingsProto` specifies a set of batching thresholds, each of which
+      # acts as a trigger to send a batch of messages as a request. At least one
+      # threshold must be positive nonzero.
+      class BatchingSettingsProto
+        include Google::Apis::Core::Hashable
+      
+        # The duration after which a batch should be sent, starting from the addition of
+        # the first message to that batch.
+        # Corresponds to the JSON property `delayThreshold`
+        # @return [String]
+        attr_accessor :delay_threshold
+      
+        # The maximum number of elements collected in a batch that could be accepted by
+        # server.
+        # Corresponds to the JSON property `elementCountLimit`
+        # @return [Fixnum]
+        attr_accessor :element_count_limit
+      
+        # The number of elements of a field collected into a batch which, if exceeded,
+        # causes the batch to be sent.
+        # Corresponds to the JSON property `elementCountThreshold`
+        # @return [Fixnum]
+        attr_accessor :element_count_threshold
+      
+        # The maximum size of data allowed by flow control.
+        # Corresponds to the JSON property `flowControlByteLimit`
+        # @return [Fixnum]
+        attr_accessor :flow_control_byte_limit
+      
+        # The maximum number of elements allowed by flow control.
+        # Corresponds to the JSON property `flowControlElementLimit`
+        # @return [Fixnum]
+        attr_accessor :flow_control_element_limit
+      
+        # The behavior to take when the flow control limit is exceeded.
+        # Corresponds to the JSON property `flowControlLimitExceededBehavior`
+        # @return [String]
+        attr_accessor :flow_control_limit_exceeded_behavior
+      
+        # The maximum size of the request that could be accepted by server.
+        # Corresponds to the JSON property `requestByteLimit`
+        # @return [Fixnum]
+        attr_accessor :request_byte_limit
+      
+        # The aggregated size of the batched field which, if exceeded, causes the batch
+        # to be sent. This size is computed by aggregating the sizes of the request
+        # field to be batched, not of the entire request message.
+        # Corresponds to the JSON property `requestByteThreshold`
+        # @return [Fixnum]
+        attr_accessor :request_byte_threshold
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @delay_threshold = args[:delay_threshold] if args.key?(:delay_threshold)
+          @element_count_limit = args[:element_count_limit] if args.key?(:element_count_limit)
+          @element_count_threshold = args[:element_count_threshold] if args.key?(:element_count_threshold)
+          @flow_control_byte_limit = args[:flow_control_byte_limit] if args.key?(:flow_control_byte_limit)
+          @flow_control_element_limit = args[:flow_control_element_limit] if args.key?(:flow_control_element_limit)
+          @flow_control_limit_exceeded_behavior = args[:flow_control_limit_exceeded_behavior] if args.key?(:flow_control_limit_exceeded_behavior)
+          @request_byte_limit = args[:request_byte_limit] if args.key?(:request_byte_limit)
+          @request_byte_threshold = args[:request_byte_threshold] if args.key?(:request_byte_threshold)
+        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
@@ -713,7 +1074,9 @@ module Google
         # @return [Google::Apis::ServiceusageV1::RubySettings]
         attr_accessor :ruby_settings
       
-        # Version of the API to apply these settings to.
+        # Version of the API to apply these settings to. This is the full protobuf
+        # package for the API, ending in the version element. Examples: "google.cloud.
+        # speech.v1" and "google.spanner.admin.database.v1".
         # Corresponds to the JSON property `version`
         # @return [String]
         attr_accessor :version
@@ -753,6 +1116,13 @@ module Google
         # @return [String]
         attr_accessor :reference_docs_uri
       
+        # This message is used to configure the generation of a subset of the RPCs in a
+        # service for client libraries. Note: This feature should not be used in most
+        # cases.
+        # Corresponds to the JSON property `selectiveGapicGeneration`
+        # @return [Google::Apis::ServiceusageV1::SelectiveGapicGeneration]
+        attr_accessor :selective_gapic_generation
+      
         def initialize(**args)
            update!(**args)
         end
@@ -761,30 +1131,46 @@ module Google
         def update!(**args)
           @destinations = args[:destinations] if args.key?(:destinations)
           @reference_docs_uri = args[:reference_docs_uri] if args.key?(:reference_docs_uri)
+          @selective_gapic_generation = args[:selective_gapic_generation] if args.key?(:selective_gapic_generation)
         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 allowlist any protobuf message extension that can be
-      # sent in grpc metadata using “x-goog-ext--bin” and “x-goog-ext--jspb” format.
-      # For example, list any service specific protobuf types that can appear in grpc
-      # metadata as follows in your yaml file: Example: context: rules: - selector: "
-      # google.example.library.v1.LibraryService.CreateBook"
-      # allowed_request_extensions: - google.foo.v1.NewExtension
-      # allowed_response_extensions: - google.foo.v1.NewExtension You can also specify
-      # extension ID instead of fully qualified extension name here.
-      class Context
+      # Consumer Policy is a set of rules that define what services or service groups
+      # can be used for a cloud resource hierarchy.
+      class ConsumerPolicy
         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.
-        # Corresponds to the JSON property `rules`
-        # @return [Array<Google::Apis::ServiceusageV1::ContextRule>]
-        attr_accessor :rules
+        # Optional. Annotations is an unstructured key-value map stored with a policy
+        # that may be set by external tools to store and retrieve arbitrary metadata.
+        # They are not queryable and should be preserved when modifying objects. [AIP-
+        # 128](https://google.aip.dev/128#annotations)
+        # Corresponds to the JSON property `annotations`
+        # @return [Hash<String,String>]
+        attr_accessor :annotations
+      
+        # Enable rules define usable services and service groups.
+        # Corresponds to the JSON property `enableRules`
+        # @return [Array<Google::Apis::ServiceusageV1::EnableRule>]
+        attr_accessor :enable_rules
+      
+        # An opaque tag indicating the current version of the policy, used for
+        # concurrency control.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # Output only. The resource name of the policy. We only allow consumer policy
+        # name as `default` for now: `projects/12345/consumerPolicies/default`, `folders/
+        # 12345/consumerPolicies/default`, `organizations/12345/consumerPolicies/default`
+        # .
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The last-modified time.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
       
         def initialize(**args)
            update!(**args)
@@ -792,42 +1178,22 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @rules = args[:rules] if args.key?(:rules)
+          @annotations = args[:annotations] if args.key?(:annotations)
+          @enable_rules = args[:enable_rules] if args.key?(:enable_rules)
+          @etag = args[:etag] if args.key?(:etag)
+          @name = args[:name] if args.key?(:name)
+          @update_time = args[:update_time] if args.key?(:update_time)
         end
       end
       
-      # A context rule provides information about the context for an individual API
-      # element.
-      class ContextRule
+      # ContentSecurity defines the content security related fields of a MCP policy.
+      class ContentSecurity
         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.
-        # 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.
-        # Corresponds to the JSON property `allowedResponseExtensions`
-        # @return [Array<String>]
-        attr_accessor :allowed_response_extensions
-      
-        # A list of full type names of provided contexts.
-        # Corresponds to the JSON property `provided`
-        # @return [Array<String>]
-        attr_accessor :provided
-      
-        # A list of full type names of requested contexts.
-        # Corresponds to the JSON property `requested`
-        # @return [Array<String>]
-        attr_accessor :requested
-      
-        # 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
+        # List of content security providers that are enabled for content scanning.
+        # Corresponds to the JSON property `contentSecurityProviders`
+        # @return [Array<Google::Apis::ServiceusageV1::ContentSecurityProvider>]
+        attr_accessor :content_security_providers
       
         def initialize(**args)
            update!(**args)
@@ -835,7 +1201,137 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @allowed_request_extensions = args[:allowed_request_extensions] if args.key?(:allowed_request_extensions)
+          @content_security_providers = args[:content_security_providers] if args.key?(:content_security_providers)
+        end
+      end
+      
+      # Content Security Policy contains the content security related policy of a
+      # resource.
+      class ContentSecurityPolicy
+        include Google::Apis::Core::Hashable
+      
+        # ContentSecurity defines the content security related fields of a MCP policy.
+        # Corresponds to the JSON property `mcpContentSecurity`
+        # @return [Google::Apis::ServiceusageV1::ContentSecurity]
+        attr_accessor :mcp_content_security
+      
+        # Output only. The resource name of the policy. Only the `default` policy is
+        # supported. We allow the following formats: `projects/`PROJECT_NUMBER`/
+        # contentSecurityPolicies/default`, `projects/`PROJECT_ID`/
+        # contentSecurityPolicies/default`, We only support project level content
+        # security policy for now.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @mcp_content_security = args[:mcp_content_security] if args.key?(:mcp_content_security)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # ContentSecurityProvider contains the name of content security provider.
+      class ContentSecurityProvider
+        include Google::Apis::Core::Hashable
+      
+        # Name of security service for content scanning, such as Google Cloud Model
+        # Armor or supported third-party ISV solutions. If it is Google 1P service, the
+        # name should be prefixed with `services/`. If it is a 3P service, the format
+        # needs to be documented. The currently supported values are: - `services/
+        # modelarmor.googleapis.com` for Google Cloud Model Armor.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @name = args[:name] if args.key?(:name)
+        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 allowlist any protobuf message extension that can be
+      # sent in grpc metadata using “x-goog-ext--bin” and “x-goog-ext--jspb” format.
+      # For example, list any service specific protobuf types that can appear in grpc
+      # metadata as follows in your yaml file: Example: context: rules: - selector: "
+      # google.example.library.v1.LibraryService.CreateBook"
+      # allowed_request_extensions: - google.foo.v1.NewExtension
+      # allowed_response_extensions: - google.foo.v1.NewExtension You can also specify
+      # extension ID instead of fully qualified extension name here.
+      class Context
+        include Google::Apis::Core::Hashable
+      
+        # A list of RPC context rules that apply to individual API methods. **NOTE:**
+        # All service configuration rules follow "last one wins" order.
+        # Corresponds to the JSON property `rules`
+        # @return [Array<Google::Apis::ServiceusageV1::ContextRule>]
+        attr_accessor :rules
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @rules = args[:rules] if args.key?(:rules)
+        end
+      end
+      
+      # A context rule provides information about the context for an individual API
+      # element.
+      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.
+        # 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.
+        # Corresponds to the JSON property `allowedResponseExtensions`
+        # @return [Array<String>]
+        attr_accessor :allowed_response_extensions
+      
+        # A list of full type names of provided contexts. It is used to support
+        # propagating HTTP headers and ETags from the response extension.
+        # Corresponds to the JSON property `provided`
+        # @return [Array<String>]
+        attr_accessor :provided
+      
+        # A list of full type names of requested contexts, only the requested context
+        # will be made available to the backend.
+        # Corresponds to the JSON property `requested`
+        # @return [Array<String>]
+        attr_accessor :requested
+      
+        # 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
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @allowed_request_extensions = args[:allowed_request_extensions] if args.key?(:allowed_request_extensions)
           @allowed_response_extensions = args[:allowed_response_extensions] if args.key?(:allowed_response_extensions)
           @provided = args[:provided] if args.key?(:provided)
           @requested = args[:requested] if args.key?(:requested)
@@ -848,13 +1344,18 @@ module Google
       class Control
         include Google::Apis::Core::Hashable
       
-        # The service controller environment to use. If empty, no control plane feature (
-        # like quota and billing) will be enabled. The recommended value for most
-        # services is servicecontrol.googleapis.com
+        # The service controller environment to use. If empty, no control plane features
+        # (like quota and billing) will be enabled. The recommended value for most
+        # services is servicecontrol.googleapis.com.
         # Corresponds to the JSON property `environment`
         # @return [String]
         attr_accessor :environment
       
+        # Defines policies applying to the API methods of the service.
+        # Corresponds to the JSON property `methodPolicies`
+        # @return [Array<Google::Apis::ServiceusageV1::MethodPolicy>]
+        attr_accessor :method_policies
+      
         def initialize(**args)
            update!(**args)
         end
@@ -862,6 +1363,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @environment = args[:environment] if args.key?(:environment)
+          @method_policies = args[:method_policies] if args.key?(:method_policies)
         end
       end
       
@@ -1050,7 +1552,7 @@ module Google
       # 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 ==)
+      # ) 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,
@@ -1075,6 +1577,12 @@ module Google
       class Documentation
         include Google::Apis::Core::Hashable
       
+        # Optional information about the IAM configuration. This is typically used to
+        # link to documentation about a product's IAM roles and permissions.
+        # Corresponds to the JSON property `additionalIamInfo`
+        # @return [String]
+        attr_accessor :additional_iam_info
+      
         # The URL to the root of documentation.
         # Corresponds to the JSON property `documentationRootUrl`
         # @return [String]
@@ -1100,6 +1608,12 @@ module Google
         # @return [Array<Google::Apis::ServiceusageV1::DocumentationRule>]
         attr_accessor :rules
       
+        # Specifies section and content to override the boilerplate content. Currently
+        # overrides following sections: 1. rest.service.client_libraries
+        # Corresponds to the JSON property `sectionOverrides`
+        # @return [Array<Google::Apis::ServiceusageV1::Page>]
+        attr_accessor :section_overrides
+      
         # 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.
@@ -1120,10 +1634,12 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @additional_iam_info = args[:additional_iam_info] if args.key?(:additional_iam_info)
           @documentation_root_url = args[:documentation_root_url] if args.key?(:documentation_root_url)
           @overview = args[:overview] if args.key?(:overview)
           @pages = args[:pages] if args.key?(:pages)
           @rules = args[:rules] if args.key?(:rules)
+          @section_overrides = args[:section_overrides] if args.key?(:section_overrides)
           @service_root_url = args[:service_root_url] if args.key?(:service_root_url)
           @summary = args[:summary] if args.key?(:summary)
         end
@@ -1146,6 +1662,12 @@ module Google
         # @return [String]
         attr_accessor :description
       
+        # String of comma or space separated case-sensitive words for which method/field
+        # name replacement will be disabled.
+        # Corresponds to the JSON property `disableReplacementWords`
+        # @return [String]
+        attr_accessor :disable_replacement_words
+      
         # The selector is a comma-separated list of patterns for any element such as a
         # method, a field, an enum value. Each pattern is a qualified name of the
         # element which may end in "*", indicating a wildcard. Wildcards are only
@@ -1165,6 +1687,7 @@ module Google
         def update!(**args)
           @deprecation_description = args[:deprecation_description] if args.key?(:deprecation_description)
           @description = args[:description] if args.key?(:description)
+          @disable_replacement_words = args[:disable_replacement_words] if args.key?(:disable_replacement_words)
           @selector = args[:selector] if args.key?(:selector)
         end
       end
@@ -1178,6 +1701,42 @@ module Google
         # @return [Google::Apis::ServiceusageV1::CommonLanguageSettings]
         attr_accessor :common
       
+        # Namespaces which must be aliased in snippets due to a known (but non-generator-
+        # predictable) naming collision
+        # Corresponds to the JSON property `forcedNamespaceAliases`
+        # @return [Array<String>]
+        attr_accessor :forced_namespace_aliases
+      
+        # Method signatures (in the form "service.method(signature)") which are provided
+        # separately, so shouldn't be generated. Snippets *calling* these methods are
+        # still generated, however.
+        # Corresponds to the JSON property `handwrittenSignatures`
+        # @return [Array<String>]
+        attr_accessor :handwritten_signatures
+      
+        # List of full resource types to ignore during generation. This is typically
+        # used for API-specific Location resources, which should be handled by the
+        # generator as if they were actually the common Location resources. Example
+        # entry: "documentai.googleapis.com/Location"
+        # Corresponds to the JSON property `ignoredResources`
+        # @return [Array<String>]
+        attr_accessor :ignored_resources
+      
+        # Map from full resource types to the effective short name for the resource.
+        # This is used when otherwise resource named from different services would cause
+        # naming collisions. Example entry: "datalabeling.googleapis.com/Dataset": "
+        # DataLabelingDataset"
+        # Corresponds to the JSON property `renamedResources`
+        # @return [Hash<String,String>]
+        attr_accessor :renamed_resources
+      
+        # Map from original service names to renamed versions. This is used when the
+        # default generated types would cause a naming conflict. (Neither name is fully-
+        # qualified.) Example: Subscriber to SubscriberServiceApi.
+        # Corresponds to the JSON property `renamedServices`
+        # @return [Hash<String,String>]
+        attr_accessor :renamed_services
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1185,6 +1744,11 @@ module Google
         # Update properties of this object
         def update!(**args)
           @common = args[:common] if args.key?(:common)
+          @forced_namespace_aliases = args[:forced_namespace_aliases] if args.key?(:forced_namespace_aliases)
+          @handwritten_signatures = args[:handwritten_signatures] if args.key?(:handwritten_signatures)
+          @ignored_resources = args[:ignored_resources] if args.key?(:ignored_resources)
+          @renamed_resources = args[:renamed_resources] if args.key?(:renamed_resources)
+          @renamed_services = args[:renamed_services] if args.key?(:renamed_services)
         end
       end
       
@@ -1229,6 +1793,48 @@ module Google
         end
       end
       
+      # The consumer policy rule that defines usable services and service groups.
+      class EnableRule
+        include Google::Apis::Core::Hashable
+      
+        # Client and resource project enable type.
+        # Corresponds to the JSON property `enableType`
+        # @return [String]
+        attr_accessor :enable_type
+      
+        # DEPRECATED: Please use field `values`. Service group should have prefix `
+        # groups/`. The names of the service groups that are enabled (Not Implemented).
+        # Example: `groups/googleServices`.
+        # Corresponds to the JSON property `groups`
+        # @return [Array<String>]
+        attr_accessor :groups
+      
+        # DEPRECATED: Please use field `values`. Service should have prefix `services/`.
+        # The names of the services that are enabled. Example: `storage.googleapis.com`.
+        # Corresponds to the JSON property `services`
+        # @return [Array<String>]
+        attr_accessor :services
+      
+        # The names of the services or service groups that are enabled. Example: `
+        # services/storage.googleapis.com`, `groups/googleServices`, `groups/allServices`
+        # .
+        # Corresponds to the JSON property `values`
+        # @return [Array<String>]
+        attr_accessor :values
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @enable_type = args[:enable_type] if args.key?(:enable_type)
+          @groups = args[:groups] if args.key?(:groups)
+          @services = args[:services] if args.key?(:services)
+          @values = args[:values] if args.key?(:values)
+        end
+      end
+      
       # Request message for the `EnableService` method.
       class EnableServiceRequest
         include Google::Apis::Core::Hashable
@@ -1278,9 +1884,9 @@ module Google
       class Endpoint
         include Google::Apis::Core::Hashable
       
-        # Unimplemented. Dot not use. DEPRECATED: This field is no longer supported.
-        # Instead of using aliases, please specify multiple google.api.Endpoint for each
-        # of the intended aliases. Additional names that this endpoint will be hosted on.
+        # Aliases for this endpoint, these will be served by the same UrlMap as the
+        # parent endpoint, and will be provisioned in the GCP stack for the Regional
+        # Endpoints.
         # Corresponds to the JSON property `aliases`
         # @return [Array<String>]
         attr_accessor :aliases
@@ -1321,10 +1927,19 @@ module Google
         end
       end
       
-      # Enum type definition.
+      # Enum type definition. New usages of this message as an alternative to
+      # EnumDescriptorProto are strongly discouraged. This message does not
+      # reliability preserve all information necessary to model the schema and
+      # preserve semantics. Instead make use of FileDescriptorSet which preserves the
+      # necessary information.
       class Enum
         include Google::Apis::Core::Hashable
       
+        # The source edition string, only valid when syntax is SYNTAX_EDITIONS.
+        # Corresponds to the JSON property `edition`
+        # @return [String]
+        attr_accessor :edition
+      
         # Enum value definitions.
         # Corresponds to the JSON property `enumvalue`
         # @return [Array<Google::Apis::ServiceusageV1::EnumValue>]
@@ -1357,6 +1972,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @edition = args[:edition] if args.key?(:edition)
           @enumvalue = args[:enumvalue] if args.key?(:enumvalue)
           @name = args[:name] if args.key?(:name)
           @options = args[:options] if args.key?(:options)
@@ -1365,7 +1981,11 @@ module Google
         end
       end
       
-      # Enum value definition.
+      # Enum value definition. New usages of this message as an alternative to
+      # EnumValueDescriptorProto are strongly discouraged. This message does not
+      # reliability preserve all information necessary to model the schema and
+      # preserve semantics. Instead make use of FileDescriptorSet which preserves the
+      # necessary information.
       class EnumValue
         include Google::Apis::Core::Hashable
       
@@ -1396,7 +2016,54 @@ module Google
         end
       end
       
-      # A single field of a message type.
+      # Experimental features to be included during client library generation. These
+      # fields will be deprecated once the feature graduates and is enabled by default.
+      class ExperimentalFeatures
+        include Google::Apis::Core::Hashable
+      
+        # Enables generation of protobuf code using new types that are more Pythonic
+        # which are included in `protobuf>=5.29.x`. This feature will be enabled by
+        # default 1 month after launching the feature in preview packages.
+        # Corresponds to the JSON property `protobufPythonicTypesEnabled`
+        # @return [Boolean]
+        attr_accessor :protobuf_pythonic_types_enabled
+        alias_method :protobuf_pythonic_types_enabled?, :protobuf_pythonic_types_enabled
+      
+        # Enables generation of asynchronous REST clients if `rest` transport is enabled.
+        # By default, asynchronous REST clients will not be generated. This feature
+        # will be enabled by default 1 month after launching the feature in preview
+        # packages.
+        # Corresponds to the JSON property `restAsyncIoEnabled`
+        # @return [Boolean]
+        attr_accessor :rest_async_io_enabled
+        alias_method :rest_async_io_enabled?, :rest_async_io_enabled
+      
+        # Disables generation of an unversioned Python package for this client library.
+        # This means that the module names will need to be versioned in import
+        # statements. For example `import google.cloud.library_v2` instead of `import
+        # google.cloud.library`.
+        # Corresponds to the JSON property `unversionedPackageDisabled`
+        # @return [Boolean]
+        attr_accessor :unversioned_package_disabled
+        alias_method :unversioned_package_disabled?, :unversioned_package_disabled
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @protobuf_pythonic_types_enabled = args[:protobuf_pythonic_types_enabled] if args.key?(:protobuf_pythonic_types_enabled)
+          @rest_async_io_enabled = args[:rest_async_io_enabled] if args.key?(:rest_async_io_enabled)
+          @unversioned_package_disabled = args[:unversioned_package_disabled] if args.key?(:unversioned_package_disabled)
+        end
+      end
+      
+      # A single field of a message type. New usages of this message as an alternative
+      # to FieldDescriptorProto are strongly discouraged. This message does not
+      # reliability preserve all information necessary to model the schema and
+      # preserve semantics. Instead make use of FileDescriptorSet which preserves the
+      # necessary information.
       class Field
         include Google::Apis::Core::Hashable
       
@@ -1472,6 +2139,50 @@ module Google
         end
       end
       
+      # Google API Policy Annotation This message defines a simple API policy
+      # annotation that can be used to annotate API request and response message
+      # fields with applicable policies. One field may have multiple applicable
+      # policies that must all be satisfied before a request can be processed. This
+      # policy annotation is used to generate the overall policy that will be used for
+      # automatic runtime policy enforcement and documentation generation.
+      class FieldPolicy
+        include Google::Apis::Core::Hashable
+      
+        # Specifies the required permission(s) for the resource referred to by the field.
+        # It requires the field contains a valid resource reference, and the request
+        # must pass the permission checks to proceed. For example, "resourcemanager.
+        # projects.get".
+        # Corresponds to the JSON property `resourcePermission`
+        # @return [String]
+        attr_accessor :resource_permission
+      
+        # Specifies the resource type for the resource referred to by the field.
+        # Corresponds to the JSON property `resourceType`
+        # @return [String]
+        attr_accessor :resource_type
+      
+        # Selects one or more request or response message fields to apply this `
+        # FieldPolicy`. When a `FieldPolicy` is used in proto annotation, the selector
+        # must be left as empty. The service config generator will automatically fill
+        # the correct value. When a `FieldPolicy` is used in service config, the
+        # selector must be a comma-separated string with valid request or response field
+        # paths, such as "foo.bar" or "foo.bar,foo.baz".
+        # Corresponds to the JSON property `selector`
+        # @return [String]
+        attr_accessor :selector
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @resource_permission = args[:resource_permission] if args.key?(:resource_permission)
+          @resource_type = args[:resource_type] if args.key?(:resource_type)
+          @selector = args[:selector] if args.key?(:selector)
+        end
+      end
+      
       # Metadata for the `GetServiceIdentity` method.
       class GetServiceIdentityMetadata
         include Google::Apis::Core::Hashable
@@ -1520,6 +2231,14 @@ module Google
         # @return [Google::Apis::ServiceusageV1::CommonLanguageSettings]
         attr_accessor :common
       
+        # Map of service names to renamed services. Keys are the package relative
+        # service names and values are the name to be used for the service client and
+        # call options. Example: publishing: go_settings: renamed_services: Publisher:
+        # TopicAdmin
+        # Corresponds to the JSON property `renamedServices`
+        # @return [Hash<String,String>]
+        attr_accessor :renamed_services
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1527,6 +2246,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @common = args[:common] if args.key?(:common)
+          @renamed_services = args[:renamed_services] if args.key?(:renamed_services)
         end
       end
       
@@ -1555,6 +2275,14 @@ module Google
         # @return [Array<Google::Apis::ServiceusageV1::Api>]
         attr_accessor :apis
       
+        # Configuration aspects. This is a repeated field to allow multiple aspects to
+        # be configured. The kind field in each ConfigAspect specifies the type of
+        # aspect. The spec field contains the configuration for that aspect. The schema
+        # for the spec field is defined by the backend service owners.
+        # Corresponds to the JSON property `aspects`
+        # @return [Array<Google::Apis::ServiceusageV1::Aspect>]
+        attr_accessor :aspects
+      
         # `Authentication` defines the authentication configuration for API methods
         # provided by an API service. Example: name: calendar.googleapis.com
         # authentication: providers: - id: google_calendar_auth jwks_uri: https://www.
@@ -1631,7 +2359,7 @@ module Google
         # 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 ==)
+        # ) 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,
@@ -1712,8 +2440,8 @@ module Google
         # @return [Array<Google::Apis::ServiceusageV1::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::ServiceusageV1::MonitoredResourceDescriptor>]
         attr_accessor :monitored_resources
@@ -1834,6 +2562,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @apis = args[:apis] if args.key?(:apis)
+          @aspects = args[:aspects] if args.key?(:aspects)
           @authentication = args[:authentication] if args.key?(:authentication)
           @backend = args[:backend] if args.key?(:backend)
           @billing = args[:billing] if args.key?(:billing)
@@ -1946,7 +2675,7 @@ module Google
         # 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 ==)
+        # ) 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,
@@ -1972,82 +2701,505 @@ module Google
         # @return [Google::Apis::ServiceusageV1::Documentation]
         attr_accessor :documentation
       
-        # Configuration for network endpoints. Contains only the names and aliases of
-        # the endpoints.
-        # Corresponds to the JSON property `endpoints`
-        # @return [Array<Google::Apis::ServiceusageV1::Endpoint>]
-        attr_accessor :endpoints
+        # Configuration for network endpoints. Contains only the names and aliases of
+        # the endpoints.
+        # Corresponds to the JSON property `endpoints`
+        # @return [Array<Google::Apis::ServiceusageV1::Endpoint>]
+        attr_accessor :endpoints
+      
+        # 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::ServiceusageV1::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
+        # Corresponds to the JSON property `monitoring`
+        # @return [Google::Apis::ServiceusageV1::Monitoring]
+        attr_accessor :monitoring
+      
+        # The DNS address at which this service is available. An example DNS address
+        # would be: `calendar.googleapis.com`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # 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::ServiceusageV1::Quota]
+        attr_accessor :quota
+      
+        # The product title for this service.
+        # Corresponds to the JSON property `title`
+        # @return [String]
+        attr_accessor :title
+      
+        # Configuration controlling usage of a service.
+        # Corresponds to the JSON property `usage`
+        # @return [Google::Apis::ServiceusageV1::Usage]
+        attr_accessor :usage
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @apis = args[:apis] if args.key?(:apis)
+          @authentication = args[:authentication] if args.key?(:authentication)
+          @documentation = args[:documentation] if args.key?(:documentation)
+          @endpoints = args[:endpoints] if args.key?(:endpoints)
+          @monitored_resources = args[:monitored_resources] if args.key?(:monitored_resources)
+          @monitoring = args[:monitoring] if args.key?(:monitoring)
+          @name = args[:name] if args.key?(:name)
+          @quota = args[:quota] if args.key?(:quota)
+          @title = args[:title] if args.key?(:title)
+          @usage = args[:usage] if args.key?(:usage)
+        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
+      
+      # Consumer Policy is a set of rules that define what services or service groups
+      # can be used for a cloud resource hierarchy.
+      class GoogleApiServiceusageV2alphaConsumerPolicy
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Annotations is an unstructured key-value map stored with a policy
+        # that may be set by external tools to store and retrieve arbitrary metadata.
+        # They are not queryable and should be preserved when modifying objects. [AIP-
+        # 128](https://google.aip.dev/128#annotations)
+        # Corresponds to the JSON property `annotations`
+        # @return [Hash<String,String>]
+        attr_accessor :annotations
+      
+        # Output only. The time the policy was created. For singleton policies, this is
+        # the first touch of the policy.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Enable rules define usable services, groups, and categories. There can
+        # currently be at most one `EnableRule`. This restriction will be lifted in
+        # later releases.
+        # Corresponds to the JSON property `enableRules`
+        # @return [Array<Google::Apis::ServiceusageV1::GoogleApiServiceusageV2alphaEnableRule>]
+        attr_accessor :enable_rules
+      
+        # Output only. An opaque tag indicating the current version of the policy, used
+        # for concurrency control.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # Output only. The resource name of the policy. Only the `default` policy is
+        # supported: `projects/12345/consumerPolicies/default`, `folders/12345/
+        # consumerPolicies/default`, `organizations/12345/consumerPolicies/default`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Output only. The time the policy was last updated.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @annotations = args[:annotations] if args.key?(:annotations)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @enable_rules = args[:enable_rules] if args.key?(:enable_rules)
+          @etag = args[:etag] if args.key?(:etag)
+          @name = args[:name] if args.key?(:name)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # The consumer policy rule that defines enabled services, groups, and categories.
+      class GoogleApiServiceusageV2alphaEnableRule
+        include Google::Apis::Core::Hashable
+      
+        # The names of the services that are enabled. Example: `services/storage.
+        # googleapis.com`.
+        # Corresponds to the JSON property `services`
+        # @return [Array<String>]
+        attr_accessor :services
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @services = args[:services] if args.key?(:services)
+        end
+      end
+      
+      # Metadata for the `UpdateConsumerPolicy` method.
+      class GoogleApiServiceusageV2alphaUpdateConsumerPolicyMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # A message to group the analysis information.
+      class GoogleApiServiceusageV2betaAnalysis
+        include Google::Apis::Core::Hashable
+      
+        # An analysis result including blockers and warnings.
+        # Corresponds to the JSON property `analysisResult`
+        # @return [Google::Apis::ServiceusageV1::GoogleApiServiceusageV2betaAnalysisResult]
+        attr_accessor :analysis_result
+      
+        # Output only. The type of analysis.
+        # Corresponds to the JSON property `analysisType`
+        # @return [String]
+        attr_accessor :analysis_type
+      
+        # Output only. The user friendly display name of the analysis type. E.g. service
+        # dependency analysis, service resource usage analysis, etc.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # The names of the service that has analysis result of warnings or blockers.
+        # Example: `services/storage.googleapis.com`.
+        # Corresponds to the JSON property `service`
+        # @return [String]
+        attr_accessor :service
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @analysis_result = args[:analysis_result] if args.key?(:analysis_result)
+          @analysis_type = args[:analysis_type] if args.key?(:analysis_type)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @service = args[:service] if args.key?(:service)
+        end
+      end
+      
+      # An analysis result including blockers and warnings.
+      class GoogleApiServiceusageV2betaAnalysisResult
+        include Google::Apis::Core::Hashable
+      
+        # Blocking information that would prevent the policy changes at runtime.
+        # Corresponds to the JSON property `blockers`
+        # @return [Array<Google::Apis::ServiceusageV1::GoogleApiServiceusageV2betaImpact>]
+        attr_accessor :blockers
+      
+        # Warning information indicating that the policy changes might be unsafe, but
+        # will not block the changes at runtime.
+        # Corresponds to the JSON property `warnings`
+        # @return [Array<Google::Apis::ServiceusageV1::GoogleApiServiceusageV2betaImpact>]
+        attr_accessor :warnings
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @blockers = args[:blockers] if args.key?(:blockers)
+          @warnings = args[:warnings] if args.key?(:warnings)
+        end
+      end
+      
+      # Metadata for the `AnalyzeConsumerPolicy` method.
+      class GoogleApiServiceusageV2betaAnalyzeConsumerPolicyMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # The response of analyzing a consumer policy update.
+      class GoogleApiServiceusageV2betaAnalyzeConsumerPolicyResponse
+        include Google::Apis::Core::Hashable
+      
+        # The list of analyses returned from performing the intended policy update
+        # analysis. The analysis is grouped by service name and different analysis types.
+        # The empty analysis list means that the consumer policy can be updated without
+        # any warnings or blockers.
+        # Corresponds to the JSON property `analysis`
+        # @return [Array<Google::Apis::ServiceusageV1::GoogleApiServiceusageV2betaAnalysis>]
+        attr_accessor :analysis
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @analysis = args[:analysis] if args.key?(:analysis)
+        end
+      end
+      
+      # Consumer Policy is a set of rules that define what services or service groups
+      # can be used for a cloud resource hierarchy.
+      class GoogleApiServiceusageV2betaConsumerPolicy
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The time the policy was created. For singleton policies, this is
+        # the first touch of the policy.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Enable rules define usable services, groups, and categories. There can
+        # currently be at most one `EnableRule`. This restriction will be lifted in
+        # later releases.
+        # Corresponds to the JSON property `enableRules`
+        # @return [Array<Google::Apis::ServiceusageV1::GoogleApiServiceusageV2betaEnableRule>]
+        attr_accessor :enable_rules
+      
+        # An opaque tag indicating the current version of the policy, used for
+        # concurrency control.
+        # Corresponds to the JSON property `etag`
+        # @return [String]
+        attr_accessor :etag
+      
+        # Output only. The resource name of the policy. Only the `default` policy is
+        # supported: `projects/12345/consumerPolicies/default`, `folders/12345/
+        # consumerPolicies/default`, `organizations/12345/consumerPolicies/default`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Output only. The time the policy was last updated.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @enable_rules = args[:enable_rules] if args.key?(:enable_rules)
+          @etag = args[:etag] if args.key?(:etag)
+          @name = args[:name] if args.key?(:name)
+          @update_time = args[:update_time] if args.key?(:update_time)
+        end
+      end
+      
+      # The consumer policy rule that defines enabled services, groups, and categories.
+      class GoogleApiServiceusageV2betaEnableRule
+        include Google::Apis::Core::Hashable
+      
+        # The names of the services that are enabled. Example: `services/storage.
+        # googleapis.com`.
+        # Corresponds to the JSON property `services`
+        # @return [Array<String>]
+        attr_accessor :services
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @services = args[:services] if args.key?(:services)
+        end
+      end
+      
+      # A message to group impacts of updating a policy.
+      class GoogleApiServiceusageV2betaImpact
+        include Google::Apis::Core::Hashable
+      
+        # Output only. User friendly impact detail in a free form message.
+        # Corresponds to the JSON property `detail`
+        # @return [String]
+        attr_accessor :detail
+      
+        # Output only. The type of impact.
+        # Corresponds to the JSON property `impactType`
+        # @return [String]
+        attr_accessor :impact_type
+      
+        # Output only. This field will be populated only for the `
+        # DEPENDENCY_MISSING_DEPENDENCIES` impact type. Example: `services/compute.
+        # googleapis.com`. Impact.detail will be in format : `missing service dependency:
+        # `missing_dependency`.`
+        # Corresponds to the JSON property `missingDependency`
+        # @return [String]
+        attr_accessor :missing_dependency
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @detail = args[:detail] if args.key?(:detail)
+          @impact_type = args[:impact_type] if args.key?(:impact_type)
+          @missing_dependency = args[:missing_dependency] if args.key?(:missing_dependency)
+        end
+      end
+      
+      # McpEnableRule contains MCP enablement related rules.
+      class GoogleApiServiceusageV2betaMcpEnableRule
+        include Google::Apis::Core::Hashable
+      
+        # List of enabled MCP services.
+        # Corresponds to the JSON property `mcpServices`
+        # @return [Array<Google::Apis::ServiceusageV1::GoogleApiServiceusageV2betaMcpService>]
+        attr_accessor :mcp_services
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @mcp_services = args[:mcp_services] if args.key?(:mcp_services)
+        end
+      end
       
-        # 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::ServiceusageV1::MonitoredResourceDescriptor>]
-        attr_accessor :monitored_resources
+      # MCP Consumer Policy is a set of rules that define MCP related policy for a
+      # cloud resource hierarchy.
+      class GoogleApiServiceusageV2betaMcpPolicy
+        include Google::Apis::Core::Hashable
       
-        # 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::ServiceusageV1::Monitoring]
-        attr_accessor :monitoring
+        # Output only. The time the policy was created. For singleton policies (such as
+        # the `default` policy), this is the first touch of the policy.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
       
-        # The DNS address at which this service is available. An example DNS address
-        # would be: `calendar.googleapis.com`.
-        # Corresponds to the JSON property `name`
+        # An opaque tag indicating the current version of the policy, used for
+        # concurrency control.
+        # Corresponds to the JSON property `etag`
         # @return [String]
-        attr_accessor :name
+        attr_accessor :etag
       
-        # 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::ServiceusageV1::Quota]
-        attr_accessor :quota
+        # McpEnableRules contains MCP enablement related rules.
+        # Corresponds to the JSON property `mcpEnableRules`
+        # @return [Array<Google::Apis::ServiceusageV1::GoogleApiServiceusageV2betaMcpEnableRule>]
+        attr_accessor :mcp_enable_rules
       
-        # The product title for this service.
-        # Corresponds to the JSON property `title`
+        # Output only. The resource name of the policy. Only the `default` policy is
+        # supported. We allow the following formats: `projects/`PROJECT_NUMBER`/
+        # mcpPolicies/default`, `projects/`PROJECT_ID`/mcpPolicies/default`, `folders/`
+        # FOLDER_ID`/mcpPolicies/default`, `organizations/`ORG_ID`/mcpPolicies/default`.
+        # Corresponds to the JSON property `name`
         # @return [String]
-        attr_accessor :title
+        attr_accessor :name
       
-        # Configuration controlling usage of a service.
-        # Corresponds to the JSON property `usage`
-        # @return [Google::Apis::ServiceusageV1::Usage]
-        attr_accessor :usage
+        # Output only. The time the policy was last updated.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
       
         def initialize(**args)
            update!(**args)
@@ -2055,33 +3207,23 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @apis = args[:apis] if args.key?(:apis)
-          @authentication = args[:authentication] if args.key?(:authentication)
-          @documentation = args[:documentation] if args.key?(:documentation)
-          @endpoints = args[:endpoints] if args.key?(:endpoints)
-          @monitored_resources = args[:monitored_resources] if args.key?(:monitored_resources)
-          @monitoring = args[:monitoring] if args.key?(:monitoring)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @etag = args[:etag] if args.key?(:etag)
+          @mcp_enable_rules = args[:mcp_enable_rules] if args.key?(:mcp_enable_rules)
           @name = args[:name] if args.key?(:name)
-          @quota = args[:quota] if args.key?(:quota)
-          @title = args[:title] if args.key?(:title)
-          @usage = args[:usage] if args.key?(:usage)
+          @update_time = args[:update_time] if args.key?(:update_time)
         end
       end
       
-      # Response message for getting service identity.
-      class GoogleApiServiceusageV1beta1GetServiceIdentityResponse
+      # McpService contains the service names that are enabled for MCP.
+      class GoogleApiServiceusageV2betaMcpService
         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`
+        # The names of the services that are enabled for MCP. Example: `services/library-
+        # example.googleapis.com`
+        # Corresponds to the JSON property `service`
         # @return [String]
-        attr_accessor :state
+        attr_accessor :service
       
         def initialize(**args)
            update!(**args)
@@ -2089,27 +3231,26 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @identity = args[:identity] if args.key?(:identity)
-          @state = args[:state] if args.key?(:state)
+          @service = args[:service] if args.key?(:service)
         end
       end
       
-      # Service identity for a service. This is the identity that service producer
-      # should use to access consumer resources.
-      class GoogleApiServiceusageV1beta1ServiceIdentity
+      # Metadata for the `UpdateConsumerPolicy` method.
+      class GoogleApiServiceusageV2betaUpdateConsumerPolicyMetadata
         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
+        def initialize(**args)
+           update!(**args)
+        end
       
-        # 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
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Metadata for the `UpdateMcpPolicy` method.
+      class GoogleApiServiceusageV2betaUpdateMcpPolicyMetadata
+        include Google::Apis::Core::Hashable
       
         def initialize(**args)
            update!(**args)
@@ -2117,8 +3258,6 @@ module Google
       
         # 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
       
@@ -2154,7 +3293,7 @@ module Google
         end
       end
       
-      # # gRPC Transcoding gRPC Transcoding is a feature for mapping between a gRPC
+      # 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
@@ -2174,70 +3313,69 @@ module Google
       # 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
+      # REST to gRPC mapping as below: - HTTP: `GET /v1/messages/123456` - gRPC: `
+      # 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: `GET /v1/messages/123456?
+      # revision=2&sub.subfield=foo` - gRPC: `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: `PATCH /v1/messages/123456 ` "text": "Hi!" `` - gRPC: `
+      # 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: `PATCH /v1/messages/123456 ` "text": "Hi!" `` - gRPC: `
+      # 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: `GET /
+      # v1/messages/123456` - gRPC: `GetMessage(message_id: "123456")` - HTTP: `GET /
+      # v1/users/me/messages/123456` - gRPC: `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,
@@ -2252,7 +3390,7 @@ module Google
       # 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
+      # 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.
@@ -2262,27 +3400,27 @@ module Google
       # 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.
+      # the proto. The following example selects a gRPC method and applies an `
+      # HttpRule` to it: http: rules: - 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
       
@@ -2364,6 +3502,44 @@ module Google
         end
       end
       
+      # A message to group impacts of updating a policy.
+      class Impact
+        include Google::Apis::Core::Hashable
+      
+        # Output only. User friendly impact detail in a free form message.
+        # Corresponds to the JSON property `detail`
+        # @return [String]
+        attr_accessor :detail
+      
+        # Output only. The type of impact.
+        # Corresponds to the JSON property `impactType`
+        # @return [String]
+        attr_accessor :impact_type
+      
+        # The parent resource that the analysis is based on and the service name that
+        # the analysis is for. Example: `projects/100/services/compute.googleapis.com`,
+        # folders/101/services/compute.googleapis.com` and `organizations/102/services/
+        # compute.googleapis.com`. Usually, the parent resource here is same as the
+        # parent resource of the analyzed policy. However, for some analysis types, the
+        # parent can be different. For example, for resource existence analysis, if the
+        # parent resource of the analyzed policy is a folder or an organization, the
+        # parent resource here can still be the project that contains the resources.
+        # Corresponds to the JSON property `parent`
+        # @return [String]
+        attr_accessor :parent
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @detail = args[:detail] if args.key?(:detail)
+          @impact_type = args[:impact_type] if args.key?(:impact_type)
+          @parent = args[:parent] if args.key?(:parent)
+        end
+      end
+      
       # Metadata message that provides information such as progress, partial failures,
       # and similar information on each GetOperation call of LRO returned by
       # ImportAdminOverrides.
@@ -2479,8 +3655,8 @@ module Google
         # protobuf. This should be used **only** by APIs who have already set the
         # language_settings.java.package_name" field in gapic.yaml. API teams should use
         # the protobuf java_package option where possible. Example of a YAML
-        # configuration:: publishing: java_settings: library_package: com.google.cloud.
-        # pubsub.v1
+        # configuration:: publishing: library_settings: java_settings: library_package:
+        # com.google.cloud.pubsub.v1
         # Corresponds to the JSON property `libraryPackage`
         # @return [String]
         attr_accessor :library_package
@@ -2595,6 +3771,14 @@ module Google
         # @return [Array<Google::Apis::ServiceusageV1::Operation>]
         attr_accessor :operations
       
+        # Unordered list. Unreachable resources. Populated when the request sets `
+        # ListOperationsRequest.return_partial_success` and reads across collections.
+        # For example, when attempting to list all resources across all supported
+        # locations.
+        # Corresponds to the JSON property `unreachable`
+        # @return [Array<String>]
+        attr_accessor :unreachable
+      
         def initialize(**args)
            update!(**args)
         end
@@ -2603,6 +3787,7 @@ module Google
         def update!(**args)
           @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
           @operations = args[:operations] if args.key?(:operations)
+          @unreachable = args[:unreachable] if args.key?(:unreachable)
         end
       end
       
@@ -2788,10 +3973,21 @@ module Google
         end
       end
       
-      # Method represents a method of an API interface.
+      # Method represents a method of an API interface. New usages of this message as
+      # an alternative to MethodDescriptorProto are strongly discouraged. This message
+      # does not reliability preserve all information necessary to model the schema
+      # and preserve semantics. Instead make use of FileDescriptorSet which preserves
+      # the necessary information.
       class MethodProp
         include Google::Apis::Core::Hashable
       
+        # The source edition string, only valid when syntax is SYNTAX_EDITIONS. This
+        # field should be ignored, instead the edition should be inherited from Api.
+        # This is similar to Field and EnumValue.
+        # Corresponds to the JSON property `edition`
+        # @return [String]
+        attr_accessor :edition
+      
         # The simple name of this method.
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -2824,7 +4020,8 @@ module Google
         # @return [String]
         attr_accessor :response_type_url
       
-        # The source syntax of this method.
+        # The source syntax of this method. This field should be ignored, instead the
+        # syntax should be inherited from Api. This is similar to Field and EnumValue.
         # Corresponds to the JSON property `syntax`
         # @return [String]
         attr_accessor :syntax
@@ -2835,6 +4032,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @edition = args[:edition] if args.key?(:edition)
           @name = args[:name] if args.key?(:name)
           @options = args[:options] if args.key?(:options)
           @request_streaming = args[:request_streaming] if args.key?(:request_streaming)
@@ -2845,10 +4043,52 @@ module Google
         end
       end
       
+      # Defines policies applying to an RPC method.
+      class MethodPolicy
+        include Google::Apis::Core::Hashable
+      
+        # Policies that are applicable to the request message.
+        # Corresponds to the JSON property `requestPolicies`
+        # @return [Array<Google::Apis::ServiceusageV1::FieldPolicy>]
+        attr_accessor :request_policies
+      
+        # Selects a method to which these policies should be enforced, for example, "
+        # google.pubsub.v1.Subscriber.CreateSubscription". Refer to selector for syntax
+        # details. NOTE: This field must not be set in the proto annotation. It will be
+        # automatically filled by the service config compiler .
+        # Corresponds to the JSON property `selector`
+        # @return [String]
+        attr_accessor :selector
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @request_policies = args[:request_policies] if args.key?(:request_policies)
+          @selector = args[:selector] if args.key?(:selector)
+        end
+      end
+      
       # Describes the generator configuration for a method.
       class MethodSettings
         include Google::Apis::Core::Hashable
       
+        # List of top-level fields of the request message, that should be automatically
+        # populated by the client libraries based on their (google.api.field_info).
+        # format. Currently supported format: UUID4. Example of a YAML configuration:
+        # publishing: method_settings: - selector: google.example.v1.ExampleService.
+        # CreateExample auto_populated_fields: - request_id
+        # Corresponds to the JSON property `autoPopulatedFields`
+        # @return [Array<String>]
+        attr_accessor :auto_populated_fields
+      
+        # `BatchingConfigProto` defines the batching configuration for an API method.
+        # Corresponds to the JSON property `batching`
+        # @return [Google::Apis::ServiceusageV1::BatchingConfigProto]
+        attr_accessor :batching
+      
         # Describes settings to use when generating API methods that use the long-
         # running operation pattern. All default values below are from those used in the
         # client library generators (e.g. [Java](https://github.com/googleapis/gapic-
@@ -2859,7 +4099,9 @@ module Google
         attr_accessor :long_running
       
         # The fully qualified name of the method, for which the options below apply.
-        # This is used to find the method to apply the options.
+        # This is used to find the method to apply the options. Example: publishing:
+        # method_settings: - selector: google.storage.control.v2.StorageControl.
+        # CreateFolder # method settings for CreateFolder...
         # Corresponds to the JSON property `selector`
         # @return [String]
         attr_accessor :selector
@@ -2870,6 +4112,8 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @auto_populated_fields = args[:auto_populated_fields] if args.key?(:auto_populated_fields)
+          @batching = args[:batching] if args.key?(:batching)
           @long_running = args[:long_running] if args.key?(:long_running)
           @selector = args[:selector] if args.key?(:selector)
         end
@@ -3042,6 +4286,11 @@ module Google
         # @return [String]
         attr_accessor :sample_period
       
+        # The scope of the timeseries data of the metric.
+        # Corresponds to the JSON property `timeSeriesResourceHierarchyLevel`
+        # @return [Array<String>]
+        attr_accessor :time_series_resource_hierarchy_level
+      
         def initialize(**args)
            update!(**args)
         end
@@ -3051,6 +4300,7 @@ module Google
           @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)
+          @time_series_resource_hierarchy_level = args[:time_series_resource_hierarchy_level] if args.key?(:time_series_resource_hierarchy_level)
         end
       end
       
@@ -3184,7 +4434,7 @@ module Google
       
         # Required. The monitored resource type. For example, the type `"
         # cloudsql_database"` represents databases in Google Cloud SQL. For a list of
-        # types, see [Monitoring resource types](https://cloud.google.com/monitoring/api/
+        # types, see [Monitored resource types](https://cloud.google.com/monitoring/api/
         # resources) and [Logging resource types](https://cloud.google.com/logging/docs/
         # api/v2/resource-list).
         # Corresponds to the JSON property `type`
@@ -3380,13 +4630,13 @@ module Google
         # @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, successful response of the operation. 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
@@ -3425,7 +4675,9 @@ module Google
       end
       
       # A protocol buffer option, which can be attached to a message, field,
-      # enumeration, etc.
+      # enumeration, etc. New usages of this message as an alternative to FileOptions,
+      # MessageOptions, FieldOptions, EnumOptions, EnumValueOptions, ServiceOptions,
+      # or MethodOptions are strongly discouraged.
       class Option
         include Google::Apis::Core::Hashable
       
@@ -3461,7 +4713,7 @@ module Google
       class Page
         include Google::Apis::Core::Hashable
       
-        # The Markdown content of the page. You can use (== include `path` ==) to
+        # The Markdown content of the page. You can use ```(== include `path` ==)``` to
         # include content from a Markdown file. The content can be used to produce the
         # documentation page such as HTML format page.
         # Corresponds to the JSON property `content`
@@ -3506,6 +4758,16 @@ module Google
         # @return [Google::Apis::ServiceusageV1::CommonLanguageSettings]
         attr_accessor :common
       
+        # The package name to use in Php. Clobbers the php_namespace option set in the
+        # protobuf. This should be used **only** by APIs who have already set the
+        # language_settings.php.package_name" field in gapic.yaml. API teams should use
+        # the protobuf php_namespace option where possible. Example of a YAML
+        # configuration:: publishing: library_settings: php_settings: library_package:
+        # Google\Cloud\PubSub\V1
+        # Corresponds to the JSON property `libraryPackage`
+        # @return [String]
+        attr_accessor :library_package
+      
         def initialize(**args)
            update!(**args)
         end
@@ -3513,6 +4775,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @common = args[:common] if args.key?(:common)
+          @library_package = args[:library_package] if args.key?(:library_package)
         end
       end
       
@@ -3565,7 +4828,7 @@ module Google
         # @return [Array<Google::Apis::ServiceusageV1::MethodSettings>]
         attr_accessor :method_settings
       
-        # Link to a place that API users can report issues. Example: https://
+        # Link to a *public* URI where users can report issues. Example: https://
         # issuetracker.google.com/issues/new?component=190865&template=1161103
         # Corresponds to the JSON property `newIssueUri`
         # @return [String]
@@ -3576,6 +4839,18 @@ module Google
         # @return [String]
         attr_accessor :organization
       
+        # Optional link to proto reference documentation. Example: https://cloud.google.
+        # com/pubsub/lite/docs/reference/rpc
+        # Corresponds to the JSON property `protoReferenceDocumentationUri`
+        # @return [String]
+        attr_accessor :proto_reference_documentation_uri
+      
+        # Optional link to REST reference documentation. Example: https://cloud.google.
+        # com/pubsub/lite/docs/reference/rest
+        # Corresponds to the JSON property `restReferenceDocumentationUri`
+        # @return [String]
+        attr_accessor :rest_reference_documentation_uri
+      
         def initialize(**args)
            update!(**args)
         end
@@ -3591,6 +4866,8 @@ module Google
           @method_settings = args[:method_settings] if args.key?(:method_settings)
           @new_issue_uri = args[:new_issue_uri] if args.key?(:new_issue_uri)
           @organization = args[:organization] if args.key?(:organization)
+          @proto_reference_documentation_uri = args[:proto_reference_documentation_uri] if args.key?(:proto_reference_documentation_uri)
+          @rest_reference_documentation_uri = args[:rest_reference_documentation_uri] if args.key?(:rest_reference_documentation_uri)
         end
       end
       
@@ -3603,6 +4880,12 @@ module Google
         # @return [Google::Apis::ServiceusageV1::CommonLanguageSettings]
         attr_accessor :common
       
+        # Experimental features to be included during client library generation. These
+        # fields will be deprecated once the feature graduates and is enabled by default.
+        # Corresponds to the JSON property `experimentalFeatures`
+        # @return [Google::Apis::ServiceusageV1::ExperimentalFeatures]
+        attr_accessor :experimental_features
+      
         def initialize(**args)
            update!(**args)
         end
@@ -3610,6 +4893,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @common = args[:common] if args.key?(:common)
+          @experimental_features = args[:experimental_features] if args.key?(:experimental_features)
         end
       end
       
@@ -3729,11 +5013,11 @@ module Google
         # @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
+        # MetricDescriptor.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
@@ -3839,6 +5123,46 @@ module Google
         end
       end
       
+      # Metadata for the `RemoveEnableRules` method.
+      class RemoveEnableRulesMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # The response message of `RemoveEnableRules` method.
+      class RemoveEnableRulesResponse
+        include Google::Apis::Core::Hashable
+      
+        # The parent consumer policy. It can be `projects/12345/consumerPolicies/default`
+        # , or `folders/12345/consumerPolicies/default`, or `organizations/12345/
+        # consumerPolicies/default`.
+        # Corresponds to the JSON property `parent`
+        # @return [String]
+        attr_accessor :parent
+      
+        # The values removed from the parent consumer policy.
+        # Corresponds to the JSON property `removedValues`
+        # @return [Array<String>]
+        attr_accessor :removed_values
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @parent = args[:parent] if args.key?(:parent)
+          @removed_values = args[:removed_values] if args.key?(:removed_values)
+        end
+      end
+      
       # Settings for Ruby client libraries.
       class RubySettings
         include Google::Apis::Core::Hashable
@@ -3858,6 +5182,40 @@ module Google
         end
       end
       
+      # This message is used to configure the generation of a subset of the RPCs in a
+      # service for client libraries. Note: This feature should not be used in most
+      # cases.
+      class SelectiveGapicGeneration
+        include Google::Apis::Core::Hashable
+      
+        # Setting this to true indicates to the client generators that methods that
+        # would be excluded from the generation should instead be generated in a way
+        # that indicates these methods should not be consumed by end users. How this is
+        # expressed is up to individual language implementations to decide. Some
+        # examples may be: added annotations, obfuscated identifiers, or other language
+        # idiomatic patterns.
+        # Corresponds to the JSON property `generateOmittedAsInternal`
+        # @return [Boolean]
+        attr_accessor :generate_omitted_as_internal
+        alias_method :generate_omitted_as_internal?, :generate_omitted_as_internal
+      
+        # An allowlist of the fully qualified names of RPCs that should be included on
+        # public client surfaces.
+        # Corresponds to the JSON property `methods`
+        # @return [Array<String>]
+        attr_accessor :methods_prop
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @generate_omitted_as_internal = args[:generate_omitted_as_internal] if args.key?(:generate_omitted_as_internal)
+          @methods_prop = args[:methods_prop] if args.key?(:methods_prop)
+        end
+      end
+      
       # Service identity for a service. This is the identity that service producer
       # should use to access consumer resources.
       class ServiceIdentity
@@ -4059,10 +5417,19 @@ module Google
         end
       end
       
-      # A protocol buffer message type.
+      # A protocol buffer message type. New usages of this message as an alternative
+      # to DescriptorProto are strongly discouraged. This message does not reliability
+      # preserve all information necessary to model the schema and preserve semantics.
+      # Instead make use of FileDescriptorSet which preserves the necessary
+      # information.
       class Type
         include Google::Apis::Core::Hashable
       
+        # The source edition string, only valid when syntax is SYNTAX_EDITIONS.
+        # Corresponds to the JSON property `edition`
+        # @return [String]
+        attr_accessor :edition
+      
         # The list of fields.
         # Corresponds to the JSON property `fields`
         # @return [Array<Google::Apis::ServiceusageV1::Field>]
@@ -4100,6 +5467,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @edition = args[:edition] if args.key?(:edition)
           @fields = args[:fields] if args.key?(:fields)
           @name = args[:name] if args.key?(:name)
           @oneofs = args[:oneofs] if args.key?(:oneofs)
@@ -4124,6 +5492,32 @@ module Google
         end
       end
       
+      # Metadata for the `UpdateConsumerPolicy` method.
+      class UpdateConsumerPolicyMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # Metadata for the `UpdateContentSecurityPolicy` method.
+      class UpdateContentSecurityPolicyMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Configuration controlling usage of a service.
       class Usage
         include Google::Apis::Core::Hashable
@@ -4167,21 +5561,15 @@ 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.
       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.
+        # 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). WARNING: By default, API methods do not allow
+        # unregistered calls, and each method call must be identified by a consumer
+        # project identity.
         # Corresponds to the JSON property `allowUnregisteredCalls`
         # @return [Boolean]
         attr_accessor :allow_unregistered_calls