@google-cloud/discoveryengine 1.2.0 → 1.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/README.md +25 -0
  3. package/build/protos/google/cloud/discoveryengine/v1alpha/common.proto +38 -8
  4. package/build/protos/google/cloud/discoveryengine/v1alpha/conversation.proto +3 -0
  5. package/build/protos/google/cloud/discoveryengine/v1alpha/conversational_search_service.proto +39 -0
  6. package/build/protos/google/cloud/discoveryengine/v1alpha/data_store.proto +98 -0
  7. package/build/protos/google/cloud/discoveryengine/v1alpha/data_store_service.proto +307 -0
  8. package/build/protos/google/cloud/discoveryengine/v1alpha/document.proto +1 -1
  9. package/build/protos/google/cloud/discoveryengine/v1alpha/engine.proto +370 -0
  10. package/build/protos/google/cloud/discoveryengine/v1alpha/engine_service.proto +336 -0
  11. package/build/protos/google/cloud/discoveryengine/v1alpha/recommendation_service.proto +9 -3
  12. package/build/protos/google/cloud/discoveryengine/v1alpha/search_service.proto +123 -3
  13. package/build/protos/google/cloud/discoveryengine/v1alpha/search_tuning_service.proto +147 -0
  14. package/build/protos/google/cloud/discoveryengine/v1alpha/site_search_engine.proto +164 -0
  15. package/build/protos/google/cloud/discoveryengine/v1alpha/site_search_engine_service.proto +540 -0
  16. package/build/protos/protos.d.ts +10923 -3222
  17. package/build/protos/protos.js +29891 -12914
  18. package/build/protos/protos.json +2367 -668
  19. package/build/src/index.js +1 -1
  20. package/build/src/v1/completion_service_client.js +1 -1
  21. package/build/src/v1/conversational_search_service_client.js +1 -1
  22. package/build/src/v1/document_service_client.js +1 -1
  23. package/build/src/v1/index.js +1 -1
  24. package/build/src/v1/schema_service_client.js +1 -1
  25. package/build/src/v1/search_service_client.js +1 -1
  26. package/build/src/v1/user_event_service_client.js +1 -1
  27. package/build/src/v1alpha/completion_service_client.d.ts +261 -0
  28. package/build/src/v1alpha/completion_service_client.js +360 -0
  29. package/build/src/v1alpha/conversational_search_service_client.d.ts +278 -0
  30. package/build/src/v1alpha/conversational_search_service_client.js +360 -0
  31. package/build/src/v1alpha/data_store_service_client.d.ts +1279 -0
  32. package/build/src/v1alpha/data_store_service_client.js +1739 -0
  33. package/build/src/v1alpha/data_store_service_client_config.json +46 -0
  34. package/build/src/v1alpha/document_service_client.d.ts +336 -0
  35. package/build/src/v1alpha/document_service_client.js +472 -2
  36. package/build/src/v1alpha/engine_service_client.d.ts +1298 -0
  37. package/build/src/v1alpha/engine_service_client.js +1789 -0
  38. package/build/src/v1alpha/engine_service_client_config.json +58 -0
  39. package/build/src/v1alpha/index.d.ts +3 -0
  40. package/build/src/v1alpha/index.js +7 -1
  41. package/build/src/v1alpha/recommendation_service_client.d.ts +345 -3
  42. package/build/src/v1alpha/recommendation_service_client.js +464 -0
  43. package/build/src/v1alpha/schema_service_client.d.ts +261 -0
  44. package/build/src/v1alpha/schema_service_client.js +368 -2
  45. package/build/src/v1alpha/search_service_client.d.ts +453 -9
  46. package/build/src/v1alpha/search_service_client.js +542 -6
  47. package/build/src/v1alpha/search_tuning_service_client.d.ts +968 -0
  48. package/build/src/v1alpha/search_tuning_service_client.js +1452 -0
  49. package/build/src/v1alpha/search_tuning_service_client_config.json +30 -0
  50. package/build/src/v1alpha/site_search_engine_service_client.d.ts +856 -1
  51. package/build/src/v1alpha/site_search_engine_service_client.js +993 -34
  52. package/build/src/v1alpha/site_search_engine_service_client_config.json +44 -0
  53. package/build/src/v1alpha/user_event_service_client.d.ts +261 -0
  54. package/build/src/v1alpha/user_event_service_client.js +368 -2
  55. package/build/src/v1beta/completion_service_client.js +1 -1
  56. package/build/src/v1beta/conversational_search_service_client.js +1 -1
  57. package/build/src/v1beta/document_service_client.js +1 -1
  58. package/build/src/v1beta/index.js +1 -1
  59. package/build/src/v1beta/recommendation_service_client.js +1 -1
  60. package/build/src/v1beta/schema_service_client.js +1 -1
  61. package/build/src/v1beta/search_service_client.js +1 -1
  62. package/build/src/v1beta/user_event_service_client.js +1 -1
  63. package/package.json +4 -4
@@ -151,6 +151,23 @@ export declare class ConversationalSearchServiceClient {
151
151
  * for more details.
152
152
  * @param {google.cloud.discoveryengine.v1alpha.SearchRequest.ContentSearchSpec.SummarySpec} request.summarySpec
153
153
  * A specification for configuring the summary returned in the response.
154
+ * @param {string} request.filter
155
+ * The filter syntax consists of an expression language for constructing a
156
+ * predicate from one or more fields of the documents being filtered. Filter
157
+ * expression is case-sensitive. This will be used to filter search results
158
+ * which may affect the summary response.
159
+ *
160
+ * If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
161
+ *
162
+ * Filtering in Vertex AI Search is done by mapping the LHS filter key to a
163
+ * key property defined in the Vertex AI Search backend -- this mapping is
164
+ * defined by the customer in their schema. For example a media customer might
165
+ * have a field 'name' in their schema. In this case the filter would look
166
+ * like this: filter --> name:'ANY("king kong")'
167
+ *
168
+ * For more information about filtering including syntax and filter
169
+ * operators, see
170
+ * [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
154
171
  * @param {object} [options]
155
172
  * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
156
173
  * @returns {Promise} - The promise which resolves to an array.
@@ -472,6 +489,48 @@ export declare class ConversationalSearchServiceClient {
472
489
  * ```
473
490
  */
474
491
  listLocationsAsync(request: LocationProtos.google.cloud.location.IListLocationsRequest, options?: CallOptions): AsyncIterable<LocationProtos.google.cloud.location.ILocation>;
492
+ /**
493
+ * Return a fully-qualified engine resource name string.
494
+ *
495
+ * @param {string} project
496
+ * @param {string} location
497
+ * @param {string} collection
498
+ * @param {string} engine
499
+ * @returns {string} Resource name string.
500
+ */
501
+ enginePath(project: string, location: string, collection: string, engine: string): string;
502
+ /**
503
+ * Parse the project from Engine resource.
504
+ *
505
+ * @param {string} engineName
506
+ * A fully-qualified path representing Engine resource.
507
+ * @returns {string} A string representing the project.
508
+ */
509
+ matchProjectFromEngineName(engineName: string): string | number;
510
+ /**
511
+ * Parse the location from Engine resource.
512
+ *
513
+ * @param {string} engineName
514
+ * A fully-qualified path representing Engine resource.
515
+ * @returns {string} A string representing the location.
516
+ */
517
+ matchLocationFromEngineName(engineName: string): string | number;
518
+ /**
519
+ * Parse the collection from Engine resource.
520
+ *
521
+ * @param {string} engineName
522
+ * A fully-qualified path representing Engine resource.
523
+ * @returns {string} A string representing the collection.
524
+ */
525
+ matchCollectionFromEngineName(engineName: string): string | number;
526
+ /**
527
+ * Parse the engine from Engine resource.
528
+ *
529
+ * @param {string} engineName
530
+ * A fully-qualified path representing Engine resource.
531
+ * @returns {string} A string representing the engine.
532
+ */
533
+ matchEngineFromEngineName(engineName: string): string | number;
475
534
  /**
476
535
  * Return a fully-qualified projectLocationCollectionDataStore resource name string.
477
536
  *
@@ -727,6 +786,150 @@ export declare class ConversationalSearchServiceClient {
727
786
  * @returns {string} A string representing the serving_config.
728
787
  */
729
788
  matchServingConfigFromProjectLocationCollectionDataStoreServingConfigName(projectLocationCollectionDataStoreServingConfigName: string): string | number;
789
+ /**
790
+ * Return a fully-qualified projectLocationCollectionDataStoreSiteSearchEngine resource name string.
791
+ *
792
+ * @param {string} project
793
+ * @param {string} location
794
+ * @param {string} collection
795
+ * @param {string} data_store
796
+ * @returns {string} Resource name string.
797
+ */
798
+ projectLocationCollectionDataStoreSiteSearchEnginePath(project: string, location: string, collection: string, dataStore: string): string;
799
+ /**
800
+ * Parse the project from ProjectLocationCollectionDataStoreSiteSearchEngine resource.
801
+ *
802
+ * @param {string} projectLocationCollectionDataStoreSiteSearchEngineName
803
+ * A fully-qualified path representing project_location_collection_data_store_siteSearchEngine resource.
804
+ * @returns {string} A string representing the project.
805
+ */
806
+ matchProjectFromProjectLocationCollectionDataStoreSiteSearchEngineName(projectLocationCollectionDataStoreSiteSearchEngineName: string): string | number;
807
+ /**
808
+ * Parse the location from ProjectLocationCollectionDataStoreSiteSearchEngine resource.
809
+ *
810
+ * @param {string} projectLocationCollectionDataStoreSiteSearchEngineName
811
+ * A fully-qualified path representing project_location_collection_data_store_siteSearchEngine resource.
812
+ * @returns {string} A string representing the location.
813
+ */
814
+ matchLocationFromProjectLocationCollectionDataStoreSiteSearchEngineName(projectLocationCollectionDataStoreSiteSearchEngineName: string): string | number;
815
+ /**
816
+ * Parse the collection from ProjectLocationCollectionDataStoreSiteSearchEngine resource.
817
+ *
818
+ * @param {string} projectLocationCollectionDataStoreSiteSearchEngineName
819
+ * A fully-qualified path representing project_location_collection_data_store_siteSearchEngine resource.
820
+ * @returns {string} A string representing the collection.
821
+ */
822
+ matchCollectionFromProjectLocationCollectionDataStoreSiteSearchEngineName(projectLocationCollectionDataStoreSiteSearchEngineName: string): string | number;
823
+ /**
824
+ * Parse the data_store from ProjectLocationCollectionDataStoreSiteSearchEngine resource.
825
+ *
826
+ * @param {string} projectLocationCollectionDataStoreSiteSearchEngineName
827
+ * A fully-qualified path representing project_location_collection_data_store_siteSearchEngine resource.
828
+ * @returns {string} A string representing the data_store.
829
+ */
830
+ matchDataStoreFromProjectLocationCollectionDataStoreSiteSearchEngineName(projectLocationCollectionDataStoreSiteSearchEngineName: string): string | number;
831
+ /**
832
+ * Return a fully-qualified projectLocationCollectionDataStoreSiteSearchEngineTargetSite resource name string.
833
+ *
834
+ * @param {string} project
835
+ * @param {string} location
836
+ * @param {string} collection
837
+ * @param {string} data_store
838
+ * @param {string} target_site
839
+ * @returns {string} Resource name string.
840
+ */
841
+ projectLocationCollectionDataStoreSiteSearchEngineTargetSitePath(project: string, location: string, collection: string, dataStore: string, targetSite: string): string;
842
+ /**
843
+ * Parse the project from ProjectLocationCollectionDataStoreSiteSearchEngineTargetSite resource.
844
+ *
845
+ * @param {string} projectLocationCollectionDataStoreSiteSearchEngineTargetSiteName
846
+ * A fully-qualified path representing project_location_collection_data_store_siteSearchEngine_target_site resource.
847
+ * @returns {string} A string representing the project.
848
+ */
849
+ matchProjectFromProjectLocationCollectionDataStoreSiteSearchEngineTargetSiteName(projectLocationCollectionDataStoreSiteSearchEngineTargetSiteName: string): string | number;
850
+ /**
851
+ * Parse the location from ProjectLocationCollectionDataStoreSiteSearchEngineTargetSite resource.
852
+ *
853
+ * @param {string} projectLocationCollectionDataStoreSiteSearchEngineTargetSiteName
854
+ * A fully-qualified path representing project_location_collection_data_store_siteSearchEngine_target_site resource.
855
+ * @returns {string} A string representing the location.
856
+ */
857
+ matchLocationFromProjectLocationCollectionDataStoreSiteSearchEngineTargetSiteName(projectLocationCollectionDataStoreSiteSearchEngineTargetSiteName: string): string | number;
858
+ /**
859
+ * Parse the collection from ProjectLocationCollectionDataStoreSiteSearchEngineTargetSite resource.
860
+ *
861
+ * @param {string} projectLocationCollectionDataStoreSiteSearchEngineTargetSiteName
862
+ * A fully-qualified path representing project_location_collection_data_store_siteSearchEngine_target_site resource.
863
+ * @returns {string} A string representing the collection.
864
+ */
865
+ matchCollectionFromProjectLocationCollectionDataStoreSiteSearchEngineTargetSiteName(projectLocationCollectionDataStoreSiteSearchEngineTargetSiteName: string): string | number;
866
+ /**
867
+ * Parse the data_store from ProjectLocationCollectionDataStoreSiteSearchEngineTargetSite resource.
868
+ *
869
+ * @param {string} projectLocationCollectionDataStoreSiteSearchEngineTargetSiteName
870
+ * A fully-qualified path representing project_location_collection_data_store_siteSearchEngine_target_site resource.
871
+ * @returns {string} A string representing the data_store.
872
+ */
873
+ matchDataStoreFromProjectLocationCollectionDataStoreSiteSearchEngineTargetSiteName(projectLocationCollectionDataStoreSiteSearchEngineTargetSiteName: string): string | number;
874
+ /**
875
+ * Parse the target_site from ProjectLocationCollectionDataStoreSiteSearchEngineTargetSite resource.
876
+ *
877
+ * @param {string} projectLocationCollectionDataStoreSiteSearchEngineTargetSiteName
878
+ * A fully-qualified path representing project_location_collection_data_store_siteSearchEngine_target_site resource.
879
+ * @returns {string} A string representing the target_site.
880
+ */
881
+ matchTargetSiteFromProjectLocationCollectionDataStoreSiteSearchEngineTargetSiteName(projectLocationCollectionDataStoreSiteSearchEngineTargetSiteName: string): string | number;
882
+ /**
883
+ * Return a fully-qualified projectLocationCollectionEngineConversation resource name string.
884
+ *
885
+ * @param {string} project
886
+ * @param {string} location
887
+ * @param {string} collection
888
+ * @param {string} engine
889
+ * @param {string} conversation
890
+ * @returns {string} Resource name string.
891
+ */
892
+ projectLocationCollectionEngineConversationPath(project: string, location: string, collection: string, engine: string, conversation: string): string;
893
+ /**
894
+ * Parse the project from ProjectLocationCollectionEngineConversation resource.
895
+ *
896
+ * @param {string} projectLocationCollectionEngineConversationName
897
+ * A fully-qualified path representing project_location_collection_engine_conversation resource.
898
+ * @returns {string} A string representing the project.
899
+ */
900
+ matchProjectFromProjectLocationCollectionEngineConversationName(projectLocationCollectionEngineConversationName: string): string | number;
901
+ /**
902
+ * Parse the location from ProjectLocationCollectionEngineConversation resource.
903
+ *
904
+ * @param {string} projectLocationCollectionEngineConversationName
905
+ * A fully-qualified path representing project_location_collection_engine_conversation resource.
906
+ * @returns {string} A string representing the location.
907
+ */
908
+ matchLocationFromProjectLocationCollectionEngineConversationName(projectLocationCollectionEngineConversationName: string): string | number;
909
+ /**
910
+ * Parse the collection from ProjectLocationCollectionEngineConversation resource.
911
+ *
912
+ * @param {string} projectLocationCollectionEngineConversationName
913
+ * A fully-qualified path representing project_location_collection_engine_conversation resource.
914
+ * @returns {string} A string representing the collection.
915
+ */
916
+ matchCollectionFromProjectLocationCollectionEngineConversationName(projectLocationCollectionEngineConversationName: string): string | number;
917
+ /**
918
+ * Parse the engine from ProjectLocationCollectionEngineConversation resource.
919
+ *
920
+ * @param {string} projectLocationCollectionEngineConversationName
921
+ * A fully-qualified path representing project_location_collection_engine_conversation resource.
922
+ * @returns {string} A string representing the engine.
923
+ */
924
+ matchEngineFromProjectLocationCollectionEngineConversationName(projectLocationCollectionEngineConversationName: string): string | number;
925
+ /**
926
+ * Parse the conversation from ProjectLocationCollectionEngineConversation resource.
927
+ *
928
+ * @param {string} projectLocationCollectionEngineConversationName
929
+ * A fully-qualified path representing project_location_collection_engine_conversation resource.
930
+ * @returns {string} A string representing the conversation.
931
+ */
932
+ matchConversationFromProjectLocationCollectionEngineConversationName(projectLocationCollectionEngineConversationName: string): string | number;
730
933
  /**
731
934
  * Return a fully-qualified projectLocationCollectionEngineServingConfig resource name string.
732
935
  *
@@ -988,6 +1191,81 @@ export declare class ConversationalSearchServiceClient {
988
1191
  * @returns {string} A string representing the serving_config.
989
1192
  */
990
1193
  matchServingConfigFromProjectLocationDataStoreServingConfigName(projectLocationDataStoreServingConfigName: string): string | number;
1194
+ /**
1195
+ * Return a fully-qualified projectLocationDataStoreSiteSearchEngine resource name string.
1196
+ *
1197
+ * @param {string} project
1198
+ * @param {string} location
1199
+ * @param {string} data_store
1200
+ * @returns {string} Resource name string.
1201
+ */
1202
+ projectLocationDataStoreSiteSearchEnginePath(project: string, location: string, dataStore: string): string;
1203
+ /**
1204
+ * Parse the project from ProjectLocationDataStoreSiteSearchEngine resource.
1205
+ *
1206
+ * @param {string} projectLocationDataStoreSiteSearchEngineName
1207
+ * A fully-qualified path representing project_location_data_store_siteSearchEngine resource.
1208
+ * @returns {string} A string representing the project.
1209
+ */
1210
+ matchProjectFromProjectLocationDataStoreSiteSearchEngineName(projectLocationDataStoreSiteSearchEngineName: string): string | number;
1211
+ /**
1212
+ * Parse the location from ProjectLocationDataStoreSiteSearchEngine resource.
1213
+ *
1214
+ * @param {string} projectLocationDataStoreSiteSearchEngineName
1215
+ * A fully-qualified path representing project_location_data_store_siteSearchEngine resource.
1216
+ * @returns {string} A string representing the location.
1217
+ */
1218
+ matchLocationFromProjectLocationDataStoreSiteSearchEngineName(projectLocationDataStoreSiteSearchEngineName: string): string | number;
1219
+ /**
1220
+ * Parse the data_store from ProjectLocationDataStoreSiteSearchEngine resource.
1221
+ *
1222
+ * @param {string} projectLocationDataStoreSiteSearchEngineName
1223
+ * A fully-qualified path representing project_location_data_store_siteSearchEngine resource.
1224
+ * @returns {string} A string representing the data_store.
1225
+ */
1226
+ matchDataStoreFromProjectLocationDataStoreSiteSearchEngineName(projectLocationDataStoreSiteSearchEngineName: string): string | number;
1227
+ /**
1228
+ * Return a fully-qualified projectLocationDataStoreSiteSearchEngineTargetSite resource name string.
1229
+ *
1230
+ * @param {string} project
1231
+ * @param {string} location
1232
+ * @param {string} data_store
1233
+ * @param {string} target_site
1234
+ * @returns {string} Resource name string.
1235
+ */
1236
+ projectLocationDataStoreSiteSearchEngineTargetSitePath(project: string, location: string, dataStore: string, targetSite: string): string;
1237
+ /**
1238
+ * Parse the project from ProjectLocationDataStoreSiteSearchEngineTargetSite resource.
1239
+ *
1240
+ * @param {string} projectLocationDataStoreSiteSearchEngineTargetSiteName
1241
+ * A fully-qualified path representing project_location_data_store_siteSearchEngine_target_site resource.
1242
+ * @returns {string} A string representing the project.
1243
+ */
1244
+ matchProjectFromProjectLocationDataStoreSiteSearchEngineTargetSiteName(projectLocationDataStoreSiteSearchEngineTargetSiteName: string): string | number;
1245
+ /**
1246
+ * Parse the location from ProjectLocationDataStoreSiteSearchEngineTargetSite resource.
1247
+ *
1248
+ * @param {string} projectLocationDataStoreSiteSearchEngineTargetSiteName
1249
+ * A fully-qualified path representing project_location_data_store_siteSearchEngine_target_site resource.
1250
+ * @returns {string} A string representing the location.
1251
+ */
1252
+ matchLocationFromProjectLocationDataStoreSiteSearchEngineTargetSiteName(projectLocationDataStoreSiteSearchEngineTargetSiteName: string): string | number;
1253
+ /**
1254
+ * Parse the data_store from ProjectLocationDataStoreSiteSearchEngineTargetSite resource.
1255
+ *
1256
+ * @param {string} projectLocationDataStoreSiteSearchEngineTargetSiteName
1257
+ * A fully-qualified path representing project_location_data_store_siteSearchEngine_target_site resource.
1258
+ * @returns {string} A string representing the data_store.
1259
+ */
1260
+ matchDataStoreFromProjectLocationDataStoreSiteSearchEngineTargetSiteName(projectLocationDataStoreSiteSearchEngineTargetSiteName: string): string | number;
1261
+ /**
1262
+ * Parse the target_site from ProjectLocationDataStoreSiteSearchEngineTargetSite resource.
1263
+ *
1264
+ * @param {string} projectLocationDataStoreSiteSearchEngineTargetSiteName
1265
+ * A fully-qualified path representing project_location_data_store_siteSearchEngine_target_site resource.
1266
+ * @returns {string} A string representing the target_site.
1267
+ */
1268
+ matchTargetSiteFromProjectLocationDataStoreSiteSearchEngineTargetSiteName(projectLocationDataStoreSiteSearchEngineTargetSiteName: string): string | number;
991
1269
  /**
992
1270
  * Terminate the gRPC channel and close the client.
993
1271
  *