google-cloud-api_hub-v1 0.1.1 → 0.3.0

data/lib/google/cloud/api_hub/v1/api_hub/client.rb

@@ -1,4514 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright 2024 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
-
-require "google/cloud/errors"
-require "google/cloud/apihub/v1/apihub_service_pb"
-require "google/cloud/location"
-
-module Google
-  module Cloud
-    module ApiHub
-      module V1
-        module ApiHub
-          ##
-          # Client for the ApiHub service.
-          #
-          # This service provides all methods related to the API hub.
-          #
-          class Client
-            # @private
-            API_VERSION = ""
-
-            # @private
-            DEFAULT_ENDPOINT_TEMPLATE = "apihub.$UNIVERSE_DOMAIN$"
-
-            include Paths
-
-            # @private
-            attr_reader :api_hub_stub
-
-            ##
-            # Configure the ApiHub Client class.
-            #
-            # See {::Google::Cloud::ApiHub::V1::ApiHub::Client::Configuration}
-            # for a description of the configuration fields.
-            #
-            # @example
-            #
-            #   # Modify the configuration for all ApiHub clients
-            #   ::Google::Cloud::ApiHub::V1::ApiHub::Client.configure do |config|
-            #     config.timeout = 10.0
-            #   end
-            #
-            # @yield [config] Configure the Client client.
-            # @yieldparam config [Client::Configuration]
-            #
-            # @return [Client::Configuration]
-            #
-            def self.configure
-              @configure ||= begin
-                namespace = ["Google", "Cloud", "ApiHub", "V1"]
-                parent_config = while namespace.any?
-                                  parent_name = namespace.join "::"
-                                  parent_const = const_get parent_name
-                                  break parent_const.configure if parent_const.respond_to? :configure
-                                  namespace.pop
-                                end
-                default_config = Client::Configuration.new parent_config
-
-                default_config.rpcs.create_api.timeout = 60.0
-
-                default_config.rpcs.get_api.timeout = 60.0
-                default_config.rpcs.get_api.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.list_apis.timeout = 60.0
-                default_config.rpcs.list_apis.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.update_api.timeout = 60.0
-
-                default_config.rpcs.delete_api.timeout = 60.0
-
-                default_config.rpcs.create_version.timeout = 60.0
-
-                default_config.rpcs.get_version.timeout = 60.0
-                default_config.rpcs.get_version.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.list_versions.timeout = 60.0
-                default_config.rpcs.list_versions.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.update_version.timeout = 60.0
-
-                default_config.rpcs.delete_version.timeout = 60.0
-
-                default_config.rpcs.create_spec.timeout = 60.0
-
-                default_config.rpcs.get_spec.timeout = 60.0
-                default_config.rpcs.get_spec.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.get_spec_contents.timeout = 60.0
-                default_config.rpcs.get_spec_contents.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.list_specs.timeout = 60.0
-                default_config.rpcs.list_specs.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.update_spec.timeout = 60.0
-
-                default_config.rpcs.delete_spec.timeout = 60.0
-
-                default_config.rpcs.get_api_operation.timeout = 60.0
-                default_config.rpcs.get_api_operation.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.list_api_operations.timeout = 60.0
-                default_config.rpcs.list_api_operations.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.get_definition.timeout = 60.0
-                default_config.rpcs.get_definition.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.create_deployment.timeout = 60.0
-
-                default_config.rpcs.get_deployment.timeout = 60.0
-                default_config.rpcs.get_deployment.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.list_deployments.timeout = 60.0
-                default_config.rpcs.list_deployments.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.update_deployment.timeout = 60.0
-
-                default_config.rpcs.delete_deployment.timeout = 60.0
-
-                default_config.rpcs.create_attribute.timeout = 60.0
-
-                default_config.rpcs.get_attribute.timeout = 60.0
-                default_config.rpcs.get_attribute.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.update_attribute.timeout = 60.0
-
-                default_config.rpcs.delete_attribute.timeout = 60.0
-
-                default_config.rpcs.list_attributes.timeout = 60.0
-                default_config.rpcs.list_attributes.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.search_resources.timeout = 60.0
-                default_config.rpcs.search_resources.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.create_external_api.timeout = 60.0
-
-                default_config.rpcs.get_external_api.timeout = 60.0
-                default_config.rpcs.get_external_api.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config.rpcs.update_external_api.timeout = 60.0
-
-                default_config.rpcs.delete_external_api.timeout = 60.0
-
-                default_config.rpcs.list_external_apis.timeout = 60.0
-                default_config.rpcs.list_external_apis.retry_policy = {
-                  initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
-                }
-
-                default_config
-              end
-              yield @configure if block_given?
-              @configure
-            end
-
-            ##
-            # Configure the ApiHub Client instance.
-            #
-            # The configuration is set to the derived mode, meaning that values can be changed,
-            # but structural changes (adding new fields, etc.) are not allowed. Structural changes
-            # should be made on {Client.configure}.
-            #
-            # See {::Google::Cloud::ApiHub::V1::ApiHub::Client::Configuration}
-            # for a description of the configuration fields.
-            #
-            # @yield [config] Configure the Client client.
-            # @yieldparam config [Client::Configuration]
-            #
-            # @return [Client::Configuration]
-            #
-            def configure
-              yield @config if block_given?
-              @config
-            end
-
-            ##
-            # The effective universe domain
-            #
-            # @return [String]
-            #
-            def universe_domain
-              @api_hub_stub.universe_domain
-            end
-
-            ##
-            # Create a new ApiHub client object.
-            #
-            # @example
-            #
-            #   # Create a client using the default configuration
-            #   client = ::Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a client using a custom configuration
-            #   client = ::Google::Cloud::ApiHub::V1::ApiHub::Client.new do |config|
-            #     config.timeout = 10.0
-            #   end
-            #
-            # @yield [config] Configure the ApiHub client.
-            # @yieldparam config [Client::Configuration]
-            #
-            def initialize
-              # These require statements are intentionally placed here to initialize
-              # the gRPC module only when it's required.
-              # See https://github.com/googleapis/toolkit/issues/446
-              require "gapic/grpc"
-              require "google/cloud/apihub/v1/apihub_service_services_pb"
-
-              # Create the configuration object
-              @config = Configuration.new Client.configure
-
-              # Yield the configuration if needed
-              yield @config if block_given?
-
-              # Create credentials
-              credentials = @config.credentials
-              # Use self-signed JWT if the endpoint is unchanged from default,
-              # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.endpoint.nil? ||
-                                       (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
-                                       !@config.endpoint.split(".").first.include?("-"))
-              credentials ||= Credentials.default scope: @config.scope,
-                                                  enable_self_signed_jwt: enable_self_signed_jwt
-              if credentials.is_a?(::String) || credentials.is_a?(::Hash)
-                credentials = Credentials.new credentials, scope: @config.scope
-              end
-              @quota_project_id = @config.quota_project
-              @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
-
-              @api_hub_stub = ::Gapic::ServiceStub.new(
-                ::Google::Cloud::ApiHub::V1::ApiHub::Stub,
-                credentials: credentials,
-                endpoint: @config.endpoint,
-                endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
-                universe_domain: @config.universe_domain,
-                channel_args: @config.channel_args,
-                interceptors: @config.interceptors,
-                channel_pool_config: @config.channel_pool
-              )
-
-              @location_client = Google::Cloud::Location::Locations::Client.new do |config|
-                config.credentials = credentials
-                config.quota_project = @quota_project_id
-                config.endpoint = @api_hub_stub.endpoint
-                config.universe_domain = @api_hub_stub.universe_domain
-              end
-            end
-
-            ##
-            # Get the associated client for mix-in of the Locations.
-            #
-            # @return [Google::Cloud::Location::Locations::Client]
-            #
-            attr_reader :location_client
-
-            # Service calls
-
-            ##
-            # Create an API resource in the API hub.
-            # Once an API resource is created, versions can be added to it.
-            #
-            # @overload create_api(request, options = nil)
-            #   Pass arguments to `create_api` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::CreateApiRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::CreateApiRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload create_api(parent: nil, api_id: nil, api: nil)
-            #   Pass arguments to `create_api` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param parent [::String]
-            #     Required. The parent resource for the API resource.
-            #     Format: `projects/{project}/locations/{location}`
-            #   @param api_id [::String]
-            #     Optional. The ID to use for the API resource, which will become the final
-            #     component of the API's resource name. This field is optional.
-            #
-            #     * If provided, the same will be used. The service will throw an error if
-            #     the specified id is already used by another API resource in the API hub.
-            #     * If not provided, a system generated id will be used.
-            #
-            #     This value should be 4-500 characters, and valid characters
-            #     are /[a-z][A-Z][0-9]-_/.
-            #   @param api [::Google::Cloud::ApiHub::V1::Api, ::Hash]
-            #     Required. The API resource to create.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Api]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Api]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::CreateApiRequest.new
-            #
-            #   # Call the create_api method.
-            #   result = client.create_api request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Api.
-            #   p result
-            #
-            def create_api request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::CreateApiRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.create_api.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.parent
-                header_params["parent"] = request.parent
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.create_api.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.create_api.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :create_api, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Get API resource details including the API versions contained in it.
-            #
-            # @overload get_api(request, options = nil)
-            #   Pass arguments to `get_api` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::GetApiRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::GetApiRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload get_api(name: nil)
-            #   Pass arguments to `get_api` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the API resource to retrieve.
-            #     Format: `projects/{project}/locations/{location}/apis/{api}`
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Api]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Api]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::GetApiRequest.new
-            #
-            #   # Call the get_api method.
-            #   result = client.get_api request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Api.
-            #   p result
-            #
-            def get_api request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::GetApiRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.get_api.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.get_api.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.get_api.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :get_api, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # List API resources in the API hub.
-            #
-            # @overload list_apis(request, options = nil)
-            #   Pass arguments to `list_apis` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::ListApisRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::ListApisRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload list_apis(parent: nil, filter: nil, page_size: nil, page_token: nil)
-            #   Pass arguments to `list_apis` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param parent [::String]
-            #     Required. The parent, which owns this collection of API resources.
-            #     Format: `projects/{project}/locations/{location}`
-            #   @param filter [::String]
-            #     Optional. An expression that filters the list of ApiResources.
-            #
-            #     A filter expression consists of a field name, a comparison
-            #     operator, and a value for filtering. The value must be a string. The
-            #     comparison operator must be one of: `<`, `>`, `:` or `=`. Filters are not
-            #     case sensitive.
-            #
-            #     The following fields in the `ApiResource` are eligible for filtering:
-            #
-            #       * `owner.email` - The email of the team which owns the ApiResource.
-            #       Allowed comparison operators: `=`.
-            #       * `create_time` - The time at which the ApiResource was created. The
-            #       value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339]
-            #       format. Allowed comparison operators: `>` and `<`.
-            #       * `display_name` - The display name of the ApiResource. Allowed
-            #       comparison operators: `=`.
-            #       * `target_user.enum_values.values.id` - The allowed value id of the
-            #       target users attribute associated with the ApiResource. Allowed
-            #       comparison operator is `:`.
-            #       * `target_user.enum_values.values.display_name` - The allowed value
-            #       display name of the target users attribute associated with the
-            #       ApiResource. Allowed comparison operator is `:`.
-            #       * `team.enum_values.values.id` - The allowed value id of the team
-            #       attribute associated with the ApiResource. Allowed comparison operator is
-            #       `:`.
-            #       * `team.enum_values.values.display_name` - The allowed value display name
-            #       of the team attribute associated with the ApiResource. Allowed comparison
-            #       operator is `:`.
-            #       * `business_unit.enum_values.values.id` - The allowed value id of the
-            #       business unit attribute associated with the ApiResource. Allowed
-            #       comparison operator is `:`.
-            #       * `business_unit.enum_values.values.display_name` - The allowed value
-            #       display name of the business unit attribute associated with the
-            #       ApiResource. Allowed comparison operator is `:`.
-            #       * `maturity_level.enum_values.values.id` - The allowed value id of the
-            #       maturity level attribute associated with the ApiResource. Allowed
-            #       comparison operator is `:`.
-            #       * `maturity_level.enum_values.values.display_name` - The allowed value
-            #       display name of the maturity level attribute associated with the
-            #       ApiResource. Allowed comparison operator is `:`.
-            #       * `api_style.enum_values.values.id` - The allowed value id of the
-            #       api style attribute associated with the ApiResource. Allowed
-            #       comparison operator is `:`.
-            #       * `api_style.enum_values.values.display_name` - The allowed value display
-            #       name of the api style attribute associated with the ApiResource. Allowed
-            #       comparison operator is `:`.
-            #
-            #     Expressions are combined with either `AND` logic operator or `OR` logical
-            #     operator but not both of them together i.e. only one of the `AND` or `OR`
-            #     operator can be used throughout the filter string and both the operators
-            #     cannot be used together. No other logical operators are supported. At most
-            #     three filter fields are allowed in the filter string and if provided
-            #     more than that then `INVALID_ARGUMENT` error is returned by the API.
-            #
-            #     Here are a few examples:
-            #
-            #       * `owner.email = \"apihub@google.com\"` -  - The owner team email is
-            #       _apihub@google.com_.
-            #       * `owner.email = \"apihub@google.com\" AND create_time <
-            #       \"2021-08-15T14:50:00Z\" AND create_time > \"2021-08-10T12:00:00Z\"` -
-            #       The owner team email is _apihub@google.com_ and the api was created
-            #       before _2021-08-15 14:50:00 UTC_ and after _2021-08-10 12:00:00 UTC_.
-            #       * `owner.email = \"apihub@google.com\" OR team.enum_values.values.id:
-            #       apihub-team-id` - The filter string specifies the APIs where the owner
-            #       team email is _apihub@google.com_ or the id of the allowed value
-            #       associated with the team attribute is _apihub-team-id_.
-            #       * `owner.email = \"apihub@google.com\" OR
-            #       team.enum_values.values.display_name: ApiHub Team` - The filter string
-            #       specifies the APIs where the owner team email is _apihub@google.com_ or
-            #       the display name of the allowed value associated with the team attribute
-            #       is `ApiHub Team`.
-            #   @param page_size [::Integer]
-            #     Optional. The maximum number of API resources to return. The service may
-            #     return fewer than this value. If unspecified, at most 50 Apis will be
-            #     returned. The maximum value is 1000; values above 1000 will be coerced to
-            #     1000.
-            #   @param page_token [::String]
-            #     Optional. A page token, received from a previous `ListApis` call.
-            #     Provide this to retrieve the subsequent page.
-            #
-            #     When paginating, all other parameters (except page_size) provided to
-            #     `ListApis` must match the call that provided the page token.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::Api>]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::Api>]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::ListApisRequest.new
-            #
-            #   # Call the list_apis method.
-            #   result = client.list_apis request
-            #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
-            #   # over elements, and API calls will be issued to fetch pages as needed.
-            #   result.each do |item|
-            #     # Each element is of type ::Google::Cloud::ApiHub::V1::Api.
-            #     p item
-            #   end
-            #
-            def list_apis request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::ListApisRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.list_apis.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.parent
-                header_params["parent"] = request.parent
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.list_apis.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.list_apis.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :list_apis, request, options: options do |response, operation|
-                response = ::Gapic::PagedEnumerable.new @api_hub_stub, :list_apis, request, response, operation, options
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Update an API resource in the API hub. The following fields in the
-            # [API][] can be updated:
-            #
-            # * {::Google::Cloud::ApiHub::V1::Api#display_name display_name}
-            # * {::Google::Cloud::ApiHub::V1::Api#description description}
-            # * {::Google::Cloud::ApiHub::V1::Api#owner owner}
-            # * {::Google::Cloud::ApiHub::V1::Api#documentation documentation}
-            # * {::Google::Cloud::ApiHub::V1::Api#target_user target_user}
-            # * {::Google::Cloud::ApiHub::V1::Api#team team}
-            # * {::Google::Cloud::ApiHub::V1::Api#business_unit business_unit}
-            # * {::Google::Cloud::ApiHub::V1::Api#maturity_level maturity_level}
-            # * {::Google::Cloud::ApiHub::V1::Api#attributes attributes}
-            #
-            # The
-            # {::Google::Cloud::ApiHub::V1::UpdateApiRequest#update_mask update_mask}
-            # should be used to specify the fields being updated.
-            #
-            # Updating the owner field requires complete owner message
-            # and updates both owner and email fields.
-            #
-            # @overload update_api(request, options = nil)
-            #   Pass arguments to `update_api` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::UpdateApiRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::UpdateApiRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload update_api(api: nil, update_mask: nil)
-            #   Pass arguments to `update_api` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param api [::Google::Cloud::ApiHub::V1::Api, ::Hash]
-            #     Required. The API resource to update.
-            #
-            #     The API resource's `name` field is used to identify the API resource to
-            #     update.
-            #     Format: `projects/{project}/locations/{location}/apis/{api}`
-            #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     Required. The list of fields to update.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Api]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Api]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::UpdateApiRequest.new
-            #
-            #   # Call the update_api method.
-            #   result = client.update_api request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Api.
-            #   p result
-            #
-            def update_api request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::UpdateApiRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.update_api.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.api&.name
-                header_params["api.name"] = request.api.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.update_api.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.update_api.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :update_api, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Delete an API resource in the API hub. API can only be deleted if all
-            # underlying versions are deleted.
-            #
-            # @overload delete_api(request, options = nil)
-            #   Pass arguments to `delete_api` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::DeleteApiRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::DeleteApiRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload delete_api(name: nil, force: nil)
-            #   Pass arguments to `delete_api` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the API resource to delete.
-            #     Format: `projects/{project}/locations/{location}/apis/{api}`
-            #   @param force [::Boolean]
-            #     Optional. If set to true, any versions from this API will also be deleted.
-            #     Otherwise, the request will only work if the API has no versions.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Protobuf::Empty]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Protobuf::Empty]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::DeleteApiRequest.new
-            #
-            #   # Call the delete_api method.
-            #   result = client.delete_api request
-            #
-            #   # The returned object is of type Google::Protobuf::Empty.
-            #   p result
-            #
-            def delete_api request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::DeleteApiRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.delete_api.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.delete_api.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.delete_api.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :delete_api, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Create an API version for an API resource in the API hub.
-            #
-            # @overload create_version(request, options = nil)
-            #   Pass arguments to `create_version` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::CreateVersionRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::CreateVersionRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload create_version(parent: nil, version_id: nil, version: nil)
-            #   Pass arguments to `create_version` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param parent [::String]
-            #     Required. The parent resource for API version.
-            #     Format: `projects/{project}/locations/{location}/apis/{api}`
-            #   @param version_id [::String]
-            #     Optional. The ID to use for the API version, which will become the final
-            #     component of the version's resource name. This field is optional.
-            #
-            #     * If provided, the same will be used. The service will throw an error if
-            #     the specified id is already used by another version in the API resource.
-            #     * If not provided, a system generated id will be used.
-            #
-            #     This value should be 4-500 characters, and valid characters
-            #     are /[a-z][A-Z][0-9]-_/.
-            #   @param version [::Google::Cloud::ApiHub::V1::Version, ::Hash]
-            #     Required. The version to create.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Version]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Version]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::CreateVersionRequest.new
-            #
-            #   # Call the create_version method.
-            #   result = client.create_version request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Version.
-            #   p result
-            #
-            def create_version request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::CreateVersionRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.create_version.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.parent
-                header_params["parent"] = request.parent
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.create_version.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.create_version.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :create_version, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Get details about the API version of an API resource. This will include
-            # information about the specs and operations present in the API
-            # version as well as the deployments linked to it.
-            #
-            # @overload get_version(request, options = nil)
-            #   Pass arguments to `get_version` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::GetVersionRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::GetVersionRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload get_version(name: nil)
-            #   Pass arguments to `get_version` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the API version to retrieve.
-            #     Format:
-            #     `projects/{project}/locations/{location}/apis/{api}/versions/{version}`
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Version]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Version]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::GetVersionRequest.new
-            #
-            #   # Call the get_version method.
-            #   result = client.get_version request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Version.
-            #   p result
-            #
-            def get_version request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::GetVersionRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.get_version.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.get_version.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.get_version.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :get_version, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # List API versions of an API resource in the API hub.
-            #
-            # @overload list_versions(request, options = nil)
-            #   Pass arguments to `list_versions` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::ListVersionsRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::ListVersionsRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload list_versions(parent: nil, filter: nil, page_size: nil, page_token: nil)
-            #   Pass arguments to `list_versions` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param parent [::String]
-            #     Required. The parent which owns this collection of API versions i.e., the
-            #     API resource Format: `projects/{project}/locations/{location}/apis/{api}`
-            #   @param filter [::String]
-            #     Optional. An expression that filters the list of Versions.
-            #
-            #     A filter expression consists of a field name, a comparison
-            #     operator, and a value for filtering. The value must be a string, a
-            #     number, or a boolean. The comparison operator must be one of: `<`, `>` or
-            #     `=`. Filters are not case sensitive.
-            #
-            #     The following fields in the `Version` are eligible for filtering:
-            #
-            #       * `display_name` - The display name of the Version. Allowed
-            #       comparison operators: `=`.
-            #       * `create_time` - The time at which the Version was created. The
-            #       value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339]
-            #       format. Allowed comparison operators: `>` and `<`.
-            #       * `lifecycle.enum_values.values.id` - The allowed value id of the
-            #       lifecycle attribute associated with the Version. Allowed comparison
-            #       operators: `:`.
-            #       * `lifecycle.enum_values.values.display_name` - The allowed value display
-            #       name of the lifecycle attribute associated with the Version. Allowed
-            #       comparison operators: `:`.
-            #       * `compliance.enum_values.values.id` -  The allowed value id of the
-            #       compliances attribute associated with the Version. Allowed comparison
-            #       operators: `:`.
-            #       * `compliance.enum_values.values.display_name` -  The allowed value
-            #       display name of the compliances attribute associated with the Version.
-            #       Allowed comparison operators: `:`.
-            #       * `accreditation.enum_values.values.id` - The allowed value id of the
-            #       accreditations attribute associated with the Version. Allowed
-            #       comparison operators: `:`.
-            #       * `accreditation.enum_values.values.display_name` - The allowed value
-            #       display name of the accreditations attribute associated with the Version.
-            #       Allowed comparison operators: `:`.
-            #
-            #     Expressions are combined with either `AND` logic operator or `OR` logical
-            #     operator but not both of them together i.e. only one of the `AND` or `OR`
-            #     operator can be used throughout the filter string and both the operators
-            #     cannot be used together. No other logical operators are
-            #     supported. At most three filter fields are allowed in the filter
-            #     string and if provided more than that then `INVALID_ARGUMENT` error is
-            #     returned by the API.
-            #
-            #     Here are a few examples:
-            #
-            #       * `lifecycle.enum_values.values.id: preview-id` - The filter string
-            #       specifies that the id of the allowed value associated with the lifecycle
-            #       attribute of the Version is _preview-id_.
-            #       * `lifecycle.enum_values.values.display_name: \"Preview Display Name\"` -
-            #       The filter string specifies that the display name of the allowed value
-            #       associated with the lifecycle attribute of the Version is `Preview
-            #       Display Name`.
-            #       * `lifecycle.enum_values.values.id: preview-id AND create_time <
-            #       \"2021-08-15T14:50:00Z\" AND create_time > \"2021-08-10T12:00:00Z\"` -
-            #       The id of the allowed value associated with the lifecycle attribute of
-            #       the Version is _preview-id_ and it was created before _2021-08-15
-            #       14:50:00 UTC_ and after _2021-08-10 12:00:00 UTC_.
-            #       * `compliance.enum_values.values.id: gdpr-id OR
-            #       compliance.enum_values.values.id: pci-dss-id`
-            #       - The id of the allowed value associated with the compliance attribute is
-            #       _gdpr-id_ or _pci-dss-id_.
-            #   @param page_size [::Integer]
-            #     Optional. The maximum number of versions to return. The service may return
-            #     fewer than this value. If unspecified, at most 50 versions will be
-            #     returned. The maximum value is 1000; values above 1000 will be coerced to
-            #     1000.
-            #   @param page_token [::String]
-            #     Optional. A page token, received from a previous `ListVersions` call.
-            #     Provide this to retrieve the subsequent page.
-            #
-            #     When paginating, all other parameters (except page_size) provided to
-            #     `ListVersions` must match the call that provided the page token.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::Version>]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::Version>]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::ListVersionsRequest.new
-            #
-            #   # Call the list_versions method.
-            #   result = client.list_versions request
-            #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
-            #   # over elements, and API calls will be issued to fetch pages as needed.
-            #   result.each do |item|
-            #     # Each element is of type ::Google::Cloud::ApiHub::V1::Version.
-            #     p item
-            #   end
-            #
-            def list_versions request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::ListVersionsRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.list_versions.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.parent
-                header_params["parent"] = request.parent
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.list_versions.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.list_versions.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :list_versions, request, options: options do |response, operation|
-                response = ::Gapic::PagedEnumerable.new @api_hub_stub, :list_versions, request, response, operation, options
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Update API version. The following fields in the
-            # {::Google::Cloud::ApiHub::V1::Version version} can be updated currently:
-            #
-            # * {::Google::Cloud::ApiHub::V1::Version#display_name display_name}
-            # * {::Google::Cloud::ApiHub::V1::Version#description description}
-            # * {::Google::Cloud::ApiHub::V1::Version#documentation documentation}
-            # * {::Google::Cloud::ApiHub::V1::Version#deployments deployments}
-            # * {::Google::Cloud::ApiHub::V1::Version#lifecycle lifecycle}
-            # * {::Google::Cloud::ApiHub::V1::Version#compliance compliance}
-            # * {::Google::Cloud::ApiHub::V1::Version#accreditation accreditation}
-            # * {::Google::Cloud::ApiHub::V1::Version#attributes attributes}
-            #
-            # The
-            # {::Google::Cloud::ApiHub::V1::UpdateVersionRequest#update_mask update_mask}
-            # should be used to specify the fields being updated.
-            #
-            # @overload update_version(request, options = nil)
-            #   Pass arguments to `update_version` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::UpdateVersionRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::UpdateVersionRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload update_version(version: nil, update_mask: nil)
-            #   Pass arguments to `update_version` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param version [::Google::Cloud::ApiHub::V1::Version, ::Hash]
-            #     Required. The API version to update.
-            #
-            #     The version's `name` field is used to identify the API version to update.
-            #     Format:
-            #     `projects/{project}/locations/{location}/apis/{api}/versions/{version}`
-            #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     Required. The list of fields to update.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Version]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Version]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::UpdateVersionRequest.new
-            #
-            #   # Call the update_version method.
-            #   result = client.update_version request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Version.
-            #   p result
-            #
-            def update_version request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::UpdateVersionRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.update_version.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.version&.name
-                header_params["version.name"] = request.version.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.update_version.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.update_version.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :update_version, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Delete an API version. Version can only be deleted if all underlying specs,
-            # operations, definitions and linked deployments are deleted.
-            #
-            # @overload delete_version(request, options = nil)
-            #   Pass arguments to `delete_version` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::DeleteVersionRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::DeleteVersionRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload delete_version(name: nil, force: nil)
-            #   Pass arguments to `delete_version` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the version to delete.
-            #     Format:
-            #     `projects/{project}/locations/{location}/apis/{api}/versions/{version}`
-            #   @param force [::Boolean]
-            #     Optional. If set to true, any specs from this version will also be deleted.
-            #     Otherwise, the request will only work if the version has no specs.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Protobuf::Empty]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Protobuf::Empty]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::DeleteVersionRequest.new
-            #
-            #   # Call the delete_version method.
-            #   result = client.delete_version request
-            #
-            #   # The returned object is of type Google::Protobuf::Empty.
-            #   p result
-            #
-            def delete_version request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::DeleteVersionRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.delete_version.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.delete_version.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.delete_version.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :delete_version, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Add a spec to an API version in the API hub.
-            # Multiple specs can be added to an API version.
-            # Note, while adding a spec, at least one of `contents` or `source_uri` must
-            # be provided. If `contents` is provided, then `spec_type` must also be
-            # provided.
-            #
-            # On adding a spec with contents to the version, the operations present in it
-            # will be added to the version.Note that the file contents in the spec should
-            # be of the same type as defined in the
-            # `projects/{project}/locations/{location}/attributes/system-spec-type`
-            # attribute associated with spec resource. Note that specs of various types
-            # can be uploaded, however parsing of details is supported for OpenAPI spec
-            # currently.
-            #
-            # In order to access the information parsed from the spec, use the
-            # {::Google::Cloud::ApiHub::V1::ApiHub::Client#get_spec GetSpec} method.
-            # In order to access the raw contents for a particular spec, use the
-            # {::Google::Cloud::ApiHub::V1::ApiHub::Client#get_spec_contents GetSpecContents} method.
-            # In order to access the operations parsed from the spec, use the
-            # {::Google::Cloud::ApiHub::V1::ApiHub::Client#list_api_operations ListAPIOperations}
-            # method.
-            #
-            # @overload create_spec(request, options = nil)
-            #   Pass arguments to `create_spec` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::CreateSpecRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::CreateSpecRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload create_spec(parent: nil, spec_id: nil, spec: nil)
-            #   Pass arguments to `create_spec` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param parent [::String]
-            #     Required. The parent resource for Spec.
-            #     Format:
-            #     `projects/{project}/locations/{location}/apis/{api}/versions/{version}`
-            #   @param spec_id [::String]
-            #     Optional. The ID to use for the spec, which will become the final component
-            #     of the spec's resource name. This field is optional.
-            #
-            #     * If provided, the same will be used. The service will throw an error if
-            #     the specified id is already used by another spec in the API
-            #     resource.
-            #     * If not provided, a system generated id will be used.
-            #
-            #     This value should be 4-500 characters, and valid characters
-            #     are /[a-z][A-Z][0-9]-_/.
-            #   @param spec [::Google::Cloud::ApiHub::V1::Spec, ::Hash]
-            #     Required. The spec to create.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Spec]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Spec]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::CreateSpecRequest.new
-            #
-            #   # Call the create_spec method.
-            #   result = client.create_spec request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Spec.
-            #   p result
-            #
-            def create_spec request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::CreateSpecRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.create_spec.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.parent
-                header_params["parent"] = request.parent
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.create_spec.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.create_spec.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :create_spec, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Get details about the information parsed from a spec.
-            # Note that this method does not return the raw spec contents.
-            # Use {::Google::Cloud::ApiHub::V1::ApiHub::Client#get_spec_contents GetSpecContents} method
-            # to retrieve the same.
-            #
-            # @overload get_spec(request, options = nil)
-            #   Pass arguments to `get_spec` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::GetSpecRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::GetSpecRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload get_spec(name: nil)
-            #   Pass arguments to `get_spec` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the spec to retrieve.
-            #     Format:
-            #     `projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}`
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Spec]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Spec]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::GetSpecRequest.new
-            #
-            #   # Call the get_spec method.
-            #   result = client.get_spec request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Spec.
-            #   p result
-            #
-            def get_spec request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::GetSpecRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.get_spec.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.get_spec.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.get_spec.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :get_spec, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Get spec contents.
-            #
-            # @overload get_spec_contents(request, options = nil)
-            #   Pass arguments to `get_spec_contents` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::GetSpecContentsRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::GetSpecContentsRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload get_spec_contents(name: nil)
-            #   Pass arguments to `get_spec_contents` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the spec whose contents need to be retrieved.
-            #     Format:
-            #     `projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}`
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::SpecContents]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::SpecContents]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::GetSpecContentsRequest.new
-            #
-            #   # Call the get_spec_contents method.
-            #   result = client.get_spec_contents request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::SpecContents.
-            #   p result
-            #
-            def get_spec_contents request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::GetSpecContentsRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.get_spec_contents.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.get_spec_contents.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.get_spec_contents.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :get_spec_contents, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # List specs corresponding to a particular API resource.
-            #
-            # @overload list_specs(request, options = nil)
-            #   Pass arguments to `list_specs` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::ListSpecsRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::ListSpecsRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload list_specs(parent: nil, filter: nil, page_size: nil, page_token: nil)
-            #   Pass arguments to `list_specs` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param parent [::String]
-            #     Required. The parent, which owns this collection of specs.
-            #     Format:
-            #     `projects/{project}/locations/{location}/apis/{api}/versions/{version}`
-            #   @param filter [::String]
-            #     Optional. An expression that filters the list of Specs.
-            #
-            #     A filter expression consists of a field name, a comparison
-            #     operator, and a value for filtering. The value must be a string. The
-            #     comparison operator must be one of: `<`, `>`, `:` or `=`. Filters are not
-            #     case sensitive.
-            #
-            #     The following fields in the `Spec` are eligible for filtering:
-            #
-            #       * `display_name` - The display name of the Spec. Allowed comparison
-            #       operators: `=`.
-            #       * `create_time` - The time at which the Spec was created. The
-            #       value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339]
-            #       format. Allowed comparison operators: `>` and `<`.
-            #       * `spec_type.enum_values.values.id` - The allowed value id of the
-            #       spec_type attribute associated with the Spec. Allowed comparison
-            #       operators: `:`.
-            #       * `spec_type.enum_values.values.display_name` - The allowed value display
-            #       name of the spec_type attribute associated with the Spec. Allowed
-            #       comparison operators: `:`.
-            #       * `lint_response.json_values.values` - The json value of the
-            #       lint_response attribute associated with the Spec. Allowed comparison
-            #       operators: `:`.
-            #       * `mime_type` - The MIME type of the Spec. Allowed comparison
-            #       operators: `=`.
-            #
-            #     Expressions are combined with either `AND` logic operator or `OR` logical
-            #     operator but not both of them together i.e. only one of the `AND` or `OR`
-            #     operator can be used throughout the filter string and both the operators
-            #     cannot be used together. No other logical operators are
-            #     supported. At most three filter fields are allowed in the filter
-            #     string and if provided more than that then `INVALID_ARGUMENT` error is
-            #     returned by the API.
-            #
-            #     Here are a few examples:
-            #
-            #       * `spec_type.enum_values.values.id: rest-id` -  The filter
-            #       string specifies that the id of the allowed value associated with the
-            #       spec_type attribute is _rest-id_.
-            #       * `spec_type.enum_values.values.display_name: \"Rest Display Name\"` -
-            #       The filter string specifies that the display name of the allowed value
-            #       associated with the spec_type attribute is `Rest Display Name`.
-            #       * `spec_type.enum_values.values.id: grpc-id AND create_time <
-            #       \"2021-08-15T14:50:00Z\" AND create_time > \"2021-08-10T12:00:00Z\"` -
-            #       The id of the allowed value associated with the spec_type attribute is
-            #       _grpc-id_ and the spec was created before _2021-08-15 14:50:00 UTC_ and
-            #       after _2021-08-10 12:00:00 UTC_.
-            #       * `spec_type.enum_values.values.id: rest-id OR
-            #       spec_type.enum_values.values.id: grpc-id`
-            #       - The id of the allowed value associated with the spec_type attribute is
-            #       _rest-id_ or _grpc-id_.
-            #   @param page_size [::Integer]
-            #     Optional. The maximum number of specs to return. The service may return
-            #     fewer than this value. If unspecified, at most 50 specs will be
-            #     returned. The maximum value is 1000; values above 1000 will be coerced to
-            #     1000.
-            #   @param page_token [::String]
-            #     Optional. A page token, received from a previous `ListSpecs` call.
-            #     Provide this to retrieve the subsequent page.
-            #
-            #     When paginating, all other parameters provided to `ListSpecs` must
-            #     match the call that provided the page token.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::Spec>]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::Spec>]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::ListSpecsRequest.new
-            #
-            #   # Call the list_specs method.
-            #   result = client.list_specs request
-            #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
-            #   # over elements, and API calls will be issued to fetch pages as needed.
-            #   result.each do |item|
-            #     # Each element is of type ::Google::Cloud::ApiHub::V1::Spec.
-            #     p item
-            #   end
-            #
-            def list_specs request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::ListSpecsRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.list_specs.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.parent
-                header_params["parent"] = request.parent
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.list_specs.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.list_specs.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :list_specs, request, options: options do |response, operation|
-                response = ::Gapic::PagedEnumerable.new @api_hub_stub, :list_specs, request, response, operation, options
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Update spec. The following fields in the
-            # {::Google::Cloud::ApiHub::V1::Spec spec} can be updated:
-            #
-            # * {::Google::Cloud::ApiHub::V1::Spec#display_name display_name}
-            # * {::Google::Cloud::ApiHub::V1::Spec#source_uri source_uri}
-            # * {::Google::Cloud::ApiHub::V1::Spec#lint_response lint_response}
-            # * {::Google::Cloud::ApiHub::V1::Spec#attributes attributes}
-            # * {::Google::Cloud::ApiHub::V1::Spec#contents contents}
-            # * {::Google::Cloud::ApiHub::V1::Spec#spec_type spec_type}
-            #
-            # In case of an OAS spec, updating spec contents can lead to:
-            # 1. Creation, deletion and update of operations.
-            # 2. Creation, deletion and update of definitions.
-            # 3. Update of other info parsed out from the new spec.
-            #
-            # In case of contents or source_uri being present in update mask, spec_type
-            # must also be present. Also, spec_type can not be present in update mask if
-            # contents or source_uri is not present.
-            #
-            # The
-            # {::Google::Cloud::ApiHub::V1::UpdateSpecRequest#update_mask update_mask}
-            # should be used to specify the fields being updated.
-            #
-            # @overload update_spec(request, options = nil)
-            #   Pass arguments to `update_spec` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::UpdateSpecRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::UpdateSpecRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload update_spec(spec: nil, update_mask: nil)
-            #   Pass arguments to `update_spec` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param spec [::Google::Cloud::ApiHub::V1::Spec, ::Hash]
-            #     Required. The spec to update.
-            #
-            #     The spec's `name` field is used to identify the spec to
-            #     update. Format:
-            #     `projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}`
-            #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     Required. The list of fields to update.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Spec]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Spec]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::UpdateSpecRequest.new
-            #
-            #   # Call the update_spec method.
-            #   result = client.update_spec request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Spec.
-            #   p result
-            #
-            def update_spec request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::UpdateSpecRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.update_spec.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.spec&.name
-                header_params["spec.name"] = request.spec.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.update_spec.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.update_spec.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :update_spec, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Delete a spec.
-            # Deleting a spec will also delete the associated operations from the
-            # version.
-            #
-            # @overload delete_spec(request, options = nil)
-            #   Pass arguments to `delete_spec` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::DeleteSpecRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::DeleteSpecRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload delete_spec(name: nil)
-            #   Pass arguments to `delete_spec` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the spec  to delete.
-            #     Format:
-            #     `projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}`
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Protobuf::Empty]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Protobuf::Empty]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::DeleteSpecRequest.new
-            #
-            #   # Call the delete_spec method.
-            #   result = client.delete_spec request
-            #
-            #   # The returned object is of type Google::Protobuf::Empty.
-            #   p result
-            #
-            def delete_spec request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::DeleteSpecRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.delete_spec.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.delete_spec.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.delete_spec.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :delete_spec, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Get details about a particular operation in API version.
-            #
-            # @overload get_api_operation(request, options = nil)
-            #   Pass arguments to `get_api_operation` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::GetApiOperationRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::GetApiOperationRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload get_api_operation(name: nil)
-            #   Pass arguments to `get_api_operation` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the operation to retrieve.
-            #     Format:
-            #     `projects/{project}/locations/{location}/apis/{api}/versions/{version}/operations/{operation}`
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::ApiOperation]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::ApiOperation]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::GetApiOperationRequest.new
-            #
-            #   # Call the get_api_operation method.
-            #   result = client.get_api_operation request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::ApiOperation.
-            #   p result
-            #
-            def get_api_operation request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::GetApiOperationRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.get_api_operation.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.get_api_operation.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.get_api_operation.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :get_api_operation, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # List operations in an API version.
-            #
-            # @overload list_api_operations(request, options = nil)
-            #   Pass arguments to `list_api_operations` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::ListApiOperationsRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::ListApiOperationsRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload list_api_operations(parent: nil, filter: nil, page_size: nil, page_token: nil)
-            #   Pass arguments to `list_api_operations` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param parent [::String]
-            #     Required. The parent which owns this collection of operations i.e., the API
-            #     version. Format:
-            #     `projects/{project}/locations/{location}/apis/{api}/versions/{version}`
-            #   @param filter [::String]
-            #     Optional. An expression that filters the list of ApiOperations.
-            #
-            #     A filter expression consists of a field name, a comparison
-            #     operator, and a value for filtering. The value must be a string or a
-            #     boolean. The comparison operator must be one of: `<`, `>` or
-            #     `=`. Filters are not case sensitive.
-            #
-            #     The following fields in the `ApiOperation` are eligible for filtering:
-            #       * `name` - The ApiOperation resource name. Allowed comparison
-            #       operators:
-            #       `=`.
-            #       * `details.http_operation.path.path` - The http operation's complete path
-            #       relative to server endpoint. Allowed comparison operators: `=`.
-            #       * `details.http_operation.method` - The http operation method type.
-            #       Allowed comparison operators: `=`.
-            #       * `details.deprecated` - Indicates if the ApiOperation is deprecated.
-            #       Allowed values are True / False indicating the deprycation status of the
-            #       ApiOperation. Allowed comparison operators: `=`.
-            #       * `create_time` - The time at which the ApiOperation was created. The
-            #       value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339]
-            #       format. Allowed comparison operators: `>` and `<`.
-            #
-            #     Expressions are combined with either `AND` logic operator or `OR` logical
-            #     operator but not both of them together i.e. only one of the `AND` or `OR`
-            #     operator can be used throughout the filter string and both the operators
-            #     cannot be used together. No other logical operators are supported. At most
-            #     three filter fields are allowed in the filter string and if provided
-            #     more than that then `INVALID_ARGUMENT` error is returned by the API.
-            #
-            #     Here are a few examples:
-            #
-            #       * `details.deprecated = True` -  The ApiOperation is deprecated.
-            #       * `details.http_operation.method = GET AND create_time <
-            #       \"2021-08-15T14:50:00Z\" AND create_time > \"2021-08-10T12:00:00Z\"` -
-            #       The method of the http operation of the ApiOperation is _GET_ and the
-            #       spec was created before _2021-08-15 14:50:00 UTC_ and after _2021-08-10
-            #       12:00:00 UTC_.
-            #       * `details.http_operation.method = GET OR details.http_operation.method =
-            #       POST`. - The http operation of the method of ApiOperation is _GET_ or
-            #       _POST_.
-            #   @param page_size [::Integer]
-            #     Optional. The maximum number of operations to return. The service may
-            #     return fewer than this value. If unspecified, at most 50 operations will be
-            #     returned. The maximum value is 1000; values above 1000 will be coerced to
-            #     1000.
-            #   @param page_token [::String]
-            #     Optional. A page token, received from a previous `ListApiOperations` call.
-            #     Provide this to retrieve the subsequent page.
-            #
-            #     When paginating, all other parameters (except page_size) provided to
-            #     `ListApiOperations` must match the call that provided the page token.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::ApiOperation>]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::ApiOperation>]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::ListApiOperationsRequest.new
-            #
-            #   # Call the list_api_operations method.
-            #   result = client.list_api_operations request
-            #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
-            #   # over elements, and API calls will be issued to fetch pages as needed.
-            #   result.each do |item|
-            #     # Each element is of type ::Google::Cloud::ApiHub::V1::ApiOperation.
-            #     p item
-            #   end
-            #
-            def list_api_operations request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::ListApiOperationsRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.list_api_operations.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.parent
-                header_params["parent"] = request.parent
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.list_api_operations.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.list_api_operations.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :list_api_operations, request, options: options do |response, operation|
-                response = ::Gapic::PagedEnumerable.new @api_hub_stub, :list_api_operations, request, response, operation, options
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Get details about a definition in an API version.
-            #
-            # @overload get_definition(request, options = nil)
-            #   Pass arguments to `get_definition` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::GetDefinitionRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::GetDefinitionRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload get_definition(name: nil)
-            #   Pass arguments to `get_definition` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the definition to retrieve.
-            #     Format:
-            #     `projects/{project}/locations/{location}/apis/{api}/versions/{version}/definitions/{definition}`
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Definition]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Definition]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::GetDefinitionRequest.new
-            #
-            #   # Call the get_definition method.
-            #   result = client.get_definition request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Definition.
-            #   p result
-            #
-            def get_definition request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::GetDefinitionRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.get_definition.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.get_definition.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.get_definition.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :get_definition, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Create a deployment resource in the API hub.
-            # Once a deployment resource is created, it can be associated with API
-            # versions.
-            #
-            # @overload create_deployment(request, options = nil)
-            #   Pass arguments to `create_deployment` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::CreateDeploymentRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::CreateDeploymentRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload create_deployment(parent: nil, deployment_id: nil, deployment: nil)
-            #   Pass arguments to `create_deployment` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param parent [::String]
-            #     Required. The parent resource for the deployment resource.
-            #     Format: `projects/{project}/locations/{location}`
-            #   @param deployment_id [::String]
-            #     Optional. The ID to use for the deployment resource, which will become the
-            #     final component of the deployment's resource name. This field is optional.
-            #
-            #     * If provided, the same will be used. The service will throw an error if
-            #     the specified id is already used by another deployment resource in the API
-            #     hub.
-            #     * If not provided, a system generated id will be used.
-            #
-            #     This value should be 4-500 characters, and valid characters
-            #     are /[a-z][A-Z][0-9]-_/.
-            #   @param deployment [::Google::Cloud::ApiHub::V1::Deployment, ::Hash]
-            #     Required. The deployment resource to create.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Deployment]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Deployment]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::CreateDeploymentRequest.new
-            #
-            #   # Call the create_deployment method.
-            #   result = client.create_deployment request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Deployment.
-            #   p result
-            #
-            def create_deployment request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::CreateDeploymentRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.create_deployment.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.parent
-                header_params["parent"] = request.parent
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.create_deployment.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.create_deployment.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :create_deployment, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Get details about a deployment and the API versions linked to it.
-            #
-            # @overload get_deployment(request, options = nil)
-            #   Pass arguments to `get_deployment` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::GetDeploymentRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::GetDeploymentRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload get_deployment(name: nil)
-            #   Pass arguments to `get_deployment` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the deployment resource to retrieve.
-            #     Format: `projects/{project}/locations/{location}/deployments/{deployment}`
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Deployment]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Deployment]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::GetDeploymentRequest.new
-            #
-            #   # Call the get_deployment method.
-            #   result = client.get_deployment request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Deployment.
-            #   p result
-            #
-            def get_deployment request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::GetDeploymentRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.get_deployment.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.get_deployment.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.get_deployment.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :get_deployment, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # List deployment resources in the API hub.
-            #
-            # @overload list_deployments(request, options = nil)
-            #   Pass arguments to `list_deployments` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::ListDeploymentsRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::ListDeploymentsRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload list_deployments(parent: nil, filter: nil, page_size: nil, page_token: nil)
-            #   Pass arguments to `list_deployments` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param parent [::String]
-            #     Required. The parent, which owns this collection of deployment resources.
-            #     Format: `projects/{project}/locations/{location}`
-            #   @param filter [::String]
-            #     Optional. An expression that filters the list of Deployments.
-            #
-            #     A filter expression consists of a field name, a comparison
-            #     operator, and a value for filtering. The value must be a string. The
-            #     comparison operator must be one of: `<`, `>` or
-            #     `=`. Filters are not case sensitive.
-            #
-            #     The following fields in the `Deployments` are eligible for filtering:
-            #
-            #       * `display_name` - The display name of the Deployment. Allowed
-            #       comparison operators: `=`.
-            #       * `create_time` - The time at which the Deployment was created. The
-            #       value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339]
-            #       format. Allowed comparison operators: `>` and `<`.
-            #       * `resource_uri` - A URI to the deployment resource. Allowed
-            #       comparison operators: `=`.
-            #       * `api_versions` - The API versions linked to this deployment. Allowed
-            #       comparison operators: `:`.
-            #       * `deployment_type.enum_values.values.id` - The allowed value id of the
-            #       deployment_type attribute associated with the Deployment. Allowed
-            #       comparison operators: `:`.
-            #       * `deployment_type.enum_values.values.display_name` - The allowed value
-            #       display name of the deployment_type attribute associated with the
-            #       Deployment. Allowed comparison operators: `:`.
-            #       * `slo.string_values.values` -The allowed string value of the slo
-            #       attribute associated with the deployment. Allowed comparison
-            #       operators: `:`.
-            #       * `environment.enum_values.values.id` - The allowed value id of the
-            #       environment attribute associated with the deployment. Allowed
-            #       comparison operators: `:`.
-            #       * `environment.enum_values.values.display_name` - The allowed value
-            #       display name of the environment attribute associated with the deployment.
-            #       Allowed comparison operators: `:`.
-            #
-            #     Expressions are combined with either `AND` logic operator or `OR` logical
-            #     operator but not both of them together i.e. only one of the `AND` or `OR`
-            #     operator can be used throughout the filter string and both the operators
-            #     cannot be used together. No other logical operators are supported. At most
-            #     three filter fields are allowed in the filter string and if provided
-            #     more than that then `INVALID_ARGUMENT` error is returned by the API.
-            #
-            #     Here are a few examples:
-            #
-            #       * `environment.enum_values.values.id: staging-id` - The allowed value id
-            #       of the environment attribute associated with the Deployment is
-            #       _staging-id_.
-            #       * `environment.enum_values.values.display_name: \"Staging Deployment\"` -
-            #       The allowed value display name of the environment attribute associated
-            #       with the Deployment is `Staging Deployment`.
-            #       * `environment.enum_values.values.id: production-id AND create_time <
-            #       \"2021-08-15T14:50:00Z\" AND create_time > \"2021-08-10T12:00:00Z\"` -
-            #       The allowed value id of the environment attribute associated with the
-            #       Deployment is _production-id_ and Deployment was created before
-            #       _2021-08-15 14:50:00 UTC_ and after _2021-08-10 12:00:00 UTC_.
-            #       * `environment.enum_values.values.id: production-id OR
-            #       slo.string_values.values: \"99.99%\"`
-            #       - The allowed value id of the environment attribute Deployment is
-            #       _production-id_ or string value of the slo attribute is _99.99%_.
-            #   @param page_size [::Integer]
-            #     Optional. The maximum number of deployment resources to return. The service
-            #     may return fewer than this value. If unspecified, at most 50 deployments
-            #     will be returned. The maximum value is 1000; values above 1000 will be
-            #     coerced to 1000.
-            #   @param page_token [::String]
-            #     Optional. A page token, received from a previous `ListDeployments` call.
-            #     Provide this to retrieve the subsequent page.
-            #
-            #     When paginating, all other parameters (except page_size) provided to
-            #     `ListDeployments` must match the call that provided the page token.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::Deployment>]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::Deployment>]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::ListDeploymentsRequest.new
-            #
-            #   # Call the list_deployments method.
-            #   result = client.list_deployments request
-            #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
-            #   # over elements, and API calls will be issued to fetch pages as needed.
-            #   result.each do |item|
-            #     # Each element is of type ::Google::Cloud::ApiHub::V1::Deployment.
-            #     p item
-            #   end
-            #
-            def list_deployments request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::ListDeploymentsRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.list_deployments.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.parent
-                header_params["parent"] = request.parent
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.list_deployments.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.list_deployments.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :list_deployments, request, options: options do |response, operation|
-                response = ::Gapic::PagedEnumerable.new @api_hub_stub, :list_deployments, request, response, operation, options
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Update a deployment resource in the API hub. The following fields in the
-            # {::Google::Cloud::ApiHub::V1::Deployment deployment resource} can be
-            # updated:
-            #
-            # * {::Google::Cloud::ApiHub::V1::Deployment#display_name display_name}
-            # * {::Google::Cloud::ApiHub::V1::Deployment#description description}
-            # * {::Google::Cloud::ApiHub::V1::Deployment#documentation documentation}
-            # * {::Google::Cloud::ApiHub::V1::Deployment#deployment_type deployment_type}
-            # * {::Google::Cloud::ApiHub::V1::Deployment#resource_uri resource_uri}
-            # * {::Google::Cloud::ApiHub::V1::Deployment#endpoints endpoints}
-            # * {::Google::Cloud::ApiHub::V1::Deployment#slo slo}
-            # * {::Google::Cloud::ApiHub::V1::Deployment#environment environment}
-            # * {::Google::Cloud::ApiHub::V1::Deployment#attributes attributes}
-            #
-            # The
-            # {::Google::Cloud::ApiHub::V1::UpdateDeploymentRequest#update_mask update_mask}
-            # should be used to specify the fields being updated.
-            #
-            # @overload update_deployment(request, options = nil)
-            #   Pass arguments to `update_deployment` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::UpdateDeploymentRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::UpdateDeploymentRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload update_deployment(deployment: nil, update_mask: nil)
-            #   Pass arguments to `update_deployment` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param deployment [::Google::Cloud::ApiHub::V1::Deployment, ::Hash]
-            #     Required. The deployment resource to update.
-            #
-            #     The deployment resource's `name` field is used to identify the deployment
-            #     resource to update.
-            #     Format: `projects/{project}/locations/{location}/deployments/{deployment}`
-            #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     Required. The list of fields to update.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Deployment]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Deployment]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::UpdateDeploymentRequest.new
-            #
-            #   # Call the update_deployment method.
-            #   result = client.update_deployment request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Deployment.
-            #   p result
-            #
-            def update_deployment request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::UpdateDeploymentRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.update_deployment.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.deployment&.name
-                header_params["deployment.name"] = request.deployment.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.update_deployment.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.update_deployment.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :update_deployment, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Delete a deployment resource in the API hub.
-            #
-            # @overload delete_deployment(request, options = nil)
-            #   Pass arguments to `delete_deployment` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::DeleteDeploymentRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::DeleteDeploymentRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload delete_deployment(name: nil)
-            #   Pass arguments to `delete_deployment` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the deployment resource to delete.
-            #     Format: `projects/{project}/locations/{location}/deployments/{deployment}`
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Protobuf::Empty]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Protobuf::Empty]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::DeleteDeploymentRequest.new
-            #
-            #   # Call the delete_deployment method.
-            #   result = client.delete_deployment request
-            #
-            #   # The returned object is of type Google::Protobuf::Empty.
-            #   p result
-            #
-            def delete_deployment request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::DeleteDeploymentRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.delete_deployment.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.delete_deployment.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.delete_deployment.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :delete_deployment, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Create a user defined attribute.
-            #
-            # Certain pre defined attributes are already created by the API hub. These
-            # attributes will have type as `SYSTEM_DEFINED` and can be listed via
-            # {::Google::Cloud::ApiHub::V1::ApiHub::Client#list_attributes ListAttributes} method.
-            # Allowed values for the same can be updated via
-            # {::Google::Cloud::ApiHub::V1::ApiHub::Client#update_attribute UpdateAttribute} method.
-            #
-            # @overload create_attribute(request, options = nil)
-            #   Pass arguments to `create_attribute` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::CreateAttributeRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::CreateAttributeRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload create_attribute(parent: nil, attribute_id: nil, attribute: nil)
-            #   Pass arguments to `create_attribute` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param parent [::String]
-            #     Required. The parent resource for Attribute.
-            #     Format: `projects/{project}/locations/{location}`
-            #   @param attribute_id [::String]
-            #     Optional. The ID to use for the attribute, which will become the final
-            #     component of the attribute's resource name. This field is optional.
-            #
-            #     * If provided, the same will be used. The service will throw an error if
-            #     the specified id is already used by another attribute resource in the API
-            #     hub.
-            #     * If not provided, a system generated id will be used.
-            #
-            #     This value should be 4-500 characters, and valid characters
-            #     are /[a-z][A-Z][0-9]-_/.
-            #   @param attribute [::Google::Cloud::ApiHub::V1::Attribute, ::Hash]
-            #     Required. The attribute to create.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Attribute]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Attribute]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::CreateAttributeRequest.new
-            #
-            #   # Call the create_attribute method.
-            #   result = client.create_attribute request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Attribute.
-            #   p result
-            #
-            def create_attribute request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::CreateAttributeRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.create_attribute.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.parent
-                header_params["parent"] = request.parent
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.create_attribute.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.create_attribute.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :create_attribute, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Get details about the attribute.
-            #
-            # @overload get_attribute(request, options = nil)
-            #   Pass arguments to `get_attribute` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::GetAttributeRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::GetAttributeRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload get_attribute(name: nil)
-            #   Pass arguments to `get_attribute` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the attribute to retrieve.
-            #     Format:
-            #     `projects/{project}/locations/{location}/attributes/{attribute}`
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Attribute]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Attribute]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::GetAttributeRequest.new
-            #
-            #   # Call the get_attribute method.
-            #   result = client.get_attribute request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Attribute.
-            #   p result
-            #
-            def get_attribute request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::GetAttributeRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.get_attribute.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.get_attribute.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.get_attribute.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :get_attribute, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Update the attribute.  The following fields in the
-            # {::Google::Cloud::ApiHub::V1::Attribute Attribute resource} can be updated:
-            #
-            # * {::Google::Cloud::ApiHub::V1::Attribute#display_name display_name}
-            # The display name can be updated for user defined attributes only.
-            # * {::Google::Cloud::ApiHub::V1::Attribute#description description}
-            # The description can be updated for user defined attributes only.
-            # * {::Google::Cloud::ApiHub::V1::Attribute#allowed_values allowed_values}
-            # To update the list of allowed values, clients need to use the fetched list
-            # of allowed values and add or remove values to or from the same list.
-            # The mutable allowed values can be updated for both user defined and System
-            # defined attributes. The immutable allowed values cannot be updated or
-            # deleted. The updated list of allowed values cannot be empty. If an allowed
-            # value that is already used by some resource's attribute is deleted, then
-            # the association between the resource and the attribute value will also be
-            # deleted.
-            # * {::Google::Cloud::ApiHub::V1::Attribute#cardinality cardinality}
-            # The cardinality can be updated for user defined attributes only.
-            # Cardinality can only be increased during an update.
-            #
-            # The
-            # {::Google::Cloud::ApiHub::V1::UpdateAttributeRequest#update_mask update_mask}
-            # should be used to specify the fields being updated.
-            #
-            # @overload update_attribute(request, options = nil)
-            #   Pass arguments to `update_attribute` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::UpdateAttributeRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::UpdateAttributeRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload update_attribute(attribute: nil, update_mask: nil)
-            #   Pass arguments to `update_attribute` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param attribute [::Google::Cloud::ApiHub::V1::Attribute, ::Hash]
-            #     Required. The attribute to update.
-            #
-            #     The attribute's `name` field is used to identify the attribute to update.
-            #     Format:
-            #     `projects/{project}/locations/{location}/attributes/{attribute}`
-            #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     Required. The list of fields to update.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::Attribute]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::Attribute]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::UpdateAttributeRequest.new
-            #
-            #   # Call the update_attribute method.
-            #   result = client.update_attribute request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::Attribute.
-            #   p result
-            #
-            def update_attribute request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::UpdateAttributeRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.update_attribute.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.attribute&.name
-                header_params["attribute.name"] = request.attribute.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.update_attribute.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.update_attribute.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :update_attribute, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Delete an attribute.
-            #
-            # Note: System defined attributes cannot be deleted. All
-            # associations of the attribute being deleted with any API hub resource will
-            # also get deleted.
-            #
-            # @overload delete_attribute(request, options = nil)
-            #   Pass arguments to `delete_attribute` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::DeleteAttributeRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::DeleteAttributeRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload delete_attribute(name: nil)
-            #   Pass arguments to `delete_attribute` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the attribute to delete.
-            #     Format:
-            #     `projects/{project}/locations/{location}/attributes/{attribute}`
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Protobuf::Empty]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Protobuf::Empty]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::DeleteAttributeRequest.new
-            #
-            #   # Call the delete_attribute method.
-            #   result = client.delete_attribute request
-            #
-            #   # The returned object is of type Google::Protobuf::Empty.
-            #   p result
-            #
-            def delete_attribute request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::DeleteAttributeRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.delete_attribute.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.delete_attribute.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.delete_attribute.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :delete_attribute, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # List all attributes.
-            #
-            # @overload list_attributes(request, options = nil)
-            #   Pass arguments to `list_attributes` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::ListAttributesRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::ListAttributesRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload list_attributes(parent: nil, filter: nil, page_size: nil, page_token: nil)
-            #   Pass arguments to `list_attributes` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param parent [::String]
-            #     Required. The parent resource for Attribute.
-            #     Format: `projects/{project}/locations/{location}`
-            #   @param filter [::String]
-            #     Optional. An expression that filters the list of Attributes.
-            #
-            #     A filter expression consists of a field name, a comparison
-            #     operator, and a value for filtering. The value must be a string or a
-            #     boolean. The comparison operator must be one of: `<`, `>` or
-            #     `=`. Filters are not case sensitive.
-            #
-            #     The following fields in the `Attribute` are eligible for filtering:
-            #
-            #       * `display_name` - The display name of the Attribute. Allowed
-            #       comparison operators: `=`.
-            #       * `definition_type` - The definition type of the attribute. Allowed
-            #       comparison operators: `=`.
-            #       * `scope` - The scope of the attribute. Allowed comparison operators:
-            #       `=`.
-            #       * `data_type` - The type of the data of the attribute. Allowed
-            #       comparison operators: `=`.
-            #       * `mandatory` - Denotes whether the attribute is mandatory or not.
-            #       Allowed comparison operators: `=`.
-            #       * `create_time` - The time at which the Attribute was created. The
-            #       value should be in the (RFC3339)[https://tools.ietf.org/html/rfc3339]
-            #       format. Allowed comparison operators: `>` and `<`.
-            #
-            #     Expressions are combined with either `AND` logic operator or `OR` logical
-            #     operator but not both of them together i.e. only one of the `AND` or `OR`
-            #     operator can be used throughout the filter string and both the operators
-            #     cannot be used together. No other logical operators are
-            #     supported. At most three filter fields are allowed in the filter
-            #     string and if provided more than that then `INVALID_ARGUMENT` error is
-            #     returned by the API.
-            #
-            #     Here are a few examples:
-            #
-            #       * `display_name = production` -  - The display name of the attribute is
-            #       _production_.
-            #       * `(display_name = production) AND (create_time <
-            #       \"2021-08-15T14:50:00Z\") AND (create_time > \"2021-08-10T12:00:00Z\")` -
-            #       The display name of the attribute is _production_ and the attribute was
-            #       created before _2021-08-15 14:50:00 UTC_ and after _2021-08-10 12:00:00
-            #       UTC_.
-            #       * `display_name = production OR scope = api` -
-            #       The attribute where the display name is _production_ or the scope is
-            #       _api_.
-            #   @param page_size [::Integer]
-            #     Optional. The maximum number of attribute resources to return. The service
-            #     may return fewer than this value. If unspecified, at most 50 attributes
-            #     will be returned. The maximum value is 1000; values above 1000 will be
-            #     coerced to 1000.
-            #   @param page_token [::String]
-            #     Optional. A page token, received from a previous `ListAttributes` call.
-            #     Provide this to retrieve the subsequent page.
-            #
-            #     When paginating, all other parameters provided to `ListAttributes` must
-            #     match the call that provided the page token.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::Attribute>]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::Attribute>]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::ListAttributesRequest.new
-            #
-            #   # Call the list_attributes method.
-            #   result = client.list_attributes request
-            #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
-            #   # over elements, and API calls will be issued to fetch pages as needed.
-            #   result.each do |item|
-            #     # Each element is of type ::Google::Cloud::ApiHub::V1::Attribute.
-            #     p item
-            #   end
-            #
-            def list_attributes request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::ListAttributesRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.list_attributes.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.parent
-                header_params["parent"] = request.parent
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.list_attributes.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.list_attributes.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :list_attributes, request, options: options do |response, operation|
-                response = ::Gapic::PagedEnumerable.new @api_hub_stub, :list_attributes, request, response, operation, options
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Search across API-Hub resources.
-            #
-            # @overload search_resources(request, options = nil)
-            #   Pass arguments to `search_resources` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::SearchResourcesRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::SearchResourcesRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload search_resources(location: nil, query: nil, filter: nil, page_size: nil, page_token: nil)
-            #   Pass arguments to `search_resources` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param location [::String]
-            #     Required. The resource name of the location which will be of the type
-            #     `projects/{project_id}/locations/{location_id}`. This field is used to
-            #     identify the instance of API-Hub in which resources should be searched.
-            #   @param query [::String]
-            #     Required. The free text search query. This query can contain keywords which
-            #     could be related to any detail of the API-Hub resources such display names,
-            #     descriptions, attributes etc.
-            #   @param filter [::String]
-            #     Optional. An expression that filters the list of search results.
-            #
-            #     A filter expression consists of a field name, a comparison operator,
-            #     and a value for filtering. The value must be a string, a number, or a
-            #     boolean. The comparison operator must be `=`. Filters are not case
-            #     sensitive.
-            #
-            #     The following field names are eligible for filtering:
-            #        * `resource_type` - The type of resource in the search results.
-            #        Must be one of the following: `Api`, `ApiOperation`, `Deployment`,
-            #        `Definition`, `Spec` or `Version`. This field can only be specified once
-            #        in the filter.
-            #
-            #     Here are is an example:
-            #
-            #       * `resource_type = Api` - The resource_type is _Api_.
-            #   @param page_size [::Integer]
-            #     Optional. The maximum number of search results to return. The service may
-            #     return fewer than this value. If unspecified at most 10 search results will
-            #     be returned. If value is negative then `INVALID_ARGUMENT` error is
-            #     returned. The maximum value is 25; values above 25 will be coerced to 25.
-            #     While paginating, you can specify a new page size parameter for each page
-            #     of search results to be listed.
-            #   @param page_token [::String]
-            #     Optional. A page token, received from a previous
-            #     [SearchResources][SearchResources]
-            #     call. Specify this parameter to retrieve the next page of transactions.
-            #
-            #     When paginating, you must specify the `page_token` parameter and all the
-            #     other parameters except
-            #     {::Google::Cloud::ApiHub::V1::SearchResourcesRequest#page_size page_size}
-            #     should be specified with the same value which was used in the previous
-            #     call. If the other fields are set with a different value than the previous
-            #     call then `INVALID_ARGUMENT` error is returned.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::SearchResult>]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::SearchResult>]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::SearchResourcesRequest.new
-            #
-            #   # Call the search_resources method.
-            #   result = client.search_resources request
-            #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
-            #   # over elements, and API calls will be issued to fetch pages as needed.
-            #   result.each do |item|
-            #     # Each element is of type ::Google::Cloud::ApiHub::V1::SearchResult.
-            #     p item
-            #   end
-            #
-            def search_resources request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::SearchResourcesRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.search_resources.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.location
-                header_params["location"] = request.location
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.search_resources.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.search_resources.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :search_resources, request, options: options do |response, operation|
-                response = ::Gapic::PagedEnumerable.new @api_hub_stub, :search_resources, request, response, operation, options
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Create an External API resource in the API hub.
-            #
-            # @overload create_external_api(request, options = nil)
-            #   Pass arguments to `create_external_api` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::CreateExternalApiRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::CreateExternalApiRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload create_external_api(parent: nil, external_api_id: nil, external_api: nil)
-            #   Pass arguments to `create_external_api` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param parent [::String]
-            #     Required. The parent resource for the External API resource.
-            #     Format: `projects/{project}/locations/{location}`
-            #   @param external_api_id [::String]
-            #     Optional. The ID to use for the External API resource, which will become
-            #     the final component of the External API's resource name. This field is
-            #     optional.
-            #
-            #     * If provided, the same will be used. The service will throw an error if
-            #     the specified id is already used by another External API resource in the
-            #     API hub.
-            #     * If not provided, a system generated id will be used.
-            #
-            #     This value should be 4-500 characters, and valid characters
-            #     are /[a-z][A-Z][0-9]-_/.
-            #   @param external_api [::Google::Cloud::ApiHub::V1::ExternalApi, ::Hash]
-            #     Required. The External API resource to create.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::ExternalApi]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::ExternalApi]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::CreateExternalApiRequest.new
-            #
-            #   # Call the create_external_api method.
-            #   result = client.create_external_api request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::ExternalApi.
-            #   p result
-            #
-            def create_external_api request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::CreateExternalApiRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.create_external_api.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.parent
-                header_params["parent"] = request.parent
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.create_external_api.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.create_external_api.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :create_external_api, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Get details about an External API resource in the API hub.
-            #
-            # @overload get_external_api(request, options = nil)
-            #   Pass arguments to `get_external_api` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::GetExternalApiRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::GetExternalApiRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload get_external_api(name: nil)
-            #   Pass arguments to `get_external_api` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the External API resource to retrieve.
-            #     Format:
-            #     `projects/{project}/locations/{location}/externalApis/{externalApi}`
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::ExternalApi]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::ExternalApi]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::GetExternalApiRequest.new
-            #
-            #   # Call the get_external_api method.
-            #   result = client.get_external_api request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::ExternalApi.
-            #   p result
-            #
-            def get_external_api request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::GetExternalApiRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.get_external_api.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.get_external_api.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.get_external_api.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :get_external_api, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Update an External API resource in the API hub. The following fields can be
-            # updated:
-            #
-            # * {::Google::Cloud::ApiHub::V1::ExternalApi#display_name display_name}
-            # * {::Google::Cloud::ApiHub::V1::ExternalApi#description description}
-            # * {::Google::Cloud::ApiHub::V1::ExternalApi#documentation documentation}
-            # * {::Google::Cloud::ApiHub::V1::ExternalApi#endpoints endpoints}
-            # * {::Google::Cloud::ApiHub::V1::ExternalApi#paths paths}
-            #
-            # The
-            # {::Google::Cloud::ApiHub::V1::UpdateExternalApiRequest#update_mask update_mask}
-            # should be used to specify the fields being updated.
-            #
-            # @overload update_external_api(request, options = nil)
-            #   Pass arguments to `update_external_api` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::UpdateExternalApiRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::UpdateExternalApiRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload update_external_api(external_api: nil, update_mask: nil)
-            #   Pass arguments to `update_external_api` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param external_api [::Google::Cloud::ApiHub::V1::ExternalApi, ::Hash]
-            #     Required. The External API resource to update.
-            #
-            #     The External API resource's `name` field is used to identify the External
-            #     API resource to update. Format:
-            #     `projects/{project}/locations/{location}/externalApis/{externalApi}`
-            #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     Required. The list of fields to update.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Cloud::ApiHub::V1::ExternalApi]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Cloud::ApiHub::V1::ExternalApi]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::UpdateExternalApiRequest.new
-            #
-            #   # Call the update_external_api method.
-            #   result = client.update_external_api request
-            #
-            #   # The returned object is of type Google::Cloud::ApiHub::V1::ExternalApi.
-            #   p result
-            #
-            def update_external_api request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::UpdateExternalApiRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.update_external_api.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.external_api&.name
-                header_params["external_api.name"] = request.external_api.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.update_external_api.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.update_external_api.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :update_external_api, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Delete an External API resource in the API hub.
-            #
-            # @overload delete_external_api(request, options = nil)
-            #   Pass arguments to `delete_external_api` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::DeleteExternalApiRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::DeleteExternalApiRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload delete_external_api(name: nil)
-            #   Pass arguments to `delete_external_api` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param name [::String]
-            #     Required. The name of the External API resource to delete.
-            #     Format:
-            #     `projects/{project}/locations/{location}/externalApis/{externalApi}`
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Google::Protobuf::Empty]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Google::Protobuf::Empty]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::DeleteExternalApiRequest.new
-            #
-            #   # Call the delete_external_api method.
-            #   result = client.delete_external_api request
-            #
-            #   # The returned object is of type Google::Protobuf::Empty.
-            #   p result
-            #
-            def delete_external_api request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::DeleteExternalApiRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.delete_external_api.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.name
-                header_params["name"] = request.name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.delete_external_api.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.delete_external_api.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :delete_external_api, request, options: options do |response, operation|
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # List External API resources in the API hub.
-            #
-            # @overload list_external_apis(request, options = nil)
-            #   Pass arguments to `list_external_apis` via a request object, either of type
-            #   {::Google::Cloud::ApiHub::V1::ListExternalApisRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ApiHub::V1::ListExternalApisRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload list_external_apis(parent: nil, page_size: nil, page_token: nil)
-            #   Pass arguments to `list_external_apis` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param parent [::String]
-            #     Required. The parent, which owns this collection of External API resources.
-            #     Format: `projects/{project}/locations/{location}`
-            #   @param page_size [::Integer]
-            #     Optional. The maximum number of External API resources to return. The
-            #     service may return fewer than this value. If unspecified, at most 50
-            #     ExternalApis will be returned. The maximum value is 1000; values above 1000
-            #     will be coerced to 1000.
-            #   @param page_token [::String]
-            #     Optional. A page token, received from a previous `ListExternalApis` call.
-            #     Provide this to retrieve the subsequent page.
-            #
-            #     When paginating, all other parameters (except page_size) provided to
-            #     `ListExternalApis` must match the call that provided the page token.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::ExternalApi>]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Gapic::PagedEnumerable<::Google::Cloud::ApiHub::V1::ExternalApi>]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/api_hub/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ApiHub::V1::ApiHub::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ApiHub::V1::ListExternalApisRequest.new
-            #
-            #   # Call the list_external_apis method.
-            #   result = client.list_external_apis request
-            #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
-            #   # over elements, and API calls will be issued to fetch pages as needed.
-            #   result.each do |item|
-            #     # Each element is of type ::Google::Cloud::ApiHub::V1::ExternalApi.
-            #     p item
-            #   end
-            #
-            def list_external_apis request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ApiHub::V1::ListExternalApisRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.list_external_apis.metadata.to_h
-
-              # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ApiHub::V1::VERSION
-              metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.parent
-                header_params["parent"] = request.parent
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.list_external_apis.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.list_external_apis.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @api_hub_stub.call_rpc :list_external_apis, request, options: options do |response, operation|
-                response = ::Gapic::PagedEnumerable.new @api_hub_stub, :list_external_apis, request, response, operation, options
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Configuration class for the ApiHub API.
-            #
-            # This class represents the configuration for ApiHub,
-            # providing control over timeouts, retry behavior, logging, transport
-            # parameters, and other low-level controls. Certain parameters can also be
-            # applied individually to specific RPCs. See
-            # {::Google::Cloud::ApiHub::V1::ApiHub::Client::Configuration::Rpcs}
-            # for a list of RPCs that can be configured independently.
-            #
-            # Configuration can be applied globally to all clients, or to a single client
-            # on construction.
-            #
-            # @example
-            #
-            #   # Modify the global config, setting the timeout for
-            #   # create_api to 20 seconds,
-            #   # and all remaining timeouts to 10 seconds.
-            #   ::Google::Cloud::ApiHub::V1::ApiHub::Client.configure do |config|
-            #     config.timeout = 10.0
-            #     config.rpcs.create_api.timeout = 20.0
-            #   end
-            #
-            #   # Apply the above configuration only to a new client.
-            #   client = ::Google::Cloud::ApiHub::V1::ApiHub::Client.new do |config|
-            #     config.timeout = 10.0
-            #     config.rpcs.create_api.timeout = 20.0
-            #   end
-            #
-            # @!attribute [rw] endpoint
-            #   A custom service endpoint, as a hostname or hostname:port. The default is
-            #   nil, indicating to use the default endpoint in the current universe domain.
-            #   @return [::String,nil]
-            # @!attribute [rw] credentials
-            #   Credentials to send with calls. You may provide any of the following types:
-            #    *  (`String`) The path to a service account key file in JSON format
-            #    *  (`Hash`) A service account key as a Hash
-            #    *  (`Google::Auth::Credentials`) A googleauth credentials object
-            #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
-            #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
-            #       (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
-            #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
-            #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
-            #    *  (`nil`) indicating no credentials
-            #   @return [::Object]
-            # @!attribute [rw] scope
-            #   The OAuth scopes
-            #   @return [::Array<::String>]
-            # @!attribute [rw] lib_name
-            #   The library name as recorded in instrumentation and logging
-            #   @return [::String]
-            # @!attribute [rw] lib_version
-            #   The library version as recorded in instrumentation and logging
-            #   @return [::String]
-            # @!attribute [rw] channel_args
-            #   Extra parameters passed to the gRPC channel. Note: this is ignored if a
-            #   `GRPC::Core::Channel` object is provided as the credential.
-            #   @return [::Hash]
-            # @!attribute [rw] interceptors
-            #   An array of interceptors that are run before calls are executed.
-            #   @return [::Array<::GRPC::ClientInterceptor>]
-            # @!attribute [rw] timeout
-            #   The call timeout in seconds.
-            #   @return [::Numeric]
-            # @!attribute [rw] metadata
-            #   Additional gRPC headers to be sent with the call.
-            #   @return [::Hash{::Symbol=>::String}]
-            # @!attribute [rw] retry_policy
-            #   The retry policy. The value is a hash with the following keys:
-            #    *  `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
-            #    *  `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
-            #    *  `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
-            #    *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
-            #       trigger a retry.
-            #   @return [::Hash]
-            # @!attribute [rw] quota_project
-            #   A separate project against which to charge quota.
-            #   @return [::String]
-            # @!attribute [rw] universe_domain
-            #   The universe domain within which to make requests. This determines the
-            #   default endpoint URL. The default value of nil uses the environment
-            #   universe (usually the default "googleapis.com" universe).
-            #   @return [::String,nil]
-            #
-            class Configuration
-              extend ::Gapic::Config
-
-              # @private
-              # The endpoint specific to the default "googleapis.com" universe. Deprecated.
-              DEFAULT_ENDPOINT = "apihub.googleapis.com"
-
-              config_attr :endpoint,      nil, ::String, nil
-              config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
-                allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
-                allowed.any? { |klass| klass === value }
-              end
-              config_attr :scope,         nil, ::String, ::Array, nil
-              config_attr :lib_name,      nil, ::String, nil
-              config_attr :lib_version,   nil, ::String, nil
-              config_attr(:channel_args,  { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
-              config_attr :interceptors,  nil, ::Array, nil
-              config_attr :timeout,       nil, ::Numeric, nil
-              config_attr :metadata,      nil, ::Hash, nil
-              config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
-              config_attr :quota_project, nil, ::String, nil
-              config_attr :universe_domain, nil, ::String, nil
-
-              # @private
-              def initialize parent_config = nil
-                @parent_config = parent_config unless parent_config.nil?
-
-                yield self if block_given?
-              end
-
-              ##
-              # Configurations for individual RPCs
-              # @return [Rpcs]
-              #
-              def rpcs
-                @rpcs ||= begin
-                  parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
-                  Rpcs.new parent_rpcs
-                end
-              end
-
-              ##
-              # Configuration for the channel pool
-              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
-              #
-              def channel_pool
-                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
-              end
-
-              ##
-              # Configuration RPC class for the ApiHub API.
-              #
-              # Includes fields providing the configuration for each RPC in this service.
-              # Each configuration object is of type `Gapic::Config::Method` and includes
-              # the following configuration fields:
-              #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
-              #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
-              #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
-              #     include the following keys:
-              #      *  `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
-              #      *  `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
-              #      *  `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
-              #      *  `:retry_codes` (*type:* `Array<String>`) - The error codes that should
-              #         trigger a retry.
-              #
-              class Rpcs
-                ##
-                # RPC-specific configuration for `create_api`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :create_api
-                ##
-                # RPC-specific configuration for `get_api`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :get_api
-                ##
-                # RPC-specific configuration for `list_apis`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :list_apis
-                ##
-                # RPC-specific configuration for `update_api`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :update_api
-                ##
-                # RPC-specific configuration for `delete_api`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :delete_api
-                ##
-                # RPC-specific configuration for `create_version`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :create_version
-                ##
-                # RPC-specific configuration for `get_version`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :get_version
-                ##
-                # RPC-specific configuration for `list_versions`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :list_versions
-                ##
-                # RPC-specific configuration for `update_version`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :update_version
-                ##
-                # RPC-specific configuration for `delete_version`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :delete_version
-                ##
-                # RPC-specific configuration for `create_spec`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :create_spec
-                ##
-                # RPC-specific configuration for `get_spec`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :get_spec
-                ##
-                # RPC-specific configuration for `get_spec_contents`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :get_spec_contents
-                ##
-                # RPC-specific configuration for `list_specs`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :list_specs
-                ##
-                # RPC-specific configuration for `update_spec`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :update_spec
-                ##
-                # RPC-specific configuration for `delete_spec`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :delete_spec
-                ##
-                # RPC-specific configuration for `get_api_operation`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :get_api_operation
-                ##
-                # RPC-specific configuration for `list_api_operations`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :list_api_operations
-                ##
-                # RPC-specific configuration for `get_definition`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :get_definition
-                ##
-                # RPC-specific configuration for `create_deployment`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :create_deployment
-                ##
-                # RPC-specific configuration for `get_deployment`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :get_deployment
-                ##
-                # RPC-specific configuration for `list_deployments`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :list_deployments
-                ##
-                # RPC-specific configuration for `update_deployment`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :update_deployment
-                ##
-                # RPC-specific configuration for `delete_deployment`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :delete_deployment
-                ##
-                # RPC-specific configuration for `create_attribute`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :create_attribute
-                ##
-                # RPC-specific configuration for `get_attribute`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :get_attribute
-                ##
-                # RPC-specific configuration for `update_attribute`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :update_attribute
-                ##
-                # RPC-specific configuration for `delete_attribute`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :delete_attribute
-                ##
-                # RPC-specific configuration for `list_attributes`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :list_attributes
-                ##
-                # RPC-specific configuration for `search_resources`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :search_resources
-                ##
-                # RPC-specific configuration for `create_external_api`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :create_external_api
-                ##
-                # RPC-specific configuration for `get_external_api`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :get_external_api
-                ##
-                # RPC-specific configuration for `update_external_api`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :update_external_api
-                ##
-                # RPC-specific configuration for `delete_external_api`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :delete_external_api
-                ##
-                # RPC-specific configuration for `list_external_apis`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :list_external_apis
-
-                # @private
-                def initialize parent_rpcs = nil
-                  create_api_config = parent_rpcs.create_api if parent_rpcs.respond_to? :create_api
-                  @create_api = ::Gapic::Config::Method.new create_api_config
-                  get_api_config = parent_rpcs.get_api if parent_rpcs.respond_to? :get_api
-                  @get_api = ::Gapic::Config::Method.new get_api_config
-                  list_apis_config = parent_rpcs.list_apis if parent_rpcs.respond_to? :list_apis
-                  @list_apis = ::Gapic::Config::Method.new list_apis_config
-                  update_api_config = parent_rpcs.update_api if parent_rpcs.respond_to? :update_api
-                  @update_api = ::Gapic::Config::Method.new update_api_config
-                  delete_api_config = parent_rpcs.delete_api if parent_rpcs.respond_to? :delete_api
-                  @delete_api = ::Gapic::Config::Method.new delete_api_config
-                  create_version_config = parent_rpcs.create_version if parent_rpcs.respond_to? :create_version
-                  @create_version = ::Gapic::Config::Method.new create_version_config
-                  get_version_config = parent_rpcs.get_version if parent_rpcs.respond_to? :get_version
-                  @get_version = ::Gapic::Config::Method.new get_version_config
-                  list_versions_config = parent_rpcs.list_versions if parent_rpcs.respond_to? :list_versions
-                  @list_versions = ::Gapic::Config::Method.new list_versions_config
-                  update_version_config = parent_rpcs.update_version if parent_rpcs.respond_to? :update_version
-                  @update_version = ::Gapic::Config::Method.new update_version_config
-                  delete_version_config = parent_rpcs.delete_version if parent_rpcs.respond_to? :delete_version
-                  @delete_version = ::Gapic::Config::Method.new delete_version_config
-                  create_spec_config = parent_rpcs.create_spec if parent_rpcs.respond_to? :create_spec
-                  @create_spec = ::Gapic::Config::Method.new create_spec_config
-                  get_spec_config = parent_rpcs.get_spec if parent_rpcs.respond_to? :get_spec
-                  @get_spec = ::Gapic::Config::Method.new get_spec_config
-                  get_spec_contents_config = parent_rpcs.get_spec_contents if parent_rpcs.respond_to? :get_spec_contents
-                  @get_spec_contents = ::Gapic::Config::Method.new get_spec_contents_config
-                  list_specs_config = parent_rpcs.list_specs if parent_rpcs.respond_to? :list_specs
-                  @list_specs = ::Gapic::Config::Method.new list_specs_config
-                  update_spec_config = parent_rpcs.update_spec if parent_rpcs.respond_to? :update_spec
-                  @update_spec = ::Gapic::Config::Method.new update_spec_config
-                  delete_spec_config = parent_rpcs.delete_spec if parent_rpcs.respond_to? :delete_spec
-                  @delete_spec = ::Gapic::Config::Method.new delete_spec_config
-                  get_api_operation_config = parent_rpcs.get_api_operation if parent_rpcs.respond_to? :get_api_operation
-                  @get_api_operation = ::Gapic::Config::Method.new get_api_operation_config
-                  list_api_operations_config = parent_rpcs.list_api_operations if parent_rpcs.respond_to? :list_api_operations
-                  @list_api_operations = ::Gapic::Config::Method.new list_api_operations_config
-                  get_definition_config = parent_rpcs.get_definition if parent_rpcs.respond_to? :get_definition
-                  @get_definition = ::Gapic::Config::Method.new get_definition_config
-                  create_deployment_config = parent_rpcs.create_deployment if parent_rpcs.respond_to? :create_deployment
-                  @create_deployment = ::Gapic::Config::Method.new create_deployment_config
-                  get_deployment_config = parent_rpcs.get_deployment if parent_rpcs.respond_to? :get_deployment
-                  @get_deployment = ::Gapic::Config::Method.new get_deployment_config
-                  list_deployments_config = parent_rpcs.list_deployments if parent_rpcs.respond_to? :list_deployments
-                  @list_deployments = ::Gapic::Config::Method.new list_deployments_config
-                  update_deployment_config = parent_rpcs.update_deployment if parent_rpcs.respond_to? :update_deployment
-                  @update_deployment = ::Gapic::Config::Method.new update_deployment_config
-                  delete_deployment_config = parent_rpcs.delete_deployment if parent_rpcs.respond_to? :delete_deployment
-                  @delete_deployment = ::Gapic::Config::Method.new delete_deployment_config
-                  create_attribute_config = parent_rpcs.create_attribute if parent_rpcs.respond_to? :create_attribute
-                  @create_attribute = ::Gapic::Config::Method.new create_attribute_config
-                  get_attribute_config = parent_rpcs.get_attribute if parent_rpcs.respond_to? :get_attribute
-                  @get_attribute = ::Gapic::Config::Method.new get_attribute_config
-                  update_attribute_config = parent_rpcs.update_attribute if parent_rpcs.respond_to? :update_attribute
-                  @update_attribute = ::Gapic::Config::Method.new update_attribute_config
-                  delete_attribute_config = parent_rpcs.delete_attribute if parent_rpcs.respond_to? :delete_attribute
-                  @delete_attribute = ::Gapic::Config::Method.new delete_attribute_config
-                  list_attributes_config = parent_rpcs.list_attributes if parent_rpcs.respond_to? :list_attributes
-                  @list_attributes = ::Gapic::Config::Method.new list_attributes_config
-                  search_resources_config = parent_rpcs.search_resources if parent_rpcs.respond_to? :search_resources
-                  @search_resources = ::Gapic::Config::Method.new search_resources_config
-                  create_external_api_config = parent_rpcs.create_external_api if parent_rpcs.respond_to? :create_external_api
-                  @create_external_api = ::Gapic::Config::Method.new create_external_api_config
-                  get_external_api_config = parent_rpcs.get_external_api if parent_rpcs.respond_to? :get_external_api
-                  @get_external_api = ::Gapic::Config::Method.new get_external_api_config
-                  update_external_api_config = parent_rpcs.update_external_api if parent_rpcs.respond_to? :update_external_api
-                  @update_external_api = ::Gapic::Config::Method.new update_external_api_config
-                  delete_external_api_config = parent_rpcs.delete_external_api if parent_rpcs.respond_to? :delete_external_api
-                  @delete_external_api = ::Gapic::Config::Method.new delete_external_api_config
-                  list_external_apis_config = parent_rpcs.list_external_apis if parent_rpcs.respond_to? :list_external_apis
-                  @list_external_apis = ::Gapic::Config::Method.new list_external_apis_config
-
-                  yield self if block_given?
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end