google-cloud-discovery_engine-v1 2.13.0 → 2.14.0

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

@@ -255,10 +255,10 @@ module Google
               #     * `document` is the default model for regular dataStores.
               #     * `search-history` is the default model for site search dataStores.
               #   @param user_pseudo_id [::String]
-              #     A unique identifier for tracking visitors. For example, this could be
-              #     implemented with an HTTP cookie, which should be able to uniquely identify
-              #     a visitor on a single device. This unique identifier should not change if
-              #     the visitor logs in or out of the website.
+              #     Optional. A unique identifier for tracking visitors. For example, this
+              #     could be implemented with an HTTP cookie, which should be able to uniquely
+              #     identify a visitor on a single device. This unique identifier should not
+              #     change if the visitor logs in or out of the website.
               #
               #     This field should NOT have a fixed value such as `unknown_visitor`.
               #
@@ -332,6 +332,150 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Completes the user input with advanced keyword suggestions.
+              #
+              # @overload advanced_complete_query(request, options = nil)
+              #   Pass arguments to `advanced_complete_query` via a request object, either of type
+              #   {::Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryRequest, ::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 advanced_complete_query(completion_config: nil, query: nil, query_model: nil, user_pseudo_id: nil, user_info: nil, include_tail_suggestions: nil, boost_spec: nil, suggestion_types: nil, suggestion_type_specs: nil, experiment_ids: nil)
+              #   Pass arguments to `advanced_complete_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).
+              #
+              #   @param completion_config [::String]
+              #     Required. The completion_config of the parent dataStore or engine resource
+              #     name for which the completion is performed, such as
+              #     `projects/*/locations/global/collections/default_collection/dataStores/*/completionConfig`
+              #     `projects/*/locations/global/collections/default_collection/engines/*/completionConfig`.
+              #   @param query [::String]
+              #     Required. The typeahead input used to fetch suggestions. Maximum length is
+              #     128 characters.
+              #
+              #     The query can not be empty for most of the suggestion types. If it is
+              #     empty, an `INVALID_ARGUMENT` error is returned. The exception is when the
+              #     suggestion_types contains only the type `RECENT_SEARCH`, the query can
+              #     be an empty string. The is called "zero prefix" feature, which returns
+              #     user's recently searched queries given the empty query.
+              #   @param query_model [::String]
+              #     Specifies the autocomplete query model, which only applies to the QUERY
+              #     SuggestionType. This overrides any model specified in the Configuration >
+              #     Autocomplete section of the Cloud console. Currently supported values:
+              #
+              #     * `document` - Using suggestions generated from user-imported documents.
+              #     * `search-history` - Using suggestions generated from the past history of
+              #     {::Google::Cloud::DiscoveryEngine::V1::SearchService::Rest::Client#search SearchService.Search}
+              #     API calls. Do not use it when there is no traffic for Search API.
+              #     * `user-event` - Using suggestions generated from user-imported search
+              #     events.
+              #     * `document-completable` - Using suggestions taken directly from
+              #     user-imported document fields marked as completable.
+              #
+              #     Default values:
+              #
+              #     * `document` is the default model for regular dataStores.
+              #     * `search-history` is the default model for site search dataStores.
+              #   @param user_pseudo_id [::String]
+              #     Optional. A unique identifier for tracking visitors. For example, this
+              #     could be implemented with an HTTP cookie, which should be able to uniquely
+              #     identify a visitor on a single device. This unique identifier should not
+              #     change if the visitor logs in or out of the website.
+              #
+              #     This field should NOT have a fixed value such as `unknown_visitor`.
+              #
+              #     This should be the same identifier as
+              #     {::Google::Cloud::DiscoveryEngine::V1::UserEvent#user_pseudo_id UserEvent.user_pseudo_id}
+              #     and
+              #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest#user_pseudo_id SearchRequest.user_pseudo_id}.
+              #
+              #     The field must be a UTF-8 encoded string with a length limit of 128
+              #   @param user_info [::Google::Cloud::DiscoveryEngine::V1::UserInfo, ::Hash]
+              #     Optional. Information about the end user.
+              #
+              #     This should be the same identifier information as
+              #     {::Google::Cloud::DiscoveryEngine::V1::UserEvent#user_info UserEvent.user_info}
+              #     and
+              #     {::Google::Cloud::DiscoveryEngine::V1::SearchRequest#user_info SearchRequest.user_info}.
+              #   @param include_tail_suggestions [::Boolean]
+              #     Indicates if tail suggestions should be returned if there are no
+              #     suggestions that match the full query. Even if set to true, if there are
+              #     suggestions that match the full query, those are returned and no
+              #     tail suggestions are returned.
+              #   @param boost_spec [::Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryRequest::BoostSpec, ::Hash]
+              #     Optional. Specification to boost suggestions matching the condition.
+              #   @param suggestion_types [::Array<::Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryRequest::SuggestionType>]
+              #     Optional. Suggestion types to return. If empty or unspecified, query
+              #     suggestions are returned. Only one suggestion type is supported at the
+              #     moment.
+              #   @param suggestion_type_specs [::Array<::Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryRequest::SuggestionTypeSpec, ::Hash>]
+              #     Optional. Specification of each suggestion type.
+              #   @param experiment_ids [::Array<::String>]
+              #     Optional. Experiment ids for this request.
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryResponse]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryResponse]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/discovery_engine/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::DiscoveryEngine::V1::CompletionService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryRequest.new
+              #
+              #   # Call the advanced_complete_query method.
+              #   result = client.advanced_complete_query request
+              #
+              #   # The returned object is of type Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryResponse.
+              #   p result
+              #
+              def advanced_complete_query request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryRequest
+
+                # 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
+                call_metadata = @config.rpcs.advanced_complete_query.metadata.to_h
+
+                # 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.advanced_complete_query.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.advanced_complete_query.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @completion_service_stub.advanced_complete_query request, options do |result, operation|
+                  yield result, operation if block_given?
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Imports all
               # {::Google::Cloud::DiscoveryEngine::V1::SuggestionDenyListEntry SuggestionDenyListEntry}
@@ -878,6 +1022,11 @@ module Google
                   #
                   attr_reader :complete_query
                   ##
+                  # RPC-specific configuration for `advanced_complete_query`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :advanced_complete_query
+                  ##
                   # RPC-specific configuration for `import_suggestion_deny_list_entries`
                   # @return [::Gapic::Config::Method]
                   #
@@ -902,6 +1051,8 @@ module Google
                   def initialize parent_rpcs = nil
                     complete_query_config = parent_rpcs.complete_query if parent_rpcs.respond_to? :complete_query
                     @complete_query = ::Gapic::Config::Method.new complete_query_config
+                    advanced_complete_query_config = parent_rpcs.advanced_complete_query if parent_rpcs.respond_to? :advanced_complete_query
+                    @advanced_complete_query = ::Gapic::Config::Method.new advanced_complete_query_config
                     import_suggestion_deny_list_entries_config = parent_rpcs.import_suggestion_deny_list_entries if parent_rpcs.respond_to? :import_suggestion_deny_list_entries
                     @import_suggestion_deny_list_entries = ::Gapic::Config::Method.new import_suggestion_deny_list_entries_config
                     purge_suggestion_deny_list_entries_config = parent_rpcs.purge_suggestion_deny_list_entries if parent_rpcs.respond_to? :purge_suggestion_deny_list_entries

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

@@ -1027,6 +1027,13 @@ module Google
                                                             ["name", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/siteSearchEngine/targetSites/operations/[^/]+/?$}, false]
                                                           ]
                                                         )
+                                                        .with_bindings(
+                                                          uri_method: :get,
+                                                          uri_template: "/v1/{name}",
+                                                          matches: [
+                                                            ["name", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agents/[^/]+/operations/[^/]+/?$}, false]
+                                                          ]
+                                                        )
                                                         .with_bindings(
                                                           uri_method: :get,
                                                           uri_template: "/v1/{name}",

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

@@ -113,6 +113,46 @@ module Google
                 end
               end
 
+              ##
+              # Baseline implementation for the advanced_complete_query REST call
+              #
+              # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryRequest]
+              #   A request object representing the call parameters. Required.
+              # @param options [::Gapic::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryResponse]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryResponse]
+              #   A result object deserialized from the server's reply
+              def advanced_complete_query request_pb, options = nil
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_advanced_complete_query_request request_pb
+                query_string_params = if query_string_params.any?
+                                        query_string_params.to_h { |p| p.split "=", 2 }
+                                      else
+                                        {}
+                                      end
+
+                response = @client_stub.make_http_request(
+                  verb,
+                  uri: uri,
+                  body: body || "",
+                  params: query_string_params,
+                  method_name: "advanced_complete_query",
+                  options: options
+                )
+                operation = ::Gapic::Rest::TransportOperation.new response
+                result = ::Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryResponse.decode_json response.body, ignore_unknown_fields: true
+                catch :response do
+                  yield result, operation if block_given?
+                  result
+                end
+              end
+
               ##
               # Baseline implementation for the import_suggestion_deny_list_entries REST call
               #
@@ -301,6 +341,44 @@ module Google
                 transcoder.transcode request_pb
               end
 
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the advanced_complete_query REST call
+              #
+              # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::AdvancedCompleteQueryRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_advanced_complete_query_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1/{completion_config}:completeQuery",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["completion_config", %r{^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/completionConfig/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1/{completion_config}:completeQuery",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["completion_config", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/completionConfig/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1/{completion_config}:completeQuery",
+                                                          body: "*",
+                                                          matches: [
+                                                            ["completion_config", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/completionConfig/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
+
               ##
               # @private
               #

data/lib/google/cloud/discovery_engine/v1/control_service/credentials.rb

@@ -26,7 +26,9 @@ module Google
           # Credentials for the ControlService API.
           class Credentials < ::Google::Auth::Credentials
             self.scope = [
-              "https://www.googleapis.com/auth/cloud-platform"
+              "https://www.googleapis.com/auth/cloud-platform",
+              "https://www.googleapis.com/auth/discoveryengine.readwrite",
+              "https://www.googleapis.com/auth/discoveryengine.serving.readwrite"
             ]
             self.env_vars = [
               "GOOGLE_CLOUD_CREDENTIALS",

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

@@ -850,6 +850,12 @@ module Google
             #     `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`,
             #     or
             #     `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`.
+            #
+            #     Or the resource name of the agent engine serving config, such as:
+            #     `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_agent_answer`.
+            #     (use when `enable_agent_invocation` set to true, and you have custom
+            #     `AI_MODE` agent engine configured)
+            #
             #     This field is used to identify the serving configuration name, set
             #     of models used to make the search.
             #   @param query [::Google::Cloud::DiscoveryEngine::V1::Query, ::Hash]
@@ -1010,6 +1016,12 @@ module Google
             #     `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`,
             #     or
             #     `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`.
+            #
+            #     Or the resource name of the agent engine serving config, such as:
+            #     `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_agent_answer`.
+            #     (use when `enable_agent_invocation` set to true, and you have custom
+            #     `AI_MODE` agent engine configured)
+            #
             #     This field is used to identify the serving configuration name, set
             #     of models used to make the search.
             #   @param query [::Google::Cloud::DiscoveryEngine::V1::Query, ::Hash]
@@ -1246,7 +1258,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload create_session(parent: nil, session: nil)
+            # @overload create_session(parent: nil, session: nil, session_id: nil)
             #   Pass arguments to `create_session` 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).
@@ -1256,6 +1268,13 @@ module Google
             #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
             #   @param session [::Google::Cloud::DiscoveryEngine::V1::Session, ::Hash]
             #     Required. The session to create.
+            #   @param session_id [::String]
+            #     Optional. The ID to use for the session, which will become the final
+            #     component of the session's resource name.
+            #
+            #     This value should be 1-63 characters, and valid characters
+            #     are /[a-z0-9][a-z0-9-]\\{0,61}[a-z0-9]/. If not specified, a unique ID will
+            #     be generated.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DiscoveryEngine::V1::Session]
@@ -1626,7 +1645,9 @@ module Google
             #     Provide this to retrieve the subsequent page.
             #   @param filter [::String]
             #     A comma-separated list of fields to filter by, in EBNF grammar.
+            #
             #     The supported fields are:
+            #
             #     * `user_pseudo_id`
             #     * `state`
             #     * `display_name`
@@ -1635,28 +1656,35 @@ module Google
             #     * `labels`
             #     * `create_time`
             #     * `update_time`
+            #     * `collaborative_project`
             #
             #     Examples:
-            #     "user_pseudo_id = some_id"
-            #     "display_name = \"some_name\""
-            #     "starred = true"
-            #     "is_pinned=true AND (NOT labels:hidden)"
-            #     "create_time > \"1970-01-01T12:00:00Z\""
+            #
+            #     * `user_pseudo_id = some_id`
+            #     * `display_name = "some_name"`
+            #     * `starred = true`
+            #     * `is_pinned=true AND (NOT labels:hidden)`
+            #     * `create_time > "1970-01-01T12:00:00Z"`
+            #     * `collaborative_project =
+            #          "projects/123/locations/global/collections/default_collection/engines/"
+            #          "default_engine/collaborative_projects/cp1"`
             #   @param order_by [::String]
             #     A comma-separated list of fields to order by, sorted in ascending order.
             #     Use "desc" after a field name for descending.
+            #
             #     Supported fields:
             #
             #       * `update_time`
             #       * `create_time`
             #       * `session_name`
             #       * `is_pinned`
+            #       * `display_name`
             #
             #     Example:
             #
-            #     * "update_time desc"
-            #     * "create_time"
-            #     * "is_pinned desc,update_time desc": list sessions by is_pinned first, then
+            #     * `update_time desc`
+            #     * `create_time`
+            #     * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then
             #        by update_time.
             #
             # @yield [response, operation] Access the result along with the RPC operation

data/lib/google/cloud/discovery_engine/v1/conversational_search_service/credentials.rb

@@ -26,7 +26,9 @@ module Google
           # Credentials for the ConversationalSearchService API.
           class Credentials < ::Google::Auth::Credentials
             self.scope = [
-              "https://www.googleapis.com/auth/cloud-platform"
+              "https://www.googleapis.com/auth/cloud-platform",
+              "https://www.googleapis.com/auth/discoveryengine.readwrite",
+              "https://www.googleapis.com/auth/discoveryengine.serving.readwrite"
             ]
             self.env_vars = [
               "GOOGLE_CLOUD_CREDENTIALS",

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

@@ -449,6 +449,18 @@ module Google
             #   @param engine [String]
             #   @param session [String]
             #
+            # @overload session_path(project:, location:, collection:, engine:, collaborative_project:, session:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/collaborativeProjects/{collaborative_project}/sessions/{session}`
+            #
+            #   @param project [String]
+            #   @param location [String]
+            #   @param collection [String]
+            #   @param engine [String]
+            #   @param collaborative_project [String]
+            #   @param session [String]
+            #
             # @return [::String]
             def session_path **args
               resources = {
@@ -474,6 +486,15 @@ module Google
                   raise ::ArgumentError, "engine cannot contain /" if engine.to_s.include? "/"
 
                   "projects/#{project}/locations/#{location}/collections/#{collection}/engines/#{engine}/sessions/#{session}"
+                end),
+                "collaborative_project:collection:engine:location:project:session" => (proc do |project:, location:, collection:, engine:, collaborative_project:, 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? "/"
+                  raise ::ArgumentError, "collaborative_project cannot contain /" if collaborative_project.to_s.include? "/"
+
+                  "projects/#{project}/locations/#{location}/collections/#{collection}/engines/#{engine}/collaborativeProjects/#{collaborative_project}/sessions/#{session}"
                 end)
               }
 

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

@@ -801,6 +801,12 @@ module Google
               #     `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`,
               #     or
               #     `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`.
+              #
+              #     Or the resource name of the agent engine serving config, such as:
+              #     `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_agent_answer`.
+              #     (use when `enable_agent_invocation` set to true, and you have custom
+              #     `AI_MODE` agent engine configured)
+              #
               #     This field is used to identify the serving configuration name, set
               #     of models used to make the search.
               #   @param query [::Google::Cloud::DiscoveryEngine::V1::Query, ::Hash]
@@ -954,6 +960,12 @@ module Google
               #     `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config`,
               #     or
               #     `projects/*/locations/global/collections/default_collection/dataStores/*/servingConfigs/default_serving_config`.
+              #
+              #     Or the resource name of the agent engine serving config, such as:
+              #     `projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_agent_answer`.
+              #     (use when `enable_agent_invocation` set to true, and you have custom
+              #     `AI_MODE` agent engine configured)
+              #
               #     This field is used to identify the serving configuration name, set
               #     of models used to make the search.
               #   @param query [::Google::Cloud::DiscoveryEngine::V1::Query, ::Hash]
@@ -1178,7 +1190,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload create_session(parent: nil, session: nil)
+              # @overload create_session(parent: nil, session: nil, session_id: nil)
               #   Pass arguments to `create_session` 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).
@@ -1188,6 +1200,13 @@ module Google
               #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
               #   @param session [::Google::Cloud::DiscoveryEngine::V1::Session, ::Hash]
               #     Required. The session to create.
+              #   @param session_id [::String]
+              #     Optional. The ID to use for the session, which will become the final
+              #     component of the session's resource name.
+              #
+              #     This value should be 1-63 characters, and valid characters
+              #     are /[a-z0-9][a-z0-9-]\\{0,61}[a-z0-9]/. If not specified, a unique ID will
+              #     be generated.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1::Session]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1530,7 +1549,9 @@ module Google
               #     Provide this to retrieve the subsequent page.
               #   @param filter [::String]
               #     A comma-separated list of fields to filter by, in EBNF grammar.
+              #
               #     The supported fields are:
+              #
               #     * `user_pseudo_id`
               #     * `state`
               #     * `display_name`
@@ -1539,28 +1560,35 @@ module Google
               #     * `labels`
               #     * `create_time`
               #     * `update_time`
+              #     * `collaborative_project`
               #
               #     Examples:
-              #     "user_pseudo_id = some_id"
-              #     "display_name = \"some_name\""
-              #     "starred = true"
-              #     "is_pinned=true AND (NOT labels:hidden)"
-              #     "create_time > \"1970-01-01T12:00:00Z\""
+              #
+              #     * `user_pseudo_id = some_id`
+              #     * `display_name = "some_name"`
+              #     * `starred = true`
+              #     * `is_pinned=true AND (NOT labels:hidden)`
+              #     * `create_time > "1970-01-01T12:00:00Z"`
+              #     * `collaborative_project =
+              #          "projects/123/locations/global/collections/default_collection/engines/"
+              #          "default_engine/collaborative_projects/cp1"`
               #   @param order_by [::String]
               #     A comma-separated list of fields to order by, sorted in ascending order.
               #     Use "desc" after a field name for descending.
+              #
               #     Supported fields:
               #
               #       * `update_time`
               #       * `create_time`
               #       * `session_name`
               #       * `is_pinned`
+              #       * `display_name`
               #
               #     Example:
               #
-              #     * "update_time desc"
-              #     * "create_time"
-              #     * "is_pinned desc,update_time desc": list sessions by is_pinned first, then
+              #     * `update_time desc`
+              #     * `create_time`
+              #     * `is_pinned desc,update_time desc`: list sessions by is_pinned first, then
               #        by update_time.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::DiscoveryEngine::V1::Session>]