@google-cloud/discoveryengine 1.2.0 → 1.3.0

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

@@ -114,6 +114,8 @@ export declare class SearchServiceClient {
      *   The request object that will be sent.
      * @param {string} request.servingConfig
      *   Required. The resource name of the Search serving config, such as
+     *   `projects/* /locations/global/collections/default_collection/engines/* /servingConfigs/default_serving_config`,
+     *   or
      *   `projects/* /locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`.
      *   This field is used to identify the serving configuration name, set
      *   of models used to make the search.
@@ -158,11 +160,22 @@ export declare class SearchServiceClient {
      *   expression is case-sensitive.
      *
      *   If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
+     *
+     *   Filtering in Vertex AI Search is done by mapping the LHS filter key to a
+     *   key property defined in the Vertex AI Search backend -- this mapping is
+     *   defined by the customer in their schema. For example a media customer might
+     *   have a field 'name' in their schema. In this case the filter would look
+     *   like this: filter --> name:'ANY("king kong")'
+     *
+     *   For more information about filtering including syntax and filter
+     *   operators, see
+     *   [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
      * @param {string} request.orderBy
      *   The order in which documents are returned. Documents can be ordered by
      *   a field in an {@link protos.google.cloud.discoveryengine.v1alpha.Document|Document}
      *   object. Leave it unset if ordered by relevance. `order_by` expression is
-     *   case-sensitive.
+     *   case-sensitive. For more information on ordering, see
+     *   [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order)
      *
      *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1alpha.UserInfo} request.userInfo
@@ -177,6 +190,8 @@ export declare class SearchServiceClient {
      *   error is returned.
      * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.BoostSpec} request.boostSpec
      *   Boost specification to boost certain documents.
+     *   For more information on boosting, see
+     *   [Boosting](https://cloud.google.com/retail/docs/boosting#boost)
      * @param {number[]} request.params
      *   Additional search parameters.
      *
@@ -184,9 +199,17 @@ export declare class SearchServiceClient {
      *
      *   * `user_country_code`: string. Default empty. If set to non-empty, results
      *      are restricted or boosted based on the location provided.
+     *      Example:
+     *      user_country_code: "au"
+     *
+     *      For available codes see [Country
+     *      Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes)
+     *
      *   * `search_type`: double. Default empty. Enables non-webpage searching
-     *     depending on the value. The only valid non-default value is 1,
-     *     which enables image searching.
+     *      depending on the value. The only valid non-default value is 1,
+     *      which enables image searching.
+     *      Example:
+     *      search_type: 1
      * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.QueryExpansionSpec} request.queryExpansionSpec
      *   The query expansion specification that specifies the conditions under which
      *   query expansion occurs.
@@ -286,6 +309,8 @@ export declare class SearchServiceClient {
      *   The request object that will be sent.
      * @param {string} request.servingConfig
      *   Required. The resource name of the Search serving config, such as
+     *   `projects/* /locations/global/collections/default_collection/engines/* /servingConfigs/default_serving_config`,
+     *   or
      *   `projects/* /locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`.
      *   This field is used to identify the serving configuration name, set
      *   of models used to make the search.
@@ -330,11 +355,22 @@ export declare class SearchServiceClient {
      *   expression is case-sensitive.
      *
      *   If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
+     *
+     *   Filtering in Vertex AI Search is done by mapping the LHS filter key to a
+     *   key property defined in the Vertex AI Search backend -- this mapping is
+     *   defined by the customer in their schema. For example a media customer might
+     *   have a field 'name' in their schema. In this case the filter would look
+     *   like this: filter --> name:'ANY("king kong")'
+     *
+     *   For more information about filtering including syntax and filter
+     *   operators, see
+     *   [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
      * @param {string} request.orderBy
      *   The order in which documents are returned. Documents can be ordered by
      *   a field in an {@link protos.google.cloud.discoveryengine.v1alpha.Document|Document}
      *   object. Leave it unset if ordered by relevance. `order_by` expression is
-     *   case-sensitive.
+     *   case-sensitive. For more information on ordering, see
+     *   [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order)
      *
      *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1alpha.UserInfo} request.userInfo
@@ -349,6 +385,8 @@ export declare class SearchServiceClient {
      *   error is returned.
      * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.BoostSpec} request.boostSpec
      *   Boost specification to boost certain documents.
+     *   For more information on boosting, see
+     *   [Boosting](https://cloud.google.com/retail/docs/boosting#boost)
      * @param {number[]} request.params
      *   Additional search parameters.
      *
@@ -356,9 +394,17 @@ export declare class SearchServiceClient {
      *
      *   * `user_country_code`: string. Default empty. If set to non-empty, results
      *      are restricted or boosted based on the location provided.
+     *      Example:
+     *      user_country_code: "au"
+     *
+     *      For available codes see [Country
+     *      Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes)
+     *
      *   * `search_type`: double. Default empty. Enables non-webpage searching
-     *     depending on the value. The only valid non-default value is 1,
-     *     which enables image searching.
+     *      depending on the value. The only valid non-default value is 1,
+     *      which enables image searching.
+     *      Example:
+     *      search_type: 1
      * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.QueryExpansionSpec} request.queryExpansionSpec
      *   The query expansion specification that specifies the conditions under which
      *   query expansion occurs.
@@ -453,6 +499,8 @@ export declare class SearchServiceClient {
      *   The request object that will be sent.
      * @param {string} request.servingConfig
      *   Required. The resource name of the Search serving config, such as
+     *   `projects/* /locations/global/collections/default_collection/engines/* /servingConfigs/default_serving_config`,
+     *   or
      *   `projects/* /locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`.
      *   This field is used to identify the serving configuration name, set
      *   of models used to make the search.
@@ -497,11 +545,22 @@ export declare class SearchServiceClient {
      *   expression is case-sensitive.
      *
      *   If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
+     *
+     *   Filtering in Vertex AI Search is done by mapping the LHS filter key to a
+     *   key property defined in the Vertex AI Search backend -- this mapping is
+     *   defined by the customer in their schema. For example a media customer might
+     *   have a field 'name' in their schema. In this case the filter would look
+     *   like this: filter --> name:'ANY("king kong")'
+     *
+     *   For more information about filtering including syntax and filter
+     *   operators, see
+     *   [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
      * @param {string} request.orderBy
      *   The order in which documents are returned. Documents can be ordered by
      *   a field in an {@link protos.google.cloud.discoveryengine.v1alpha.Document|Document}
      *   object. Leave it unset if ordered by relevance. `order_by` expression is
-     *   case-sensitive.
+     *   case-sensitive. For more information on ordering, see
+     *   [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order)
      *
      *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1alpha.UserInfo} request.userInfo
@@ -516,6 +575,8 @@ export declare class SearchServiceClient {
      *   error is returned.
      * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.BoostSpec} request.boostSpec
      *   Boost specification to boost certain documents.
+     *   For more information on boosting, see
+     *   [Boosting](https://cloud.google.com/retail/docs/boosting#boost)
      * @param {number[]} request.params
      *   Additional search parameters.
      *
@@ -523,9 +584,17 @@ export declare class SearchServiceClient {
      *
      *   * `user_country_code`: string. Default empty. If set to non-empty, results
      *      are restricted or boosted based on the location provided.
+     *      Example:
+     *      user_country_code: "au"
+     *
+     *      For available codes see [Country
+     *      Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes)
+     *
      *   * `search_type`: double. Default empty. Enables non-webpage searching
-     *     depending on the value. The only valid non-default value is 1,
-     *     which enables image searching.
+     *      depending on the value. The only valid non-default value is 1,
+     *      which enables image searching.
+     *      Example:
+     *      search_type: 1
      * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.QueryExpansionSpec} request.queryExpansionSpec
      *   The query expansion specification that specifies the conditions under which
      *   query expansion occurs.
@@ -664,6 +733,90 @@ export declare class SearchServiceClient {
      * ```
      */
     listLocationsAsync(request: LocationProtos.google.cloud.location.IListLocationsRequest, options?: CallOptions): AsyncIterable<LocationProtos.google.cloud.location.ILocation>;
+    /**
+     * Return a fully-qualified engine resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} collection
+     * @param {string} engine
+     * @returns {string} Resource name string.
+     */
+    enginePath(project: string, location: string, collection: string, engine: string): string;
+    /**
+     * Parse the project from Engine resource.
+     *
+     * @param {string} engineName
+     *   A fully-qualified path representing Engine resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromEngineName(engineName: string): string | number;
+    /**
+     * Parse the location from Engine resource.
+     *
+     * @param {string} engineName
+     *   A fully-qualified path representing Engine resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromEngineName(engineName: string): string | number;
+    /**
+     * Parse the collection from Engine resource.
+     *
+     * @param {string} engineName
+     *   A fully-qualified path representing Engine resource.
+     * @returns {string} A string representing the collection.
+     */
+    matchCollectionFromEngineName(engineName: string): string | number;
+    /**
+     * Parse the engine from Engine resource.
+     *
+     * @param {string} engineName
+     *   A fully-qualified path representing Engine resource.
+     * @returns {string} A string representing the engine.
+     */
+    matchEngineFromEngineName(engineName: string): string | number;
+    /**
+     * Return a fully-qualified projectLocationCollectionDataStore resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} collection
+     * @param {string} data_store
+     * @returns {string} Resource name string.
+     */
+    projectLocationCollectionDataStorePath(project: string, location: string, collection: string, dataStore: string): string;
+    /**
+     * Parse the project from ProjectLocationCollectionDataStore resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreName
+     *   A fully-qualified path representing project_location_collection_data_store resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromProjectLocationCollectionDataStoreName(projectLocationCollectionDataStoreName: string): string | number;
+    /**
+     * Parse the location from ProjectLocationCollectionDataStore resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreName
+     *   A fully-qualified path representing project_location_collection_data_store resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromProjectLocationCollectionDataStoreName(projectLocationCollectionDataStoreName: string): string | number;
+    /**
+     * Parse the collection from ProjectLocationCollectionDataStore resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreName
+     *   A fully-qualified path representing project_location_collection_data_store resource.
+     * @returns {string} A string representing the collection.
+     */
+    matchCollectionFromProjectLocationCollectionDataStoreName(projectLocationCollectionDataStoreName: string): string | number;
+    /**
+     * Parse the data_store from ProjectLocationCollectionDataStore resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreName
+     *   A fully-qualified path representing project_location_collection_data_store resource.
+     * @returns {string} A string representing the data_store.
+     */
+    matchDataStoreFromProjectLocationCollectionDataStoreName(projectLocationCollectionDataStoreName: string): string | number;
     /**
      * Return a fully-qualified projectLocationCollectionDataStoreBranch resource name string.
      *
@@ -979,6 +1132,39 @@ export declare class SearchServiceClient {
      * @returns {string} A string representing the serving_config.
      */
     matchServingConfigFromProjectLocationCollectionEngineServingConfigName(projectLocationCollectionEngineServingConfigName: string): string | number;
+    /**
+     * Return a fully-qualified projectLocationDataStore resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} data_store
+     * @returns {string} Resource name string.
+     */
+    projectLocationDataStorePath(project: string, location: string, dataStore: string): string;
+    /**
+     * Parse the project from ProjectLocationDataStore resource.
+     *
+     * @param {string} projectLocationDataStoreName
+     *   A fully-qualified path representing project_location_data_store resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromProjectLocationDataStoreName(projectLocationDataStoreName: string): string | number;
+    /**
+     * Parse the location from ProjectLocationDataStore resource.
+     *
+     * @param {string} projectLocationDataStoreName
+     *   A fully-qualified path representing project_location_data_store resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromProjectLocationDataStoreName(projectLocationDataStoreName: string): string | number;
+    /**
+     * Parse the data_store from ProjectLocationDataStore resource.
+     *
+     * @param {string} projectLocationDataStoreName
+     *   A fully-qualified path representing project_location_data_store resource.
+     * @returns {string} A string representing the data_store.
+     */
+    matchDataStoreFromProjectLocationDataStoreName(projectLocationDataStoreName: string): string | number;
     /**
      * Return a fully-qualified projectLocationDataStoreBranch resource name string.
      *

package/build/src/v1alpha/search_service_client.js

@@ -138,12 +138,15 @@ class SearchServiceClient {
         // identifiers to uniquely identify resources within the API.
         // Create useful helper objects for these.
         this.pathTemplates = {
+            enginePathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/engines/{engine}'),
+            projectLocationCollectionDataStorePathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}'),
             projectLocationCollectionDataStoreBranchPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}'),
             projectLocationCollectionDataStoreBranchDocumentPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}'),
             projectLocationCollectionDataStoreConversationPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/conversations/{conversation}'),
             projectLocationCollectionDataStoreSchemaPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/schemas/{schema}'),
             projectLocationCollectionDataStoreServingConfigPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/servingConfigs/{serving_config}'),
             projectLocationCollectionEngineServingConfigPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config}'),
+            projectLocationDataStorePathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}'),
             projectLocationDataStoreBranchPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}'),
             projectLocationDataStoreBranchDocumentPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/branches/{branch}/documents/{document}'),
             projectLocationDataStoreConversationPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/dataStores/{data_store}/conversations/{conversation}'),
@@ -275,6 +278,8 @@ class SearchServiceClient {
      *   The request object that will be sent.
      * @param {string} request.servingConfig
      *   Required. The resource name of the Search serving config, such as
+     *   `projects/* /locations/global/collections/default_collection/engines/* /servingConfigs/default_serving_config`,
+     *   or
      *   `projects/* /locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`.
      *   This field is used to identify the serving configuration name, set
      *   of models used to make the search.
@@ -319,11 +324,22 @@ class SearchServiceClient {
      *   expression is case-sensitive.
      *
      *   If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
+     *
+     *   Filtering in Vertex AI Search is done by mapping the LHS filter key to a
+     *   key property defined in the Vertex AI Search backend -- this mapping is
+     *   defined by the customer in their schema. For example a media customer might
+     *   have a field 'name' in their schema. In this case the filter would look
+     *   like this: filter --> name:'ANY("king kong")'
+     *
+     *   For more information about filtering including syntax and filter
+     *   operators, see
+     *   [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
      * @param {string} request.orderBy
      *   The order in which documents are returned. Documents can be ordered by
      *   a field in an {@link protos.google.cloud.discoveryengine.v1alpha.Document|Document}
      *   object. Leave it unset if ordered by relevance. `order_by` expression is
-     *   case-sensitive.
+     *   case-sensitive. For more information on ordering, see
+     *   [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order)
      *
      *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1alpha.UserInfo} request.userInfo
@@ -338,6 +354,8 @@ class SearchServiceClient {
      *   error is returned.
      * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.BoostSpec} request.boostSpec
      *   Boost specification to boost certain documents.
+     *   For more information on boosting, see
+     *   [Boosting](https://cloud.google.com/retail/docs/boosting#boost)
      * @param {number[]} request.params
      *   Additional search parameters.
      *
@@ -345,9 +363,17 @@ class SearchServiceClient {
      *
      *   * `user_country_code`: string. Default empty. If set to non-empty, results
      *      are restricted or boosted based on the location provided.
+     *      Example:
+     *      user_country_code: "au"
+     *
+     *      For available codes see [Country
+     *      Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes)
+     *
      *   * `search_type`: double. Default empty. Enables non-webpage searching
-     *     depending on the value. The only valid non-default value is 1,
-     *     which enables image searching.
+     *      depending on the value. The only valid non-default value is 1,
+     *      which enables image searching.
+     *      Example:
+     *      search_type: 1
      * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.QueryExpansionSpec} request.queryExpansionSpec
      *   The query expansion specification that specifies the conditions under which
      *   query expansion occurs.
@@ -456,6 +482,8 @@ class SearchServiceClient {
      *   The request object that will be sent.
      * @param {string} request.servingConfig
      *   Required. The resource name of the Search serving config, such as
+     *   `projects/* /locations/global/collections/default_collection/engines/* /servingConfigs/default_serving_config`,
+     *   or
      *   `projects/* /locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config`.
      *   This field is used to identify the serving configuration name, set
      *   of models used to make the search.
@@ -500,11 +528,22 @@ class SearchServiceClient {
      *   expression is case-sensitive.
      *
      *   If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
+     *
+     *   Filtering in Vertex AI Search is done by mapping the LHS filter key to a
+     *   key property defined in the Vertex AI Search backend -- this mapping is
+     *   defined by the customer in their schema. For example a media customer might
+     *   have a field 'name' in their schema. In this case the filter would look
+     *   like this: filter --> name:'ANY("king kong")'
+     *
+     *   For more information about filtering including syntax and filter
+     *   operators, see
+     *   [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
      * @param {string} request.orderBy
      *   The order in which documents are returned. Documents can be ordered by
      *   a field in an {@link protos.google.cloud.discoveryengine.v1alpha.Document|Document}
      *   object. Leave it unset if ordered by relevance. `order_by` expression is
-     *   case-sensitive.
+     *   case-sensitive. For more information on ordering, see
+     *   [Ordering](https://cloud.google.com/retail/docs/filter-and-order#order)
      *
      *   If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
      * @param {google.cloud.discoveryengine.v1alpha.UserInfo} request.userInfo
@@ -519,6 +558,8 @@ class SearchServiceClient {
      *   error is returned.
      * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.BoostSpec} request.boostSpec
      *   Boost specification to boost certain documents.
+     *   For more information on boosting, see
+     *   [Boosting](https://cloud.google.com/retail/docs/boosting#boost)
      * @param {number[]} request.params
      *   Additional search parameters.
      *
@@ -526,9 +567,17 @@ class SearchServiceClient {
      *
      *   * `user_country_code`: string. Default empty. If set to non-empty, results
      *      are restricted or boosted based on the location provided.
+     *      Example:
+     *      user_country_code: "au"
+     *
+     *      For available codes see [Country
+     *      Codes](https://developers.google.com/custom-search/docs/json_api_reference#countryCodes)
+     *
      *   * `search_type`: double. Default empty. Enables non-webpage searching
-     *     depending on the value. The only valid non-default value is 1,
-     *     which enables image searching.
+     *      depending on the value. The only valid non-default value is 1,
+     *      which enables image searching.
+     *      Example:
+     *      search_type: 1
      * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.QueryExpansionSpec} request.queryExpansionSpec
      *   The query expansion specification that specifies the conditions under which
      *   query expansion occurs.
@@ -688,6 +737,120 @@ class SearchServiceClient {
     // --------------------
     // -- Path templates --
     // --------------------
+    /**
+     * Return a fully-qualified engine resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} collection
+     * @param {string} engine
+     * @returns {string} Resource name string.
+     */
+    enginePath(project, location, collection, engine) {
+        return this.pathTemplates.enginePathTemplate.render({
+            project: project,
+            location: location,
+            collection: collection,
+            engine: engine,
+        });
+    }
+    /**
+     * Parse the project from Engine resource.
+     *
+     * @param {string} engineName
+     *   A fully-qualified path representing Engine resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromEngineName(engineName) {
+        return this.pathTemplates.enginePathTemplate.match(engineName).project;
+    }
+    /**
+     * Parse the location from Engine resource.
+     *
+     * @param {string} engineName
+     *   A fully-qualified path representing Engine resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromEngineName(engineName) {
+        return this.pathTemplates.enginePathTemplate.match(engineName).location;
+    }
+    /**
+     * Parse the collection from Engine resource.
+     *
+     * @param {string} engineName
+     *   A fully-qualified path representing Engine resource.
+     * @returns {string} A string representing the collection.
+     */
+    matchCollectionFromEngineName(engineName) {
+        return this.pathTemplates.enginePathTemplate.match(engineName).collection;
+    }
+    /**
+     * Parse the engine from Engine resource.
+     *
+     * @param {string} engineName
+     *   A fully-qualified path representing Engine resource.
+     * @returns {string} A string representing the engine.
+     */
+    matchEngineFromEngineName(engineName) {
+        return this.pathTemplates.enginePathTemplate.match(engineName).engine;
+    }
+    /**
+     * Return a fully-qualified projectLocationCollectionDataStore resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} collection
+     * @param {string} data_store
+     * @returns {string} Resource name string.
+     */
+    projectLocationCollectionDataStorePath(project, location, collection, dataStore) {
+        return this.pathTemplates.projectLocationCollectionDataStorePathTemplate.render({
+            project: project,
+            location: location,
+            collection: collection,
+            data_store: dataStore,
+        });
+    }
+    /**
+     * Parse the project from ProjectLocationCollectionDataStore resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreName
+     *   A fully-qualified path representing project_location_collection_data_store resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromProjectLocationCollectionDataStoreName(projectLocationCollectionDataStoreName) {
+        return this.pathTemplates.projectLocationCollectionDataStorePathTemplate.match(projectLocationCollectionDataStoreName).project;
+    }
+    /**
+     * Parse the location from ProjectLocationCollectionDataStore resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreName
+     *   A fully-qualified path representing project_location_collection_data_store resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromProjectLocationCollectionDataStoreName(projectLocationCollectionDataStoreName) {
+        return this.pathTemplates.projectLocationCollectionDataStorePathTemplate.match(projectLocationCollectionDataStoreName).location;
+    }
+    /**
+     * Parse the collection from ProjectLocationCollectionDataStore resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreName
+     *   A fully-qualified path representing project_location_collection_data_store resource.
+     * @returns {string} A string representing the collection.
+     */
+    matchCollectionFromProjectLocationCollectionDataStoreName(projectLocationCollectionDataStoreName) {
+        return this.pathTemplates.projectLocationCollectionDataStorePathTemplate.match(projectLocationCollectionDataStoreName).collection;
+    }
+    /**
+     * Parse the data_store from ProjectLocationCollectionDataStore resource.
+     *
+     * @param {string} projectLocationCollectionDataStoreName
+     *   A fully-qualified path representing project_location_collection_data_store resource.
+     * @returns {string} A string representing the data_store.
+     */
+    matchDataStoreFromProjectLocationCollectionDataStoreName(projectLocationCollectionDataStoreName) {
+        return this.pathTemplates.projectLocationCollectionDataStorePathTemplate.match(projectLocationCollectionDataStoreName).data_store;
+    }
     /**
      * Return a fully-qualified projectLocationCollectionDataStoreBranch resource name string.
      *
@@ -1114,6 +1277,51 @@ class SearchServiceClient {
     matchServingConfigFromProjectLocationCollectionEngineServingConfigName(projectLocationCollectionEngineServingConfigName) {
         return this.pathTemplates.projectLocationCollectionEngineServingConfigPathTemplate.match(projectLocationCollectionEngineServingConfigName).serving_config;
     }
+    /**
+     * Return a fully-qualified projectLocationDataStore resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} data_store
+     * @returns {string} Resource name string.
+     */
+    projectLocationDataStorePath(project, location, dataStore) {
+        return this.pathTemplates.projectLocationDataStorePathTemplate.render({
+            project: project,
+            location: location,
+            data_store: dataStore,
+        });
+    }
+    /**
+     * Parse the project from ProjectLocationDataStore resource.
+     *
+     * @param {string} projectLocationDataStoreName
+     *   A fully-qualified path representing project_location_data_store resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromProjectLocationDataStoreName(projectLocationDataStoreName) {
+        return this.pathTemplates.projectLocationDataStorePathTemplate.match(projectLocationDataStoreName).project;
+    }
+    /**
+     * Parse the location from ProjectLocationDataStore resource.
+     *
+     * @param {string} projectLocationDataStoreName
+     *   A fully-qualified path representing project_location_data_store resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromProjectLocationDataStoreName(projectLocationDataStoreName) {
+        return this.pathTemplates.projectLocationDataStorePathTemplate.match(projectLocationDataStoreName).location;
+    }
+    /**
+     * Parse the data_store from ProjectLocationDataStore resource.
+     *
+     * @param {string} projectLocationDataStoreName
+     *   A fully-qualified path representing project_location_data_store resource.
+     * @returns {string} A string representing the data_store.
+     */
+    matchDataStoreFromProjectLocationDataStoreName(projectLocationDataStoreName) {
+        return this.pathTemplates.projectLocationDataStorePathTemplate.match(projectLocationDataStoreName).data_store;
+    }
     /**
      * Return a fully-qualified projectLocationDataStoreBranch resource name string.
      *