google-apis-serviceusage_v1 0.28.0 → 0.62.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,6 +127,106 @@ 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,
@@ -430,6 +570,11 @@ 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
+      
         # 
         # Corresponds to the JSON property `pathTranslation`
         # @return [String]
@@ -466,6 +611,7 @@ module Google
           @jwt_audience = args[:jwt_audience] if args.key?(:jwt_audience)
           @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)
@@ -713,7 +859,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 +901,12 @@ 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.
+        # Corresponds to the JSON property `selectiveGapicGeneration`
+        # @return [Google::Apis::ServiceusageV1::SelectiveGapicGeneration]
+        attr_accessor :selective_gapic_generation
+      
         def initialize(**args)
            update!(**args)
         end
@@ -761,6 +915,58 @@ 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
+      
+      # 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
+      
+        # 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)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @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
       
@@ -813,12 +1019,14 @@ module Google
         # @return [Array<String>]
         attr_accessor :allowed_response_extensions
       
-        # A list of full type names of provided contexts.
+        # 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.
+        # 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
@@ -855,6 +1063,11 @@ module Google
         # @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 +1075,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 +1264,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 +1289,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 +1320,13 @@ module Google
         # @return [Array<Google::Apis::ServiceusageV1::DocumentationRule>]
         attr_accessor :rules
       
+        # Specifies section and content to override boilerplate content provided by go/
+        # api-docgen. 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 +1347,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 +1375,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 by go/api-docgen.
+        # 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 +1400,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 +1414,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 +1457,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 +1506,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 +1597,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
@@ -1325,6 +1644,11 @@ module Google
       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 +1681,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)
@@ -1396,6 +1721,39 @@ module Google
         end
       end
       
+      # 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
+      
+        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)
+        end
+      end
+      
       # A single field of a message type.
       class Field
         include Google::Apis::Core::Hashable
@@ -1472,6 +1830,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 +1922,13 @@ 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. 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 +1936,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
       
@@ -1631,7 +2041,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,
@@ -1946,7 +2356,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,
@@ -2122,6 +2532,315 @@ module Google
         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 `analysis`
+        # @return [Google::Apis::ServiceusageV1::GoogleApiServiceusageV2betaAnalysisResult]
+        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 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
+      
+        # 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::GoogleApiServiceusageV2betaEnableRule>]
+        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 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
+      
+        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)
+        end
+      end
+      
+      # Metadata for the `UpdateConsumerPolicy` method.
+      class GoogleApiServiceusageV2betaUpdateConsumerPolicyMetadata
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Defines the HTTP configuration for an API service. It contains a list of
       # HttpRule, each specifying the mapping of an RPC method to one or more HTTP
       # REST API methods.
@@ -2154,7 +2873,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 +2893,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 +2970,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 +2980,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 +3082,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.
@@ -2845,10 +3601,47 @@ 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
+      
         # 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 +3652,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 +3665,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @auto_populated_fields = args[:auto_populated_fields] if args.key?(:auto_populated_fields)
           @long_running = args[:long_running] if args.key?(:long_running)
           @selector = args[:selector] if args.key?(:selector)
         end
@@ -3042,6 +3838,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 +3852,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 +3986,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 +4182,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
@@ -3565,7 +4367,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 +4378,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 +4405,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 +4419,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 +4432,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 +4552,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 +4662,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 +4721,27 @@ module Google
         end
       end
       
+      # This message is used to configure the generation of a subset of the RPCs in a
+      # service for client libraries.
+      class SelectiveGapicGeneration
+        include Google::Apis::Core::Hashable
+      
+        # 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)
+          @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
@@ -4063,6 +4947,11 @@ module Google
       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 +4989,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 +5014,19 @@ 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
+      
       # Configuration controlling usage of a service.
       class Usage
         include Google::Apis::Core::Hashable