google-cloud-discovery_engine-v1 0.7.0 → 0.8.0

data/lib/google/cloud/discovery_engine/v1/recommendation_service/client.rb

@@ -31,6 +31,9 @@ module Google
           # Service for making recommendations.
           #
           class Client
+            # @private
+            API_VERSION = ""
+
             # @private
             DEFAULT_ENDPOINT_TEMPLATE = "discoveryengine.$UNIVERSE_DOMAIN$"
 
@@ -204,7 +207,7 @@ module Google
             #     `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*`
             #
             #     One default serving config is created along with your recommendation engine
-            #     creation. The engine ID will be used as the ID of the default serving
+            #     creation. The engine ID is used as the ID of the default serving
             #     config. For example, for Engine
             #     `projects/*/locations/global/collections/*/engines/my-engine`, you can use
             #     `projects/*/locations/global/collections/*/engines/my-engine/servingConfigs/my-engine`
@@ -230,9 +233,9 @@ module Google
             #     unset.
             #   @param page_size [::Integer]
             #     Maximum number of results to return. Set this property
-            #     to the number of recommendation results needed. If zero, the service will
-            #     choose a reasonable default. The maximum allowed value is 100. Values
-            #     above 100 will be coerced to 100.
+            #     to the number of recommendation results needed. If zero, the service
+            #     chooses a reasonable default. The maximum allowed value is 100. Values
+            #     above 100 are set to 100.
             #   @param filter [::String]
             #     Filter for restricting recommendation results with a length limit of 5,000
             #     characters. Currently, only filter expressions on the `filter_tags`
@@ -252,18 +255,18 @@ module Google
             #      * (available: true) AND
             #        (launguage: ANY("en", "es")) OR (categories: ANY("Movie"))
             #
-            #     If your filter blocks all results, the API will return generic
+            #     If your filter blocks all results, the API returns generic
             #     (unfiltered) popular Documents. If you only want results strictly matching
-            #     the filters, set `strictFiltering` to True in
+            #     the filters, set `strictFiltering` to `true` in
             #     {::Google::Cloud::DiscoveryEngine::V1::RecommendRequest#params RecommendRequest.params}
             #     to receive empty results instead.
             #
-            #     Note that the API will never return
+            #     Note that the API never returns
             #     {::Google::Cloud::DiscoveryEngine::V1::Document Document}s with `storageStatus`
-            #     of `EXPIRED` or `DELETED` regardless of filter choices.
+            #     as `EXPIRED` or `DELETED` regardless of filter choices.
             #   @param validate_only [::Boolean]
-            #     Use validate only mode for this recommendation query. If set to true, a
-            #     fake model will be used that returns arbitrary Document IDs.
+            #     Use validate only mode for this recommendation query. If set to `true`, a
+            #     fake model is used that returns arbitrary Document IDs.
             #     Note that the validate only mode should only be used for testing the API,
             #     or if the model is not ready.
             #   @param params [::Hash{::String => ::Google::Protobuf::Value, ::Hash}]
@@ -271,16 +274,17 @@ module Google
             #
             #     Allowed values:
             #
-            #     * `returnDocument`: Boolean. If set to true, the associated Document
-            #        object will be returned in
+            #     * `returnDocument`: Boolean. If set to `true`, the associated Document
+            #        object is returned in
             #        {::Google::Cloud::DiscoveryEngine::V1::RecommendResponse::RecommendationResult#document RecommendResponse.RecommendationResult.document}.
-            #     * `returnScore`: Boolean. If set to true, the recommendation 'score'
-            #        corresponding to each returned Document will be set in
+            #     * `returnScore`: Boolean. If set to true, the recommendation score
+            #        corresponding to each returned Document is set in
             #        {::Google::Cloud::DiscoveryEngine::V1::RecommendResponse::RecommendationResult#metadata RecommendResponse.RecommendationResult.metadata}.
-            #        The given 'score' indicates the probability of a Document conversion
-            #        given the user's context and history.
-            #     * `strictFiltering`: Boolean. True by default. If set to false, the service
-            #        will return generic (unfiltered) popular Documents instead of empty if
+            #        The given score indicates the probability of a Document conversion given
+            #        the user's context and history.
+            #     * `strictFiltering`: Boolean. True by default. If set to `false`, the
+            #     service
+            #        returns generic (unfiltered) popular Documents instead of empty if
             #        your filter blocks all recommendation results.
             #     * `diversityLevel`: String. Default empty. If set to be non-empty, then
             #        it needs to be one of:
@@ -347,10 +351,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.recommend.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # 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::DiscoveryEngine::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 = {}

data/lib/google/cloud/discovery_engine/v1/recommendation_service/paths.rb

@@ -24,6 +24,51 @@ module Google
         module RecommendationService
           # Path helper methods for the RecommendationService API.
           module Paths
+            ##
+            # Create a fully-qualified DataStore resource string.
+            #
+            # @overload data_store_path(project:, location:, data_store:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/dataStores/{data_store}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param data_store [String]
+            #
+            # @overload data_store_path(project:, location:, collection:, data_store:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param collection [String]
+            #   @param data_store [String]
+            #
+            # @return [::String]
+            def data_store_path **args
+              resources = {
+                "data_store:location:project" => (proc do |project:, location:, data_store:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/dataStores/#{data_store}"
+                end),
+                "collection:data_store:location:project" => (proc do |project:, location:, collection:, data_store:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "collection cannot contain /" if collection.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/collections/#{collection}/dataStores/#{data_store}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
             ##
             # Create a fully-qualified Document resource string.
             #
@@ -77,6 +122,27 @@ module Google
               resource.call(**args)
             end
 
+            ##
+            # Create a fully-qualified Engine resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param collection [String]
+            # @param engine [String]
+            #
+            # @return [::String]
+            def engine_path project:, location:, collection:, engine:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "collection cannot contain /" if collection.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/collections/#{collection}/engines/#{engine}"
+            end
+
             ##
             # Create a fully-qualified ServingConfig resource string.
             #

data/lib/google/cloud/discovery_engine/v1/recommendation_service/rest/client.rb

@@ -33,6 +33,9 @@ module Google
             # Service for making recommendations.
             #
             class Client
+              # @private
+              API_VERSION = ""
+
               # @private
               DEFAULT_ENDPOINT_TEMPLATE = "discoveryengine.$UNIVERSE_DOMAIN$"
 
@@ -197,7 +200,7 @@ module Google
               #     `projects/*/locations/global/collections/*/dataStores/*/servingConfigs/*`
               #
               #     One default serving config is created along with your recommendation engine
-              #     creation. The engine ID will be used as the ID of the default serving
+              #     creation. The engine ID is used as the ID of the default serving
               #     config. For example, for Engine
               #     `projects/*/locations/global/collections/*/engines/my-engine`, you can use
               #     `projects/*/locations/global/collections/*/engines/my-engine/servingConfigs/my-engine`
@@ -223,9 +226,9 @@ module Google
               #     unset.
               #   @param page_size [::Integer]
               #     Maximum number of results to return. Set this property
-              #     to the number of recommendation results needed. If zero, the service will
-              #     choose a reasonable default. The maximum allowed value is 100. Values
-              #     above 100 will be coerced to 100.
+              #     to the number of recommendation results needed. If zero, the service
+              #     chooses a reasonable default. The maximum allowed value is 100. Values
+              #     above 100 are set to 100.
               #   @param filter [::String]
               #     Filter for restricting recommendation results with a length limit of 5,000
               #     characters. Currently, only filter expressions on the `filter_tags`
@@ -245,18 +248,18 @@ module Google
               #      * (available: true) AND
               #        (launguage: ANY("en", "es")) OR (categories: ANY("Movie"))
               #
-              #     If your filter blocks all results, the API will return generic
+              #     If your filter blocks all results, the API returns generic
               #     (unfiltered) popular Documents. If you only want results strictly matching
-              #     the filters, set `strictFiltering` to True in
+              #     the filters, set `strictFiltering` to `true` in
               #     {::Google::Cloud::DiscoveryEngine::V1::RecommendRequest#params RecommendRequest.params}
               #     to receive empty results instead.
               #
-              #     Note that the API will never return
+              #     Note that the API never returns
               #     {::Google::Cloud::DiscoveryEngine::V1::Document Document}s with `storageStatus`
-              #     of `EXPIRED` or `DELETED` regardless of filter choices.
+              #     as `EXPIRED` or `DELETED` regardless of filter choices.
               #   @param validate_only [::Boolean]
-              #     Use validate only mode for this recommendation query. If set to true, a
-              #     fake model will be used that returns arbitrary Document IDs.
+              #     Use validate only mode for this recommendation query. If set to `true`, a
+              #     fake model is used that returns arbitrary Document IDs.
               #     Note that the validate only mode should only be used for testing the API,
               #     or if the model is not ready.
               #   @param params [::Hash{::String => ::Google::Protobuf::Value, ::Hash}]
@@ -264,16 +267,17 @@ module Google
               #
               #     Allowed values:
               #
-              #     * `returnDocument`: Boolean. If set to true, the associated Document
-              #        object will be returned in
+              #     * `returnDocument`: Boolean. If set to `true`, the associated Document
+              #        object is returned in
               #        {::Google::Cloud::DiscoveryEngine::V1::RecommendResponse::RecommendationResult#document RecommendResponse.RecommendationResult.document}.
-              #     * `returnScore`: Boolean. If set to true, the recommendation 'score'
-              #        corresponding to each returned Document will be set in
+              #     * `returnScore`: Boolean. If set to true, the recommendation score
+              #        corresponding to each returned Document is set in
               #        {::Google::Cloud::DiscoveryEngine::V1::RecommendResponse::RecommendationResult#metadata RecommendResponse.RecommendationResult.metadata}.
-              #        The given 'score' indicates the probability of a Document conversion
-              #        given the user's context and history.
-              #     * `strictFiltering`: Boolean. True by default. If set to false, the service
-              #        will return generic (unfiltered) popular Documents instead of empty if
+              #        The given score indicates the probability of a Document conversion given
+              #        the user's context and history.
+              #     * `strictFiltering`: Boolean. True by default. If set to `false`, the
+              #     service
+              #        returns generic (unfiltered) popular Documents instead of empty if
               #        your filter blocks all recommendation results.
               #     * `diversityLevel`: String. Default empty. If set to be non-empty, then
               #        it needs to be one of:
@@ -339,12 +343,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.recommend.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_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::DiscoveryEngine::V1::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.recommend.timeout,

data/lib/google/cloud/discovery_engine/v1/rest.rb

@@ -17,11 +17,15 @@
 # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
 
 require "google/cloud/discovery_engine/v1/completion_service/rest"
+require "google/cloud/discovery_engine/v1/control_service/rest"
 require "google/cloud/discovery_engine/v1/search_service/rest"
 require "google/cloud/discovery_engine/v1/conversational_search_service/rest"
 require "google/cloud/discovery_engine/v1/data_store_service/rest"
 require "google/cloud/discovery_engine/v1/document_service/rest"
 require "google/cloud/discovery_engine/v1/engine_service/rest"
+require "google/cloud/discovery_engine/v1/grounded_generation_service/rest"
+require "google/cloud/discovery_engine/v1/project_service/rest"
+require "google/cloud/discovery_engine/v1/rank_service/rest"
 require "google/cloud/discovery_engine/v1/recommendation_service/rest"
 require "google/cloud/discovery_engine/v1/schema_service/rest"
 require "google/cloud/discovery_engine/v1/site_search_engine_service/rest"

data/lib/google/cloud/discovery_engine/v1/schema_service/client.rb

@@ -31,6 +31,9 @@ module Google
           # Service for managing {::Google::Cloud::DiscoveryEngine::V1::Schema Schema}s.
           #
           class Client
+            # @private
+            API_VERSION = ""
+
             # @private
             DEFAULT_ENDPOINT_TEMPLATE = "discoveryengine.$UNIVERSE_DOMAIN$"
 
@@ -250,10 +253,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.get_schema.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # 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::DiscoveryEngine::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 = {}
@@ -306,9 +310,9 @@ module Google
             #     return. The service may return fewer than this value.
             #
             #     If unspecified, at most 100
-            #     {::Google::Cloud::DiscoveryEngine::V1::Schema Schema}s will be returned.
+            #     {::Google::Cloud::DiscoveryEngine::V1::Schema Schema}s are returned.
             #
-            #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+            #     The maximum value is 1000; values above 1000 are set to 1000.
             #   @param page_token [::String]
             #     A page token, received from a previous
             #     {::Google::Cloud::DiscoveryEngine::V1::SchemaService::Client#list_schemas SchemaService.ListSchemas}
@@ -356,10 +360,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.list_schemas.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # 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::DiscoveryEngine::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 = {}
@@ -412,8 +417,8 @@ module Google
             #     Required. The {::Google::Cloud::DiscoveryEngine::V1::Schema Schema} to create.
             #   @param schema_id [::String]
             #     Required. The ID to use for the
-            #     {::Google::Cloud::DiscoveryEngine::V1::Schema Schema}, which will become the
-            #     final component of the
+            #     {::Google::Cloud::DiscoveryEngine::V1::Schema Schema}, which becomes the final
+            #     component of the
             #     {::Google::Cloud::DiscoveryEngine::V1::Schema#name Schema.name}.
             #
             #     This field should conform to
@@ -461,10 +466,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.create_schema.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # 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::DiscoveryEngine::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 = {}
@@ -514,7 +520,7 @@ module Google
             #     Required. The {::Google::Cloud::DiscoveryEngine::V1::Schema Schema} to update.
             #   @param allow_missing [::Boolean]
             #     If set to true, and the {::Google::Cloud::DiscoveryEngine::V1::Schema Schema} is
-            #     not found, a new {::Google::Cloud::DiscoveryEngine::V1::Schema Schema} will be
+            #     not found, a new {::Google::Cloud::DiscoveryEngine::V1::Schema Schema} is
             #     created. In this situation, `update_mask` is ignored.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -558,10 +564,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.update_schema.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # 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::DiscoveryEngine::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 = {}
@@ -652,10 +659,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.delete_schema.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # 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::DiscoveryEngine::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 = {}

data/lib/google/cloud/discovery_engine/v1/schema_service/operations.rb

@@ -26,6 +26,9 @@ module Google
         module SchemaService
           # Service that implements Longrunning Operations API.
           class Operations
+            # @private
+            API_VERSION = ""
+
             # @private
             DEFAULT_ENDPOINT_TEMPLATE = "discoveryengine.$UNIVERSE_DOMAIN$"
 
@@ -191,10 +194,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.list_operations.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # 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::DiscoveryEngine::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 = {}
@@ -287,10 +291,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.get_operation.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # 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::DiscoveryEngine::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 = {}
@@ -376,10 +381,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.delete_operation.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # 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::DiscoveryEngine::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 = {}
@@ -470,10 +476,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.cancel_operation.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # 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::DiscoveryEngine::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 = {}
@@ -574,10 +581,11 @@ module Google
               # Customize the options with defaults
               metadata = @config.rpcs.wait_operation.metadata.to_h
 
-              # Set x-goog-api-client and x-goog-user-project headers
+              # 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::DiscoveryEngine::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
 
               options.apply_defaults timeout:      @config.rpcs.wait_operation.timeout,

data/lib/google/cloud/discovery_engine/v1/schema_service/rest/client.rb

@@ -33,6 +33,9 @@ module Google
             # Service for managing {::Google::Cloud::DiscoveryEngine::V1::Schema Schema}s.
             #
             class Client
+              # @private
+              API_VERSION = ""
+
               # @private
               DEFAULT_ENDPOINT_TEMPLATE = "discoveryengine.$UNIVERSE_DOMAIN$"
 
@@ -242,12 +245,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.get_schema.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_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::DiscoveryEngine::V1::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.get_schema.timeout,
@@ -292,9 +296,9 @@ module Google
               #     return. The service may return fewer than this value.
               #
               #     If unspecified, at most 100
-              #     {::Google::Cloud::DiscoveryEngine::V1::Schema Schema}s will be returned.
+              #     {::Google::Cloud::DiscoveryEngine::V1::Schema Schema}s are returned.
               #
-              #     The maximum value is 1000; values above 1000 will be coerced to 1000.
+              #     The maximum value is 1000; values above 1000 are set to 1000.
               #   @param page_token [::String]
               #     A page token, received from a previous
               #     {::Google::Cloud::DiscoveryEngine::V1::SchemaService::Rest::Client#list_schemas SchemaService.ListSchemas}
@@ -341,12 +345,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.list_schemas.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_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::DiscoveryEngine::V1::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.list_schemas.timeout,
@@ -391,8 +396,8 @@ module Google
               #     Required. The {::Google::Cloud::DiscoveryEngine::V1::Schema Schema} to create.
               #   @param schema_id [::String]
               #     Required. The ID to use for the
-              #     {::Google::Cloud::DiscoveryEngine::V1::Schema Schema}, which will become the
-              #     final component of the
+              #     {::Google::Cloud::DiscoveryEngine::V1::Schema Schema}, which becomes the final
+              #     component of the
               #     {::Google::Cloud::DiscoveryEngine::V1::Schema#name Schema.name}.
               #
               #     This field should conform to
@@ -439,12 +444,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.create_schema.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_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::DiscoveryEngine::V1::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.create_schema.timeout,
@@ -486,7 +492,7 @@ module Google
               #     Required. The {::Google::Cloud::DiscoveryEngine::V1::Schema Schema} to update.
               #   @param allow_missing [::Boolean]
               #     If set to true, and the {::Google::Cloud::DiscoveryEngine::V1::Schema Schema} is
-              #     not found, a new {::Google::Cloud::DiscoveryEngine::V1::Schema Schema} will be
+              #     not found, a new {::Google::Cloud::DiscoveryEngine::V1::Schema Schema} is
               #     created. In this situation, `update_mask` is ignored.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
@@ -529,12 +535,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.update_schema.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_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::DiscoveryEngine::V1::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.update_schema.timeout,
@@ -616,12 +623,13 @@ module Google
                 # Customize the options with defaults
                 call_metadata = @config.rpcs.delete_schema.metadata.to_h
 
-                # Set x-goog-api-client and x-goog-user-project headers
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
                 call_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::DiscoveryEngine::V1::VERSION,
                   transports_version_send: [:rest]
 
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
                 call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
                 options.apply_defaults timeout:      @config.rpcs.delete_schema.timeout,