google-cloud-discovery_engine-v1beta 0.10.0 → 0.12.0

data/lib/google/cloud/discovery_engine/v1beta/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$"
 
@@ -205,7 +208,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`
@@ -231,9 +234,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`
@@ -253,18 +256,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::V1beta::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::V1beta::Document Document}s with
-            #     `storageStatus` of `EXPIRED` or `DELETED` regardless of filter choices.
+            #     `storageStatus` 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}]
@@ -272,16 +275,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::V1beta::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::V1beta::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:
@@ -348,10 +352,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::V1beta::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/v1beta/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/v1beta/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$"
 
@@ -198,7 +201,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`
@@ -224,9 +227,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`
@@ -246,18 +249,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::V1beta::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::V1beta::Document Document}s with
-              #     `storageStatus` of `EXPIRED` or `DELETED` regardless of filter choices.
+              #     `storageStatus` 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}]
@@ -265,16 +268,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::V1beta::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::V1beta::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:
@@ -340,12 +344,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::V1beta::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/v1beta/rest.rb

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

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

@@ -31,6 +31,9 @@ module Google
           # Service for managing {::Google::Cloud::DiscoveryEngine::V1beta::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::V1beta::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
             #     to return. The service may return fewer than this value.
             #
             #     If unspecified, at most 100
-            #     {::Google::Cloud::DiscoveryEngine::V1beta::Schema Schema}s will be returned.
+            #     {::Google::Cloud::DiscoveryEngine::V1beta::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::V1beta::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::V1beta::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 = {}
@@ -413,7 +418,7 @@ module Google
             #     create.
             #   @param schema_id [::String]
             #     Required. The ID to use for the
-            #     {::Google::Cloud::DiscoveryEngine::V1beta::Schema Schema}, which will become the
+            #     {::Google::Cloud::DiscoveryEngine::V1beta::Schema Schema}, which becomes the
             #     final component of the
             #     {::Google::Cloud::DiscoveryEngine::V1beta::Schema#name Schema.name}.
             #
@@ -462,10 +467,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::V1beta::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 = {}
@@ -517,8 +523,8 @@ module Google
             #   @param allow_missing [::Boolean]
             #     If set to true, and the
             #     {::Google::Cloud::DiscoveryEngine::V1beta::Schema Schema} is not found, a new
-            #     {::Google::Cloud::DiscoveryEngine::V1beta::Schema Schema} will be created. In
-            #     this situation, `update_mask` is ignored.
+            #     {::Google::Cloud::DiscoveryEngine::V1beta::Schema Schema} is created. In this
+            #     situation, `update_mask` is ignored.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -561,10 +567,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::V1beta::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 = {}
@@ -655,10 +662,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::V1beta::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/v1beta/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::V1beta::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::V1beta::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::V1beta::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::V1beta::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::V1beta::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/v1beta/schema_service/rest/client.rb

@@ -33,6 +33,9 @@ module Google
             # Service for managing {::Google::Cloud::DiscoveryEngine::V1beta::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::V1beta::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
               #     to return. The service may return fewer than this value.
               #
               #     If unspecified, at most 100
-              #     {::Google::Cloud::DiscoveryEngine::V1beta::Schema Schema}s will be returned.
+              #     {::Google::Cloud::DiscoveryEngine::V1beta::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::V1beta::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::V1beta::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,
@@ -392,7 +397,7 @@ module Google
               #     create.
               #   @param schema_id [::String]
               #     Required. The ID to use for the
-              #     {::Google::Cloud::DiscoveryEngine::V1beta::Schema Schema}, which will become the
+              #     {::Google::Cloud::DiscoveryEngine::V1beta::Schema Schema}, which becomes the
               #     final component of the
               #     {::Google::Cloud::DiscoveryEngine::V1beta::Schema#name Schema.name}.
               #
@@ -440,12 +445,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::V1beta::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,
@@ -489,8 +495,8 @@ module Google
               #   @param allow_missing [::Boolean]
               #     If set to true, and the
               #     {::Google::Cloud::DiscoveryEngine::V1beta::Schema Schema} is not found, a new
-              #     {::Google::Cloud::DiscoveryEngine::V1beta::Schema Schema} will be created. In
-              #     this situation, `update_mask` is ignored.
+              #     {::Google::Cloud::DiscoveryEngine::V1beta::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]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -532,12 +538,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::V1beta::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,
@@ -619,12 +626,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::V1beta::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,