@google-cloud/discoveryengine 2.2.0 → 2.4.0

package/build/src/v1alpha/schema_service_proto_list.json

@@ -41,6 +41,7 @@
     "../../protos/google/cloud/discoveryengine/v1alpha/serving_config.proto",
     "../../protos/google/cloud/discoveryengine/v1alpha/serving_config_service.proto",
     "../../protos/google/cloud/discoveryengine/v1alpha/session.proto",
+    "../../protos/google/cloud/discoveryengine/v1alpha/session_service.proto",
     "../../protos/google/cloud/discoveryengine/v1alpha/site_search_engine.proto",
     "../../protos/google/cloud/discoveryengine/v1alpha/site_search_engine_service.proto",
     "../../protos/google/cloud/discoveryengine/v1alpha/user_event.proto",

package/build/src/v1alpha/search_service_client.d.ts

@@ -355,22 +355,16 @@ export declare class SearchServiceClient {
     *   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?".
+    *     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.
+    *     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.
     *
     *   Multi-turn Search feature is currently at private GA stage. Please use
     *   v1alpha or v1beta version instead before we launch this feature to public
@@ -642,22 +636,16 @@ export declare class SearchServiceClient {
      *   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?".
+     *     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.
+     *     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.
      *
      *   Multi-turn Search feature is currently at private GA stage. Please use
      *   v1alpha or v1beta version instead before we launch this feature to public
@@ -924,22 +912,16 @@ export declare class SearchServiceClient {
      *   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?".
+     *     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.
+     *     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.
      *
      *   Multi-turn Search feature is currently at private GA stage. Please use
      *   v1alpha or v1beta version instead before we launch this feature to public
@@ -1651,57 +1633,6 @@ export declare class SearchServiceClient {
      * @returns {string} A string representing the serving_config.
      */
     matchServingConfigFromProjectLocationCollectionDataStoreServingConfigName(projectLocationCollectionDataStoreServingConfigName: string): string | number;
-    /**
-     * Return a fully-qualified projectLocationCollectionDataStoreSession resource name string.
-     *
-     * @param {string} project
-     * @param {string} location
-     * @param {string} collection
-     * @param {string} data_store
-     * @param {string} session
-     * @returns {string} Resource name string.
-     */
-    projectLocationCollectionDataStoreSessionPath(project: string, location: string, collection: string, dataStore: string, session: string): string;
-    /**
-     * Parse the project from ProjectLocationCollectionDataStoreSession resource.
-     *
-     * @param {string} projectLocationCollectionDataStoreSessionName
-     *   A fully-qualified path representing project_location_collection_data_store_session resource.
-     * @returns {string} A string representing the project.
-     */
-    matchProjectFromProjectLocationCollectionDataStoreSessionName(projectLocationCollectionDataStoreSessionName: string): string | number;
-    /**
-     * Parse the location from ProjectLocationCollectionDataStoreSession resource.
-     *
-     * @param {string} projectLocationCollectionDataStoreSessionName
-     *   A fully-qualified path representing project_location_collection_data_store_session resource.
-     * @returns {string} A string representing the location.
-     */
-    matchLocationFromProjectLocationCollectionDataStoreSessionName(projectLocationCollectionDataStoreSessionName: string): string | number;
-    /**
-     * Parse the collection from ProjectLocationCollectionDataStoreSession resource.
-     *
-     * @param {string} projectLocationCollectionDataStoreSessionName
-     *   A fully-qualified path representing project_location_collection_data_store_session resource.
-     * @returns {string} A string representing the collection.
-     */
-    matchCollectionFromProjectLocationCollectionDataStoreSessionName(projectLocationCollectionDataStoreSessionName: string): string | number;
-    /**
-     * Parse the data_store from ProjectLocationCollectionDataStoreSession resource.
-     *
-     * @param {string} projectLocationCollectionDataStoreSessionName
-     *   A fully-qualified path representing project_location_collection_data_store_session resource.
-     * @returns {string} A string representing the data_store.
-     */
-    matchDataStoreFromProjectLocationCollectionDataStoreSessionName(projectLocationCollectionDataStoreSessionName: string): string | number;
-    /**
-     * Parse the session from ProjectLocationCollectionDataStoreSession resource.
-     *
-     * @param {string} projectLocationCollectionDataStoreSessionName
-     *   A fully-qualified path representing project_location_collection_data_store_session resource.
-     * @returns {string} A string representing the session.
-     */
-    matchSessionFromProjectLocationCollectionDataStoreSessionName(projectLocationCollectionDataStoreSessionName: string): string | number;
     /**
      * Return a fully-qualified projectLocationCollectionDataStoreSessionAnswer resource name string.
      *
@@ -1762,6 +1693,57 @@ export declare class SearchServiceClient {
      * @returns {string} A string representing the answer.
      */
     matchAnswerFromProjectLocationCollectionDataStoreSessionAnswerName(projectLocationCollectionDataStoreSessionAnswerName: string): string | number;
+    /**
+     * Return a fully-qualified projectLocationCollectionDataStoreSessions resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} collection
+     * @param {string} data_store
+     * @param {string} session
+     * @returns {string} Resource name string.
+     */
+    projectLocationCollectionDataStoreSessionsPath(project: string, location: string, collection: string, dataStore: string, session: string): string;
+    /**
+     * Parse the project from ProjectLocationCollectionDataStoreSessions resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreSessionsName
+     *   A fully-qualified path representing project_location_collection_data_store_sessions resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromProjectLocationCollectionDataStoreSessionsName(projectLocationCollectionDataStoreSessionsName: string): string | number;
+    /**
+     * Parse the location from ProjectLocationCollectionDataStoreSessions resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreSessionsName
+     *   A fully-qualified path representing project_location_collection_data_store_sessions resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromProjectLocationCollectionDataStoreSessionsName(projectLocationCollectionDataStoreSessionsName: string): string | number;
+    /**
+     * Parse the collection from ProjectLocationCollectionDataStoreSessions resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreSessionsName
+     *   A fully-qualified path representing project_location_collection_data_store_sessions resource.
+     * @returns {string} A string representing the collection.
+     */
+    matchCollectionFromProjectLocationCollectionDataStoreSessionsName(projectLocationCollectionDataStoreSessionsName: string): string | number;
+    /**
+     * Parse the data_store from ProjectLocationCollectionDataStoreSessions resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreSessionsName
+     *   A fully-qualified path representing project_location_collection_data_store_sessions resource.
+     * @returns {string} A string representing the data_store.
+     */
+    matchDataStoreFromProjectLocationCollectionDataStoreSessionsName(projectLocationCollectionDataStoreSessionsName: string): string | number;
+    /**
+     * Parse the session from ProjectLocationCollectionDataStoreSessions resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreSessionsName
+     *   A fully-qualified path representing project_location_collection_data_store_sessions resource.
+     * @returns {string} A string representing the session.
+     */
+    matchSessionFromProjectLocationCollectionDataStoreSessionsName(projectLocationCollectionDataStoreSessionsName: string): string | number;
     /**
      * Return a fully-qualified projectLocationCollectionDataStoreSiteSearchEngine resource name string.
      *
@@ -2008,57 +1990,6 @@ export declare class SearchServiceClient {
      * @returns {string} A string representing the serving_config.
      */
     matchServingConfigFromProjectLocationCollectionEngineServingConfigName(projectLocationCollectionEngineServingConfigName: string): string | number;
-    /**
-     * Return a fully-qualified projectLocationCollectionEngineSession resource name string.
-     *
-     * @param {string} project
-     * @param {string} location
-     * @param {string} collection
-     * @param {string} engine
-     * @param {string} session
-     * @returns {string} Resource name string.
-     */
-    projectLocationCollectionEngineSessionPath(project: string, location: string, collection: string, engine: string, session: string): string;
-    /**
-     * Parse the project from ProjectLocationCollectionEngineSession resource.
-     *
-     * @param {string} projectLocationCollectionEngineSessionName
-     *   A fully-qualified path representing project_location_collection_engine_session resource.
-     * @returns {string} A string representing the project.
-     */
-    matchProjectFromProjectLocationCollectionEngineSessionName(projectLocationCollectionEngineSessionName: string): string | number;
-    /**
-     * Parse the location from ProjectLocationCollectionEngineSession resource.
-     *
-     * @param {string} projectLocationCollectionEngineSessionName
-     *   A fully-qualified path representing project_location_collection_engine_session resource.
-     * @returns {string} A string representing the location.
-     */
-    matchLocationFromProjectLocationCollectionEngineSessionName(projectLocationCollectionEngineSessionName: string): string | number;
-    /**
-     * Parse the collection from ProjectLocationCollectionEngineSession resource.
-     *
-     * @param {string} projectLocationCollectionEngineSessionName
-     *   A fully-qualified path representing project_location_collection_engine_session resource.
-     * @returns {string} A string representing the collection.
-     */
-    matchCollectionFromProjectLocationCollectionEngineSessionName(projectLocationCollectionEngineSessionName: string): string | number;
-    /**
-     * Parse the engine from ProjectLocationCollectionEngineSession resource.
-     *
-     * @param {string} projectLocationCollectionEngineSessionName
-     *   A fully-qualified path representing project_location_collection_engine_session resource.
-     * @returns {string} A string representing the engine.
-     */
-    matchEngineFromProjectLocationCollectionEngineSessionName(projectLocationCollectionEngineSessionName: string): string | number;
-    /**
-     * Parse the session from ProjectLocationCollectionEngineSession resource.
-     *
-     * @param {string} projectLocationCollectionEngineSessionName
-     *   A fully-qualified path representing project_location_collection_engine_session resource.
-     * @returns {string} A string representing the session.
-     */
-    matchSessionFromProjectLocationCollectionEngineSessionName(projectLocationCollectionEngineSessionName: string): string | number;
     /**
      * Return a fully-qualified projectLocationCollectionEngineSessionAnswer resource name string.
      *
@@ -2119,6 +2050,57 @@ export declare class SearchServiceClient {
      * @returns {string} A string representing the answer.
      */
     matchAnswerFromProjectLocationCollectionEngineSessionAnswerName(projectLocationCollectionEngineSessionAnswerName: string): string | number;
+    /**
+     * Return a fully-qualified projectLocationCollectionEngineSessions resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} collection
+     * @param {string} engine
+     * @param {string} session
+     * @returns {string} Resource name string.
+     */
+    projectLocationCollectionEngineSessionsPath(project: string, location: string, collection: string, engine: string, session: string): string;
+    /**
+     * Parse the project from ProjectLocationCollectionEngineSessions resource.
+     *
+     * @param {string} projectLocationCollectionEngineSessionsName
+     *   A fully-qualified path representing project_location_collection_engine_sessions resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromProjectLocationCollectionEngineSessionsName(projectLocationCollectionEngineSessionsName: string): string | number;
+    /**
+     * Parse the location from ProjectLocationCollectionEngineSessions resource.
+     *
+     * @param {string} projectLocationCollectionEngineSessionsName
+     *   A fully-qualified path representing project_location_collection_engine_sessions resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromProjectLocationCollectionEngineSessionsName(projectLocationCollectionEngineSessionsName: string): string | number;
+    /**
+     * Parse the collection from ProjectLocationCollectionEngineSessions resource.
+     *
+     * @param {string} projectLocationCollectionEngineSessionsName
+     *   A fully-qualified path representing project_location_collection_engine_sessions resource.
+     * @returns {string} A string representing the collection.
+     */
+    matchCollectionFromProjectLocationCollectionEngineSessionsName(projectLocationCollectionEngineSessionsName: string): string | number;
+    /**
+     * Parse the engine from ProjectLocationCollectionEngineSessions resource.
+     *
+     * @param {string} projectLocationCollectionEngineSessionsName
+     *   A fully-qualified path representing project_location_collection_engine_sessions resource.
+     * @returns {string} A string representing the engine.
+     */
+    matchEngineFromProjectLocationCollectionEngineSessionsName(projectLocationCollectionEngineSessionsName: string): string | number;
+    /**
+     * Parse the session from ProjectLocationCollectionEngineSessions resource.
+     *
+     * @param {string} projectLocationCollectionEngineSessionsName
+     *   A fully-qualified path representing project_location_collection_engine_sessions resource.
+     * @returns {string} A string representing the session.
+     */
+    matchSessionFromProjectLocationCollectionEngineSessionsName(projectLocationCollectionEngineSessionsName: string): string | number;
     /**
      * Return a fully-qualified projectLocationDataStore resource name string.
      *
@@ -2548,48 +2530,6 @@ export declare class SearchServiceClient {
      * @returns {string} A string representing the serving_config.
      */
     matchServingConfigFromProjectLocationDataStoreServingConfigName(projectLocationDataStoreServingConfigName: string): string | number;
-    /**
-     * Return a fully-qualified projectLocationDataStoreSession resource name string.
-     *
-     * @param {string} project
-     * @param {string} location
-     * @param {string} data_store
-     * @param {string} session
-     * @returns {string} Resource name string.
-     */
-    projectLocationDataStoreSessionPath(project: string, location: string, dataStore: string, session: string): string;
-    /**
-     * Parse the project from ProjectLocationDataStoreSession resource.
-     *
-     * @param {string} projectLocationDataStoreSessionName
-     *   A fully-qualified path representing project_location_data_store_session resource.
-     * @returns {string} A string representing the project.
-     */
-    matchProjectFromProjectLocationDataStoreSessionName(projectLocationDataStoreSessionName: string): string | number;
-    /**
-     * Parse the location from ProjectLocationDataStoreSession resource.
-     *
-     * @param {string} projectLocationDataStoreSessionName
-     *   A fully-qualified path representing project_location_data_store_session resource.
-     * @returns {string} A string representing the location.
-     */
-    matchLocationFromProjectLocationDataStoreSessionName(projectLocationDataStoreSessionName: string): string | number;
-    /**
-     * Parse the data_store from ProjectLocationDataStoreSession resource.
-     *
-     * @param {string} projectLocationDataStoreSessionName
-     *   A fully-qualified path representing project_location_data_store_session resource.
-     * @returns {string} A string representing the data_store.
-     */
-    matchDataStoreFromProjectLocationDataStoreSessionName(projectLocationDataStoreSessionName: string): string | number;
-    /**
-     * Parse the session from ProjectLocationDataStoreSession resource.
-     *
-     * @param {string} projectLocationDataStoreSessionName
-     *   A fully-qualified path representing project_location_data_store_session resource.
-     * @returns {string} A string representing the session.
-     */
-    matchSessionFromProjectLocationDataStoreSessionName(projectLocationDataStoreSessionName: string): string | number;
     /**
      * Return a fully-qualified projectLocationDataStoreSessionAnswer resource name string.
      *
@@ -2641,6 +2581,48 @@ export declare class SearchServiceClient {
      * @returns {string} A string representing the answer.
      */
     matchAnswerFromProjectLocationDataStoreSessionAnswerName(projectLocationDataStoreSessionAnswerName: string): string | number;
+    /**
+     * Return a fully-qualified projectLocationDataStoreSessions resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} data_store
+     * @param {string} session
+     * @returns {string} Resource name string.
+     */
+    projectLocationDataStoreSessionsPath(project: string, location: string, dataStore: string, session: string): string;
+    /**
+     * Parse the project from ProjectLocationDataStoreSessions resource.
+     *
+     * @param {string} projectLocationDataStoreSessionsName
+     *   A fully-qualified path representing project_location_data_store_sessions resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromProjectLocationDataStoreSessionsName(projectLocationDataStoreSessionsName: string): string | number;
+    /**
+     * Parse the location from ProjectLocationDataStoreSessions resource.
+     *
+     * @param {string} projectLocationDataStoreSessionsName
+     *   A fully-qualified path representing project_location_data_store_sessions resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromProjectLocationDataStoreSessionsName(projectLocationDataStoreSessionsName: string): string | number;
+    /**
+     * Parse the data_store from ProjectLocationDataStoreSessions resource.
+     *
+     * @param {string} projectLocationDataStoreSessionsName
+     *   A fully-qualified path representing project_location_data_store_sessions resource.
+     * @returns {string} A string representing the data_store.
+     */
+    matchDataStoreFromProjectLocationDataStoreSessionsName(projectLocationDataStoreSessionsName: string): string | number;
+    /**
+     * Parse the session from ProjectLocationDataStoreSessions resource.
+     *
+     * @param {string} projectLocationDataStoreSessionsName
+     *   A fully-qualified path representing project_location_data_store_sessions resource.
+     * @returns {string} A string representing the session.
+     */
+    matchSessionFromProjectLocationDataStoreSessionsName(projectLocationDataStoreSessionsName: string): string | number;
     /**
      * Return a fully-qualified projectLocationDataStoreSiteSearchEngine resource name string.
      *