google-cloud-discovery_engine-v1beta 0.13.0 → 0.14.1

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

@@ -824,7 +824,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload answer_query(serving_config: nil, query: nil, session: nil, safety_spec: nil, related_questions_spec: nil, answer_generation_spec: nil, search_spec: nil, query_understanding_spec: nil, asynchronous_mode: nil, user_pseudo_id: nil)
+            # @overload answer_query(serving_config: nil, query: nil, session: nil, safety_spec: nil, related_questions_spec: nil, answer_generation_spec: nil, search_spec: nil, query_understanding_spec: nil, asynchronous_mode: nil, user_pseudo_id: nil, user_labels: nil)
             #   Pass arguments to `answer_query` 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).
@@ -875,6 +875,24 @@ module Google
             #
             #     The field must be a UTF-8 encoded string with a length limit of 128
             #     characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
+            #   @param user_labels [::Hash{::String => ::String}]
+            #     The user labels applied to a resource must meet the following requirements:
+            #
+            #     * Each resource can have multiple labels, up to a maximum of 64.
+            #     * Each label must be a key-value pair.
+            #     * Keys have a minimum length of 1 character and a maximum length of 63
+            #       characters and cannot be empty. Values can be empty and have a maximum
+            #       length of 63 characters.
+            #     * Keys and values can contain only lowercase letters, numeric characters,
+            #       underscores, and dashes. All characters must use UTF-8 encoding, and
+            #       international characters are allowed.
+            #     * The key portion of a label must be unique. However, you can use the same
+            #       key with multiple resources.
+            #     * Keys must start with a lowercase letter or international character.
+            #
+            #     See [Google Cloud
+            #     Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
+            #     for more details.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryResponse]

data/lib/google/cloud/discovery_engine/v1beta/conversational_search_service/rest/client.rb

@@ -775,7 +775,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload answer_query(serving_config: nil, query: nil, session: nil, safety_spec: nil, related_questions_spec: nil, answer_generation_spec: nil, search_spec: nil, query_understanding_spec: nil, asynchronous_mode: nil, user_pseudo_id: nil)
+              # @overload answer_query(serving_config: nil, query: nil, session: nil, safety_spec: nil, related_questions_spec: nil, answer_generation_spec: nil, search_spec: nil, query_understanding_spec: nil, asynchronous_mode: nil, user_pseudo_id: nil, user_labels: nil)
               #   Pass arguments to `answer_query` 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).
@@ -826,6 +826,24 @@ module Google
               #
               #     The field must be a UTF-8 encoded string with a length limit of 128
               #     characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
+              #   @param user_labels [::Hash{::String => ::String}]
+              #     The user labels applied to a resource must meet the following requirements:
+              #
+              #     * Each resource can have multiple labels, up to a maximum of 64.
+              #     * Each label must be a key-value pair.
+              #     * Keys have a minimum length of 1 character and a maximum length of 63
+              #       characters and cannot be empty. Values can be empty and have a maximum
+              #       length of 63 characters.
+              #     * Keys and values can contain only lowercase letters, numeric characters,
+              #       underscores, and dashes. All characters must use UTF-8 encoding, and
+              #       international characters are allowed.
+              #     * The key portion of a label must be unique. However, you can use the same
+              #       key with multiple resources.
+              #     * Keys must start with a lowercase letter or international character.
+              #
+              #     See [Google Cloud
+              #     Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
+              #     for more details.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1beta::AnswerQueryResponse]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]

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

@@ -212,7 +212,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload create_data_store(parent: nil, data_store: nil, data_store_id: nil, create_advanced_site_search: nil)
+            # @overload create_data_store(parent: nil, data_store: nil, data_store_id: nil, create_advanced_site_search: nil, skip_default_schema_creation: nil)
             #   Pass arguments to `create_data_store` 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).
@@ -238,6 +238,15 @@ module Google
             #     If the data store is not configured as site
             #     search (GENERIC vertical and PUBLIC_WEBSITE content_config), this flag will
             #     be ignored.
+            #   @param skip_default_schema_creation [::Boolean]
+            #     A boolean flag indicating whether to skip the default schema creation for
+            #     the data store. Only enable this flag if you are certain that the default
+            #     schema is incompatible with your use case.
+            #
+            #     If set to true, you must manually create a schema for the data store before
+            #     any documents can be ingested.
+            #
+            #     This flag cannot be specified if `data_store.starting_schema` is specified.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]

data/lib/google/cloud/discovery_engine/v1beta/data_store_service/rest/client.rb

@@ -205,7 +205,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload create_data_store(parent: nil, data_store: nil, data_store_id: nil, create_advanced_site_search: nil)
+              # @overload create_data_store(parent: nil, data_store: nil, data_store_id: nil, create_advanced_site_search: nil, skip_default_schema_creation: nil)
               #   Pass arguments to `create_data_store` 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).
@@ -231,6 +231,15 @@ module Google
               #     If the data store is not configured as site
               #     search (GENERIC vertical and PUBLIC_WEBSITE content_config), this flag will
               #     be ignored.
+              #   @param skip_default_schema_creation [::Boolean]
+              #     A boolean flag indicating whether to skip the default schema creation for
+              #     the data store. Only enable this flag if you are certain that the default
+              #     schema is incompatible with your use case.
+              #
+              #     If set to true, you must manually create a schema for the data store before
+              #     any documents can be ingested.
+              #
+              #     This flag cannot be specified if `data_store.starting_schema` is specified.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]

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

@@ -739,7 +739,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload import_documents(inline_source: nil, gcs_source: nil, bigquery_source: nil, fhir_store_source: nil, spanner_source: nil, cloud_sql_source: nil, firestore_source: nil, bigtable_source: nil, parent: nil, error_config: nil, reconciliation_mode: nil, update_mask: nil, auto_generate_ids: nil, id_field: nil)
+            # @overload import_documents(inline_source: nil, gcs_source: nil, bigquery_source: nil, fhir_store_source: nil, spanner_source: nil, cloud_sql_source: nil, firestore_source: nil, alloy_db_source: nil, bigtable_source: nil, parent: nil, error_config: nil, reconciliation_mode: nil, update_mask: nil, auto_generate_ids: nil, id_field: nil)
             #   Pass arguments to `import_documents` 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).
@@ -758,6 +758,8 @@ module Google
             #     Cloud SQL input source.
             #   @param firestore_source [::Google::Cloud::DiscoveryEngine::V1beta::FirestoreSource, ::Hash]
             #     Firestore input source.
+            #   @param alloy_db_source [::Google::Cloud::DiscoveryEngine::V1beta::AlloyDbSource, ::Hash]
+            #     AlloyDB input source.
             #   @param bigtable_source [::Google::Cloud::DiscoveryEngine::V1beta::BigtableSource, ::Hash]
             #     Cloud Bigtable input source.
             #   @param parent [::String]

data/lib/google/cloud/discovery_engine/v1beta/document_service/rest/client.rb

@@ -697,7 +697,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload import_documents(inline_source: nil, gcs_source: nil, bigquery_source: nil, fhir_store_source: nil, spanner_source: nil, cloud_sql_source: nil, firestore_source: nil, bigtable_source: nil, parent: nil, error_config: nil, reconciliation_mode: nil, update_mask: nil, auto_generate_ids: nil, id_field: nil)
+              # @overload import_documents(inline_source: nil, gcs_source: nil, bigquery_source: nil, fhir_store_source: nil, spanner_source: nil, cloud_sql_source: nil, firestore_source: nil, alloy_db_source: nil, bigtable_source: nil, parent: nil, error_config: nil, reconciliation_mode: nil, update_mask: nil, auto_generate_ids: nil, id_field: nil)
               #   Pass arguments to `import_documents` 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).
@@ -716,6 +716,8 @@ module Google
               #     Cloud SQL input source.
               #   @param firestore_source [::Google::Cloud::DiscoveryEngine::V1beta::FirestoreSource, ::Hash]
               #     Firestore input source.
+              #   @param alloy_db_source [::Google::Cloud::DiscoveryEngine::V1beta::AlloyDbSource, ::Hash]
+              #     AlloyDB input source.
               #   @param bigtable_source [::Google::Cloud::DiscoveryEngine::V1beta::BigtableSource, ::Hash]
               #     Cloud Bigtable input source.
               #   @param parent [::String]

data/lib/google/cloud/discovery_engine/v1beta/evaluation_service/paths.rb

@@ -241,6 +241,74 @@ module Google
               resource.call(**args)
             end
 
+            ##
+            # Create a fully-qualified Session resource string.
+            #
+            # @overload session_path(project:, location:, data_store:, session:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/dataStores/{data_store}/sessions/{session}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param data_store [String]
+            #   @param session [String]
+            #
+            # @overload session_path(project:, location:, collection:, data_store:, session:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/sessions/{session}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param collection [String]
+            #   @param data_store [String]
+            #   @param session [String]
+            #
+            # @overload session_path(project:, location:, collection:, engine:, session:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param collection [String]
+            #   @param engine [String]
+            #   @param session [String]
+            #
+            # @return [::String]
+            def session_path **args
+              resources = {
+                "data_store:location:project:session" => (proc do |project:, location:, data_store:, session:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "data_store cannot contain /" if data_store.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/dataStores/#{data_store}/sessions/#{session}"
+                end),
+                "collection:data_store:location:project:session" => (proc do |project:, location:, collection:, data_store:, session:|
+                  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? "/"
+                  raise ::ArgumentError, "data_store cannot contain /" if data_store.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/collections/#{collection}/dataStores/#{data_store}/sessions/#{session}"
+                end),
+                "collection:engine:location:project:session" => (proc do |project:, location:, collection:, engine:, session:|
+                  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? "/"
+                  raise ::ArgumentError, "engine cannot contain /" if engine.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/collections/#{collection}/engines/#{engine}/sessions/#{session}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
             extend self
           end
         end

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

@@ -196,7 +196,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload search(serving_config: nil, branch: nil, query: nil, image_query: nil, page_size: nil, page_token: nil, offset: nil, data_store_specs: nil, filter: nil, canonical_filter: nil, order_by: nil, user_info: nil, facet_specs: nil, boost_spec: nil, params: nil, query_expansion_spec: nil, spell_correction_spec: nil, user_pseudo_id: nil, content_search_spec: nil, embedding_spec: nil, ranking_expression: nil, safe_search: nil, user_labels: nil)
+            # @overload search(serving_config: nil, branch: nil, query: nil, image_query: nil, page_size: nil, page_token: nil, offset: nil, data_store_specs: nil, filter: nil, canonical_filter: nil, order_by: nil, user_info: nil, language_code: nil, region_code: nil, facet_specs: nil, boost_spec: nil, params: nil, query_expansion_spec: nil, spell_correction_spec: nil, user_pseudo_id: nil, content_search_spec: nil, embedding_spec: nil, ranking_expression: nil, safe_search: nil, user_labels: nil, natural_language_query_understanding_spec: nil, search_as_you_type_spec: nil, session: nil, session_spec: nil)
             #   Pass arguments to `search` 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).
@@ -295,6 +295,17 @@ module Google
             #     Highly recommended for analytics.
             #     {::Google::Cloud::DiscoveryEngine::V1beta::UserInfo#user_agent UserInfo.user_agent}
             #     is used to deduce `device_type` for analytics.
+            #   @param language_code [::String]
+            #     The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+            #     information, see [Standard
+            #     fields](https://cloud.google.com/apis/design/standard_fields). This field
+            #     helps to better interpret the query. If a value isn't specified, the query
+            #     language code is automatically detected, which may not be accurate.
+            #   @param region_code [::String]
+            #     The Unicode country/region code (CLDR) of a location, such as "US" and
+            #     "419". For more information, see [Standard
+            #     fields](https://cloud.google.com/apis/design/standard_fields). If set,
+            #     then results will be boosted based on the region_code provided.
             #   @param facet_specs [::Array<::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::FacetSpec, ::Hash>]
             #     Facet specifications for faceted search. If empty, no facets are returned.
             #
@@ -402,6 +413,44 @@ module Google
             #     See [Google Cloud
             #     Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
             #     for more details.
+            #   @param natural_language_query_understanding_spec [::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::NaturalLanguageQueryUnderstandingSpec, ::Hash]
+            #     If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional
+            #     natural language query understanding will be done.
+            #   @param search_as_you_type_spec [::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::SearchAsYouTypeSpec, ::Hash]
+            #     Search as you type configuration. Only supported for the
+            #     {::Google::Cloud::DiscoveryEngine::V1beta::IndustryVertical::MEDIA IndustryVertical.MEDIA}
+            #     vertical.
+            #   @param session [::String]
+            #     The session resource name. Optional.
+            #
+            #     Session allows users to do multi-turn /search API calls or coordination
+            #     between /search API calls and /answer API calls.
+            #
+            #     Example #1 (multi-turn /search API calls):
+            #       1. Call /search API with the auto-session mode (see below).
+            #       2. Call /search API with the session ID generated in the first call.
+            #          Here, the previous search query gets considered in query
+            #          standing. I.e., if the first query is "How did Alphabet do in 2022?"
+            #          and the current query is "How about 2023?", the current query will
+            #          be interpreted as "How did Alphabet do in 2023?".
+            #
+            #     Example #2 (coordination between /search API calls and /answer API calls):
+            #       1. Call /search API with the auto-session mode (see below).
+            #       2. Call /answer API with the session ID generated in the first call.
+            #          Here, the answer generation happens in the context of the search
+            #          results from the first search call.
+            #
+            #     Auto-session mode: when `projects/.../sessions/-` is used, a new session
+            #     gets automatically created. Otherwise, users can use the create-session API
+            #     to create a session manually.
+            #
+            #     Multi-turn Search feature is currently at private GA stage. Please use
+            #     v1alpha or v1beta version instead before we launch this feature to public
+            #     GA. Or ask for allowlisting through Google Support team.
+            #   @param session_spec [::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::SessionSpec, ::Hash]
+            #     Session specification.
+            #
+            #     Can be used only when `session` is set.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::DiscoveryEngine::V1beta::SearchResponse::SearchResult>]

data/lib/google/cloud/discovery_engine/v1beta/search_service/paths.rb

@@ -186,6 +186,74 @@ module Google
               resource.call(**args)
             end
 
+            ##
+            # Create a fully-qualified Session resource string.
+            #
+            # @overload session_path(project:, location:, data_store:, session:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/dataStores/{data_store}/sessions/{session}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param data_store [String]
+            #   @param session [String]
+            #
+            # @overload session_path(project:, location:, collection:, data_store:, session:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/sessions/{session}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param collection [String]
+            #   @param data_store [String]
+            #   @param session [String]
+            #
+            # @overload session_path(project:, location:, collection:, engine:, session:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param collection [String]
+            #   @param engine [String]
+            #   @param session [String]
+            #
+            # @return [::String]
+            def session_path **args
+              resources = {
+                "data_store:location:project:session" => (proc do |project:, location:, data_store:, session:|
+                  raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+                  raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+                  raise ::ArgumentError, "data_store cannot contain /" if data_store.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/dataStores/#{data_store}/sessions/#{session}"
+                end),
+                "collection:data_store:location:project:session" => (proc do |project:, location:, collection:, data_store:, session:|
+                  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? "/"
+                  raise ::ArgumentError, "data_store cannot contain /" if data_store.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/collections/#{collection}/dataStores/#{data_store}/sessions/#{session}"
+                end),
+                "collection:engine:location:project:session" => (proc do |project:, location:, collection:, engine:, session:|
+                  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? "/"
+                  raise ::ArgumentError, "engine cannot contain /" if engine.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/collections/#{collection}/engines/#{engine}/sessions/#{session}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ::ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
             extend self
           end
         end

data/lib/google/cloud/discovery_engine/v1beta/search_service/rest/client.rb

@@ -189,7 +189,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload search(serving_config: nil, branch: nil, query: nil, image_query: nil, page_size: nil, page_token: nil, offset: nil, data_store_specs: nil, filter: nil, canonical_filter: nil, order_by: nil, user_info: nil, facet_specs: nil, boost_spec: nil, params: nil, query_expansion_spec: nil, spell_correction_spec: nil, user_pseudo_id: nil, content_search_spec: nil, embedding_spec: nil, ranking_expression: nil, safe_search: nil, user_labels: nil)
+              # @overload search(serving_config: nil, branch: nil, query: nil, image_query: nil, page_size: nil, page_token: nil, offset: nil, data_store_specs: nil, filter: nil, canonical_filter: nil, order_by: nil, user_info: nil, language_code: nil, region_code: nil, facet_specs: nil, boost_spec: nil, params: nil, query_expansion_spec: nil, spell_correction_spec: nil, user_pseudo_id: nil, content_search_spec: nil, embedding_spec: nil, ranking_expression: nil, safe_search: nil, user_labels: nil, natural_language_query_understanding_spec: nil, search_as_you_type_spec: nil, session: nil, session_spec: nil)
               #   Pass arguments to `search` 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).
@@ -288,6 +288,17 @@ module Google
               #     Highly recommended for analytics.
               #     {::Google::Cloud::DiscoveryEngine::V1beta::UserInfo#user_agent UserInfo.user_agent}
               #     is used to deduce `device_type` for analytics.
+              #   @param language_code [::String]
+              #     The BCP-47 language code, such as "en-US" or "sr-Latn". For more
+              #     information, see [Standard
+              #     fields](https://cloud.google.com/apis/design/standard_fields). This field
+              #     helps to better interpret the query. If a value isn't specified, the query
+              #     language code is automatically detected, which may not be accurate.
+              #   @param region_code [::String]
+              #     The Unicode country/region code (CLDR) of a location, such as "US" and
+              #     "419". For more information, see [Standard
+              #     fields](https://cloud.google.com/apis/design/standard_fields). If set,
+              #     then results will be boosted based on the region_code provided.
               #   @param facet_specs [::Array<::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::FacetSpec, ::Hash>]
               #     Facet specifications for faceted search. If empty, no facets are returned.
               #
@@ -395,6 +406,44 @@ module Google
               #     See [Google Cloud
               #     Document](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements)
               #     for more details.
+              #   @param natural_language_query_understanding_spec [::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::NaturalLanguageQueryUnderstandingSpec, ::Hash]
+              #     If `naturalLanguageQueryUnderstandingSpec` is not specified, no additional
+              #     natural language query understanding will be done.
+              #   @param search_as_you_type_spec [::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::SearchAsYouTypeSpec, ::Hash]
+              #     Search as you type configuration. Only supported for the
+              #     {::Google::Cloud::DiscoveryEngine::V1beta::IndustryVertical::MEDIA IndustryVertical.MEDIA}
+              #     vertical.
+              #   @param session [::String]
+              #     The session resource name. Optional.
+              #
+              #     Session allows users to do multi-turn /search API calls or coordination
+              #     between /search API calls and /answer API calls.
+              #
+              #     Example #1 (multi-turn /search API calls):
+              #       1. Call /search API with the auto-session mode (see below).
+              #       2. Call /search API with the session ID generated in the first call.
+              #          Here, the previous search query gets considered in query
+              #          standing. I.e., if the first query is "How did Alphabet do in 2022?"
+              #          and the current query is "How about 2023?", the current query will
+              #          be interpreted as "How did Alphabet do in 2023?".
+              #
+              #     Example #2 (coordination between /search API calls and /answer API calls):
+              #       1. Call /search API with the auto-session mode (see below).
+              #       2. Call /answer API with the session ID generated in the first call.
+              #          Here, the answer generation happens in the context of the search
+              #          results from the first search call.
+              #
+              #     Auto-session mode: when `projects/.../sessions/-` is used, a new session
+              #     gets automatically created. Otherwise, users can use the create-session API
+              #     to create a session manually.
+              #
+              #     Multi-turn Search feature is currently at private GA stage. Please use
+              #     v1alpha or v1beta version instead before we launch this feature to public
+              #     GA. Or ask for allowlisting through Google Support team.
+              #   @param session_spec [::Google::Cloud::DiscoveryEngine::V1beta::SearchRequest::SessionSpec, ::Hash]
+              #     Session specification.
+              #
+              #     Can be used only when `session` is set.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1beta::SearchResponse]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]

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

@@ -405,6 +405,138 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Deletes permanently all user events specified by the filter provided.
+            # Depending on the number of events specified by the filter, this operation
+            # could take hours or days to complete. To test a filter, use the list
+            # command first.
+            #
+            # @overload purge_user_events(request, options = nil)
+            #   Pass arguments to `purge_user_events` via a request object, either of type
+            #   {::Google::Cloud::DiscoveryEngine::V1beta::PurgeUserEventsRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DiscoveryEngine::V1beta::PurgeUserEventsRequest, ::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 purge_user_events(parent: nil, filter: nil, force: nil)
+            #   Pass arguments to `purge_user_events` 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 resource name of the catalog under which the events are
+            #     created. The format is
+            #     `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}`
+            #   @param filter [::String]
+            #     Required. The filter string to specify the events to be deleted with a
+            #     length limit of 5,000 characters. The eligible fields for filtering are:
+            #
+            #     * `eventType`: Double quoted
+            #     {::Google::Cloud::DiscoveryEngine::V1beta::UserEvent#event_type UserEvent.event_type}
+            #     string.
+            #     * `eventTime`: in ISO 8601 "zulu" format.
+            #     * `userPseudoId`: Double quoted string. Specifying this will delete all
+            #       events associated with a visitor.
+            #     * `userId`: Double quoted string. Specifying this will delete all events
+            #       associated with a user.
+            #
+            #     Examples:
+            #
+            #     * Deleting all events in a time range:
+            #       `eventTime > "2012-04-23T18:25:43.511Z"
+            #       eventTime < "2012-04-23T18:30:43.511Z"`
+            #     * Deleting specific eventType:
+            #       `eventType = "search"`
+            #     * Deleting all events for a specific visitor:
+            #       `userPseudoId = "visitor1024"`
+            #     * Deleting all events inside a DataStore:
+            #       `*`
+            #
+            #     The filtering fields are assumed to have an implicit AND.
+            #   @param force [::Boolean]
+            #     The `force` field is currently not supported. Purge user event requests
+            #     will permanently delete all purgeable events. Once the development is
+            #     complete:
+            #     If `force` is set to false, the method will return the expected
+            #     purge count without deleting any user events. This field will default to
+            #     false if not included in the request.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/discovery_engine/v1beta"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DiscoveryEngine::V1beta::UserEventService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DiscoveryEngine::V1beta::PurgeUserEventsRequest.new
+            #
+            #   # Call the purge_user_events method.
+            #   result = client.purge_user_events request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "No response received."
+            #   end
+            #
+            def purge_user_events request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DiscoveryEngine::V1beta::PurgeUserEventsRequest
+
+              # 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.purge_user_events.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::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 = {}
+              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.purge_user_events.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.purge_user_events.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @user_event_service_stub.call_rpc :purge_user_events, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Bulk import of user events. Request processing might be
             # synchronous. Events that already exist are skipped.
@@ -679,6 +811,11 @@ module Google
                 #
                 attr_reader :collect_user_event
                 ##
+                # RPC-specific configuration for `purge_user_events`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :purge_user_events
+                ##
                 # RPC-specific configuration for `import_user_events`
                 # @return [::Gapic::Config::Method]
                 #
@@ -690,6 +827,8 @@ module Google
                   @write_user_event = ::Gapic::Config::Method.new write_user_event_config
                   collect_user_event_config = parent_rpcs.collect_user_event if parent_rpcs.respond_to? :collect_user_event
                   @collect_user_event = ::Gapic::Config::Method.new collect_user_event_config
+                  purge_user_events_config = parent_rpcs.purge_user_events if parent_rpcs.respond_to? :purge_user_events
+                  @purge_user_events = ::Gapic::Config::Method.new purge_user_events_config
                   import_user_events_config = parent_rpcs.import_user_events if parent_rpcs.respond_to? :import_user_events
                   @import_user_events = ::Gapic::Config::Method.new import_user_events_config