@google-cloud/discoveryengine 2.0.1 → 2.2.0

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 (167) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/README.md +7 -2
  3. package/build/protos/google/cloud/discoveryengine/v1/answer.proto +54 -2
  4. package/build/protos/google/cloud/discoveryengine/v1/chunk.proto +2 -1
  5. package/build/protos/google/cloud/discoveryengine/v1/common.proto +35 -6
  6. package/build/protos/google/cloud/discoveryengine/v1/control.proto +113 -2
  7. package/build/protos/google/cloud/discoveryengine/v1/conversational_search_service.proto +168 -2
  8. package/build/protos/google/cloud/discoveryengine/v1/data_store.proto +23 -4
  9. package/build/protos/google/cloud/discoveryengine/v1/document.proto +7 -2
  10. package/build/protos/google/cloud/discoveryengine/v1/document_service.proto +1 -1
  11. package/build/protos/google/cloud/discoveryengine/v1/engine.proto +16 -3
  12. package/build/protos/google/cloud/discoveryengine/v1/grounded_generation_service.proto +70 -9
  13. package/build/protos/google/cloud/discoveryengine/v1/import_config.proto +20 -1
  14. package/build/protos/google/cloud/discoveryengine/v1/purge_config.proto +9 -5
  15. package/build/protos/google/cloud/discoveryengine/v1/rank_service.proto +3 -1
  16. package/build/protos/google/cloud/discoveryengine/v1/recommendation_service.proto +2 -2
  17. package/build/protos/google/cloud/discoveryengine/v1/safety.proto +107 -0
  18. package/build/protos/google/cloud/discoveryengine/v1/search_service.proto +96 -8
  19. package/build/protos/google/cloud/discoveryengine/v1/serving_config.proto +271 -0
  20. package/build/protos/google/cloud/discoveryengine/v1/serving_config_service.proto +75 -0
  21. package/build/protos/google/cloud/discoveryengine/v1/session.proto +19 -0
  22. package/build/protos/google/cloud/discoveryengine/v1/site_search_engine.proto +27 -3
  23. package/build/protos/google/cloud/discoveryengine/v1/site_search_engine_service.proto +184 -5
  24. package/build/protos/google/cloud/discoveryengine/v1/user_event.proto +34 -0
  25. package/build/protos/google/cloud/discoveryengine/v1/user_event_service.proto +16 -4
  26. package/build/protos/protos.d.ts +4390 -300
  27. package/build/protos/protos.js +13785 -2922
  28. package/build/protos/protos.json +1355 -14
  29. package/build/src/index.d.ts +4 -1
  30. package/build/src/index.js +4 -21
  31. package/build/src/v1/completion_service_client.d.ts +313 -76
  32. package/build/src/v1/completion_service_client.js +451 -262
  33. package/build/src/v1/completion_service_proto_list.json +3 -0
  34. package/build/src/v1/control_service_client.d.ts +318 -81
  35. package/build/src/v1/control_service_client.js +422 -132
  36. package/build/src/v1/control_service_proto_list.json +3 -0
  37. package/build/src/v1/conversational_search_service_client.d.ts +341 -134
  38. package/build/src/v1/conversational_search_service_client.js +395 -223
  39. package/build/src/v1/conversational_search_service_client_config.json +5 -0
  40. package/build/src/v1/conversational_search_service_proto_list.json +3 -0
  41. package/build/src/v1/data_store_service_client.d.ts +359 -122
  42. package/build/src/v1/data_store_service_client.js +460 -280
  43. package/build/src/v1/data_store_service_proto_list.json +3 -0
  44. package/build/src/v1/document_service_client.d.ts +364 -121
  45. package/build/src/v1/document_service_client.js +469 -300
  46. package/build/src/v1/document_service_proto_list.json +3 -0
  47. package/build/src/v1/engine_service_client.d.ts +340 -103
  48. package/build/src/v1/engine_service_client.js +460 -279
  49. package/build/src/v1/engine_service_proto_list.json +3 -0
  50. package/build/src/v1/gapic_metadata.json +59 -0
  51. package/build/src/v1/grounded_generation_service_client.d.ts +286 -51
  52. package/build/src/v1/grounded_generation_service_client.js +405 -100
  53. package/build/src/v1/grounded_generation_service_proto_list.json +3 -0
  54. package/build/src/v1/index.d.ts +1 -0
  55. package/build/src/v1/index.js +3 -1
  56. package/build/src/v1/project_service_client.d.ts +313 -76
  57. package/build/src/v1/project_service_client.js +434 -222
  58. package/build/src/v1/project_service_proto_list.json +3 -0
  59. package/build/src/v1/rank_service_client.d.ts +285 -48
  60. package/build/src/v1/rank_service_client.js +398 -85
  61. package/build/src/v1/rank_service_proto_list.json +3 -0
  62. package/build/src/v1/recommendation_service_client.d.ts +142 -49
  63. package/build/src/v1/recommendation_service_client.js +198 -82
  64. package/build/src/v1/recommendation_service_proto_list.json +3 -0
  65. package/build/src/v1/schema_service_client.d.ts +348 -111
  66. package/build/src/v1/schema_service_client.js +457 -273
  67. package/build/src/v1/schema_service_proto_list.json +3 -0
  68. package/build/src/v1/search_service_client.d.ts +748 -559
  69. package/build/src/v1/search_service_client.js +302 -133
  70. package/build/src/v1/search_service_proto_list.json +3 -0
  71. package/build/src/v1/search_tuning_service_client.d.ts +314 -77
  72. package/build/src/v1/search_tuning_service_client.js +439 -235
  73. package/build/src/v1/search_tuning_service_proto_list.json +3 -0
  74. package/build/src/v1/serving_config_service_client.d.ts +1851 -0
  75. package/build/src/v1/serving_config_service_client.js +2642 -0
  76. package/build/src/v1/serving_config_service_client_config.json +30 -0
  77. package/build/src/v1/serving_config_service_proto_list.json +39 -0
  78. package/build/src/v1/site_search_engine_service_client.d.ts +504 -151
  79. package/build/src/v1/site_search_engine_service_client.js +625 -351
  80. package/build/src/v1/site_search_engine_service_client_config.json +12 -0
  81. package/build/src/v1/site_search_engine_service_proto_list.json +3 -0
  82. package/build/src/v1/user_event_service_client.d.ts +335 -86
  83. package/build/src/v1/user_event_service_client.js +447 -253
  84. package/build/src/v1/user_event_service_proto_list.json +3 -0
  85. package/build/src/v1alpha/acl_config_service_client.d.ts +49 -49
  86. package/build/src/v1alpha/acl_config_service_client.js +82 -106
  87. package/build/src/v1alpha/chunk_service_client.d.ts +88 -88
  88. package/build/src/v1alpha/chunk_service_client.js +92 -120
  89. package/build/src/v1alpha/completion_service_client.d.ts +77 -77
  90. package/build/src/v1alpha/completion_service_client.js +134 -280
  91. package/build/src/v1alpha/control_service_client.d.ts +85 -85
  92. package/build/src/v1alpha/control_service_client.js +105 -151
  93. package/build/src/v1alpha/conversational_search_service_client.d.ts +143 -143
  94. package/build/src/v1alpha/conversational_search_service_client.js +145 -237
  95. package/build/src/v1alpha/data_store_service_client.d.ts +126 -126
  96. package/build/src/v1alpha/data_store_service_client.js +151 -316
  97. package/build/src/v1alpha/document_service_client.d.ts +126 -126
  98. package/build/src/v1alpha/document_service_client.js +156 -328
  99. package/build/src/v1alpha/engine_service_client.d.ts +106 -106
  100. package/build/src/v1alpha/engine_service_client.js +155 -325
  101. package/build/src/v1alpha/estimate_billing_service_client.d.ts +76 -76
  102. package/build/src/v1alpha/estimate_billing_service_client.js +118 -243
  103. package/build/src/v1alpha/evaluation_service_client.d.ts +161 -161
  104. package/build/src/v1alpha/evaluation_service_client.js +143 -295
  105. package/build/src/v1alpha/grounded_generation_service_client.d.ts +48 -48
  106. package/build/src/v1alpha/grounded_generation_service_client.js +79 -100
  107. package/build/src/v1alpha/project_service_client.d.ts +78 -78
  108. package/build/src/v1alpha/project_service_client.js +126 -262
  109. package/build/src/v1alpha/rank_service_client.d.ts +47 -47
  110. package/build/src/v1alpha/rank_service_client.js +81 -104
  111. package/build/src/v1alpha/recommendation_service_client.d.ts +47 -47
  112. package/build/src/v1alpha/recommendation_service_client.js +79 -100
  113. package/build/src/v1alpha/sample_query_service_client.d.ts +123 -123
  114. package/build/src/v1alpha/sample_query_service_client.js +144 -301
  115. package/build/src/v1alpha/sample_query_set_service_client.d.ts +94 -94
  116. package/build/src/v1alpha/sample_query_set_service_client.js +106 -153
  117. package/build/src/v1alpha/schema_service_client.d.ts +112 -112
  118. package/build/src/v1alpha/schema_service_client.js +140 -292
  119. package/build/src/v1alpha/search_service_client.d.ts +327 -327
  120. package/build/src/v1alpha/search_service_client.js +88 -112
  121. package/build/src/v1alpha/search_tuning_service_client.d.ts +77 -77
  122. package/build/src/v1alpha/search_tuning_service_client.js +122 -253
  123. package/build/src/v1alpha/serving_config_service_client.d.ts +75 -75
  124. package/build/src/v1alpha/serving_config_service_client.js +97 -133
  125. package/build/src/v1alpha/site_search_engine_service_client.d.ts +151 -151
  126. package/build/src/v1alpha/site_search_engine_service_client.js +184 -387
  127. package/build/src/v1alpha/user_event_service_client.d.ts +78 -78
  128. package/build/src/v1alpha/user_event_service_client.js +130 -271
  129. package/build/src/v1beta/completion_service_client.d.ts +78 -78
  130. package/build/src/v1beta/completion_service_client.js +136 -279
  131. package/build/src/v1beta/control_service_client.d.ts +84 -84
  132. package/build/src/v1beta/control_service_client.js +103 -147
  133. package/build/src/v1beta/conversational_search_service_client.d.ts +142 -142
  134. package/build/src/v1beta/conversational_search_service_client.js +143 -233
  135. package/build/src/v1beta/data_store_service_client.d.ts +124 -124
  136. package/build/src/v1beta/data_store_service_client.js +141 -288
  137. package/build/src/v1beta/document_service_client.d.ts +124 -124
  138. package/build/src/v1beta/document_service_client.js +150 -309
  139. package/build/src/v1beta/engine_service_client.d.ts +106 -106
  140. package/build/src/v1beta/engine_service_client.js +153 -315
  141. package/build/src/v1beta/evaluation_service_client.d.ts +161 -161
  142. package/build/src/v1beta/evaluation_service_client.js +141 -285
  143. package/build/src/v1beta/grounded_generation_service_client.d.ts +49 -49
  144. package/build/src/v1beta/grounded_generation_service_client.js +86 -114
  145. package/build/src/v1beta/project_service_client.d.ts +76 -76
  146. package/build/src/v1beta/project_service_client.js +115 -231
  147. package/build/src/v1beta/rank_service_client.d.ts +47 -47
  148. package/build/src/v1beta/rank_service_client.js +79 -99
  149. package/build/src/v1beta/recommendation_service_client.d.ts +47 -47
  150. package/build/src/v1beta/recommendation_service_client.js +77 -96
  151. package/build/src/v1beta/sample_query_service_client.d.ts +123 -123
  152. package/build/src/v1beta/sample_query_service_client.js +142 -291
  153. package/build/src/v1beta/sample_query_set_service_client.d.ts +94 -94
  154. package/build/src/v1beta/sample_query_set_service_client.js +104 -149
  155. package/build/src/v1beta/schema_service_client.d.ts +111 -111
  156. package/build/src/v1beta/schema_service_client.js +138 -282
  157. package/build/src/v1beta/search_service_client.d.ts +665 -665
  158. package/build/src/v1beta/search_service_client.js +97 -128
  159. package/build/src/v1beta/search_tuning_service_client.d.ts +77 -77
  160. package/build/src/v1beta/search_tuning_service_client.js +120 -243
  161. package/build/src/v1beta/serving_config_service_client.d.ts +75 -75
  162. package/build/src/v1beta/serving_config_service_client.js +95 -129
  163. package/build/src/v1beta/site_search_engine_service_client.d.ts +151 -151
  164. package/build/src/v1beta/site_search_engine_service_client.js +186 -386
  165. package/build/src/v1beta/user_event_service_client.d.ts +78 -78
  166. package/build/src/v1beta/user_event_service_client.js +128 -261
  167. package/package.json +4 -4
@@ -192,7 +192,7 @@ export declare class ConversationalSearchServiceClient {
192
192
  */
193
193
  converseConversation(request?: protos.google.cloud.discoveryengine.v1beta.IConverseConversationRequest, options?: CallOptions): Promise<[
194
194
  protos.google.cloud.discoveryengine.v1beta.IConverseConversationResponse,
195
- (protos.google.cloud.discoveryengine.v1beta.IConverseConversationRequest | undefined),
195
+ protos.google.cloud.discoveryengine.v1beta.IConverseConversationRequest | undefined,
196
196
  {} | undefined
197
197
  ]>;
198
198
  converseConversation(request: protos.google.cloud.discoveryengine.v1beta.IConverseConversationRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1beta.IConverseConversationResponse, protos.google.cloud.discoveryengine.v1beta.IConverseConversationRequest | null | undefined, {} | null | undefined>): void;
@@ -221,7 +221,7 @@ export declare class ConversationalSearchServiceClient {
221
221
  */
222
222
  createConversation(request?: protos.google.cloud.discoveryengine.v1beta.ICreateConversationRequest, options?: CallOptions): Promise<[
223
223
  protos.google.cloud.discoveryengine.v1beta.IConversation,
224
- (protos.google.cloud.discoveryengine.v1beta.ICreateConversationRequest | undefined),
224
+ protos.google.cloud.discoveryengine.v1beta.ICreateConversationRequest | undefined,
225
225
  {} | undefined
226
226
  ]>;
227
227
  createConversation(request: protos.google.cloud.discoveryengine.v1beta.ICreateConversationRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1beta.IConversation, protos.google.cloud.discoveryengine.v1beta.ICreateConversationRequest | null | undefined, {} | null | undefined>): void;
@@ -248,7 +248,7 @@ export declare class ConversationalSearchServiceClient {
248
248
  */
249
249
  deleteConversation(request?: protos.google.cloud.discoveryengine.v1beta.IDeleteConversationRequest, options?: CallOptions): Promise<[
250
250
  protos.google.protobuf.IEmpty,
251
- (protos.google.cloud.discoveryengine.v1beta.IDeleteConversationRequest | undefined),
251
+ protos.google.cloud.discoveryengine.v1beta.IDeleteConversationRequest | undefined,
252
252
  {} | undefined
253
253
  ]>;
254
254
  deleteConversation(request: protos.google.cloud.discoveryengine.v1beta.IDeleteConversationRequest, options: CallOptions, callback: Callback<protos.google.protobuf.IEmpty, protos.google.cloud.discoveryengine.v1beta.IDeleteConversationRequest | null | undefined, {} | null | undefined>): void;
@@ -284,7 +284,7 @@ export declare class ConversationalSearchServiceClient {
284
284
  */
285
285
  updateConversation(request?: protos.google.cloud.discoveryengine.v1beta.IUpdateConversationRequest, options?: CallOptions): Promise<[
286
286
  protos.google.cloud.discoveryengine.v1beta.IConversation,
287
- (protos.google.cloud.discoveryengine.v1beta.IUpdateConversationRequest | undefined),
287
+ protos.google.cloud.discoveryengine.v1beta.IUpdateConversationRequest | undefined,
288
288
  {} | undefined
289
289
  ]>;
290
290
  updateConversation(request: protos.google.cloud.discoveryengine.v1beta.IUpdateConversationRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1beta.IConversation, protos.google.cloud.discoveryengine.v1beta.IUpdateConversationRequest | null | undefined, {} | null | undefined>): void;
@@ -308,7 +308,7 @@ export declare class ConversationalSearchServiceClient {
308
308
  */
309
309
  getConversation(request?: protos.google.cloud.discoveryengine.v1beta.IGetConversationRequest, options?: CallOptions): Promise<[
310
310
  protos.google.cloud.discoveryengine.v1beta.IConversation,
311
- (protos.google.cloud.discoveryengine.v1beta.IGetConversationRequest | undefined),
311
+ protos.google.cloud.discoveryengine.v1beta.IGetConversationRequest | undefined,
312
312
  {} | undefined
313
313
  ]>;
314
314
  getConversation(request: protos.google.cloud.discoveryengine.v1beta.IGetConversationRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1beta.IConversation, protos.google.cloud.discoveryengine.v1beta.IGetConversationRequest | null | undefined, {} | null | undefined>): void;
@@ -398,7 +398,7 @@ export declare class ConversationalSearchServiceClient {
398
398
  */
399
399
  answerQuery(request?: protos.google.cloud.discoveryengine.v1beta.IAnswerQueryRequest, options?: CallOptions): Promise<[
400
400
  protos.google.cloud.discoveryengine.v1beta.IAnswerQueryResponse,
401
- (protos.google.cloud.discoveryengine.v1beta.IAnswerQueryRequest | undefined),
401
+ protos.google.cloud.discoveryengine.v1beta.IAnswerQueryRequest | undefined,
402
402
  {} | undefined
403
403
  ]>;
404
404
  answerQuery(request: protos.google.cloud.discoveryengine.v1beta.IAnswerQueryRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1beta.IAnswerQueryResponse, protos.google.cloud.discoveryengine.v1beta.IAnswerQueryRequest | null | undefined, {} | null | undefined>): void;
@@ -451,7 +451,7 @@ export declare class ConversationalSearchServiceClient {
451
451
  */
452
452
  createSession(request?: protos.google.cloud.discoveryengine.v1beta.ICreateSessionRequest, options?: CallOptions): Promise<[
453
453
  protos.google.cloud.discoveryengine.v1beta.ISession,
454
- (protos.google.cloud.discoveryengine.v1beta.ICreateSessionRequest | undefined),
454
+ protos.google.cloud.discoveryengine.v1beta.ICreateSessionRequest | undefined,
455
455
  {} | undefined
456
456
  ]>;
457
457
  createSession(request: protos.google.cloud.discoveryengine.v1beta.ICreateSessionRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1beta.ISession, protos.google.cloud.discoveryengine.v1beta.ICreateSessionRequest | null | undefined, {} | null | undefined>): void;
@@ -478,7 +478,7 @@ export declare class ConversationalSearchServiceClient {
478
478
  */
479
479
  deleteSession(request?: protos.google.cloud.discoveryengine.v1beta.IDeleteSessionRequest, options?: CallOptions): Promise<[
480
480
  protos.google.protobuf.IEmpty,
481
- (protos.google.cloud.discoveryengine.v1beta.IDeleteSessionRequest | undefined),
481
+ protos.google.cloud.discoveryengine.v1beta.IDeleteSessionRequest | undefined,
482
482
  {} | undefined
483
483
  ]>;
484
484
  deleteSession(request: protos.google.cloud.discoveryengine.v1beta.IDeleteSessionRequest, options: CallOptions, callback: Callback<protos.google.protobuf.IEmpty, protos.google.cloud.discoveryengine.v1beta.IDeleteSessionRequest | null | undefined, {} | null | undefined>): void;
@@ -513,7 +513,7 @@ export declare class ConversationalSearchServiceClient {
513
513
  */
514
514
  updateSession(request?: protos.google.cloud.discoveryengine.v1beta.IUpdateSessionRequest, options?: CallOptions): Promise<[
515
515
  protos.google.cloud.discoveryengine.v1beta.ISession,
516
- (protos.google.cloud.discoveryengine.v1beta.IUpdateSessionRequest | undefined),
516
+ protos.google.cloud.discoveryengine.v1beta.IUpdateSessionRequest | undefined,
517
517
  {} | undefined
518
518
  ]>;
519
519
  updateSession(request: protos.google.cloud.discoveryengine.v1beta.IUpdateSessionRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1beta.ISession, protos.google.cloud.discoveryengine.v1beta.IUpdateSessionRequest | null | undefined, {} | null | undefined>): void;
@@ -543,49 +543,49 @@ export declare class ConversationalSearchServiceClient {
543
543
  getSession(request: protos.google.cloud.discoveryengine.v1beta.IGetSessionRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1beta.ISession, protos.google.cloud.discoveryengine.v1beta.IGetSessionRequest | null | undefined, {} | null | undefined>): void;
544
544
  getSession(request: protos.google.cloud.discoveryengine.v1beta.IGetSessionRequest, callback: Callback<protos.google.cloud.discoveryengine.v1beta.ISession, protos.google.cloud.discoveryengine.v1beta.IGetSessionRequest | null | undefined, {} | null | undefined>): void;
545
545
  /**
546
- * Lists all Conversations by their parent
547
- * {@link protos.google.cloud.discoveryengine.v1beta.DataStore|DataStore}.
548
- *
549
- * @param {Object} request
550
- * The request object that will be sent.
551
- * @param {string} request.parent
552
- * Required. The data store resource name. Format:
553
- * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
554
- * @param {number} request.pageSize
555
- * Maximum number of results to return. If unspecified, defaults
556
- * to 50. Max allowed value is 1000.
557
- * @param {string} request.pageToken
558
- * A page token, received from a previous `ListConversations` call.
559
- * Provide this to retrieve the subsequent page.
560
- * @param {string} request.filter
561
- * A filter to apply on the list results. The supported features are:
562
- * user_pseudo_id, state.
563
- *
564
- * Example:
565
- * "user_pseudo_id = some_id"
566
- * @param {string} request.orderBy
567
- * A comma-separated list of fields to order by, sorted in ascending order.
568
- * Use "desc" after a field name for descending.
569
- * Supported fields:
570
- * * `update_time`
571
- * * `create_time`
572
- * * `conversation_name`
573
- *
574
- * Example:
575
- * "update_time desc"
576
- * "create_time"
577
- * @param {object} [options]
578
- * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
579
- * @returns {Promise} - The promise which resolves to an array.
580
- * The first element of the array is Array of {@link protos.google.cloud.discoveryengine.v1beta.Conversation|Conversation}.
581
- * The client library will perform auto-pagination by default: it will call the API as many
582
- * times as needed and will merge results from all the pages into this array.
583
- * Note that it can affect your quota.
584
- * We recommend using `listConversationsAsync()`
585
- * method described below for async iteration which you can stop as needed.
586
- * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
587
- * for more details and examples.
588
- */
546
+ * Lists all Conversations by their parent
547
+ * {@link protos.google.cloud.discoveryengine.v1beta.DataStore|DataStore}.
548
+ *
549
+ * @param {Object} request
550
+ * The request object that will be sent.
551
+ * @param {string} request.parent
552
+ * Required. The data store resource name. Format:
553
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
554
+ * @param {number} request.pageSize
555
+ * Maximum number of results to return. If unspecified, defaults
556
+ * to 50. Max allowed value is 1000.
557
+ * @param {string} request.pageToken
558
+ * A page token, received from a previous `ListConversations` call.
559
+ * Provide this to retrieve the subsequent page.
560
+ * @param {string} request.filter
561
+ * A filter to apply on the list results. The supported features are:
562
+ * user_pseudo_id, state.
563
+ *
564
+ * Example:
565
+ * "user_pseudo_id = some_id"
566
+ * @param {string} request.orderBy
567
+ * A comma-separated list of fields to order by, sorted in ascending order.
568
+ * Use "desc" after a field name for descending.
569
+ * Supported fields:
570
+ * * `update_time`
571
+ * * `create_time`
572
+ * * `conversation_name`
573
+ *
574
+ * Example:
575
+ * "update_time desc"
576
+ * "create_time"
577
+ * @param {object} [options]
578
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
579
+ * @returns {Promise} - The promise which resolves to an array.
580
+ * The first element of the array is Array of {@link protos.google.cloud.discoveryengine.v1beta.Conversation|Conversation}.
581
+ * The client library will perform auto-pagination by default: it will call the API as many
582
+ * times as needed and will merge results from all the pages into this array.
583
+ * Note that it can affect your quota.
584
+ * We recommend using `listConversationsAsync()`
585
+ * method described below for async iteration which you can stop as needed.
586
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
587
+ * for more details and examples.
588
+ */
589
589
  listConversations(request?: protos.google.cloud.discoveryengine.v1beta.IListConversationsRequest, options?: CallOptions): Promise<[
590
590
  protos.google.cloud.discoveryengine.v1beta.IConversation[],
591
591
  protos.google.cloud.discoveryengine.v1beta.IListConversationsRequest | null,
@@ -681,49 +681,49 @@ export declare class ConversationalSearchServiceClient {
681
681
  */
682
682
  listConversationsAsync(request?: protos.google.cloud.discoveryengine.v1beta.IListConversationsRequest, options?: CallOptions): AsyncIterable<protos.google.cloud.discoveryengine.v1beta.IConversation>;
683
683
  /**
684
- * Lists all Sessions by their parent
685
- * {@link protos.google.cloud.discoveryengine.v1beta.DataStore|DataStore}.
686
- *
687
- * @param {Object} request
688
- * The request object that will be sent.
689
- * @param {string} request.parent
690
- * Required. The data store resource name. Format:
691
- * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
692
- * @param {number} request.pageSize
693
- * Maximum number of results to return. If unspecified, defaults
694
- * to 50. Max allowed value is 1000.
695
- * @param {string} request.pageToken
696
- * A page token, received from a previous `ListSessions` call.
697
- * Provide this to retrieve the subsequent page.
698
- * @param {string} request.filter
699
- * A filter to apply on the list results. The supported features are:
700
- * user_pseudo_id, state.
701
- *
702
- * Example:
703
- * "user_pseudo_id = some_id"
704
- * @param {string} request.orderBy
705
- * A comma-separated list of fields to order by, sorted in ascending order.
706
- * Use "desc" after a field name for descending.
707
- * Supported fields:
708
- * * `update_time`
709
- * * `create_time`
710
- * * `session_name`
711
- *
712
- * Example:
713
- * "update_time desc"
714
- * "create_time"
715
- * @param {object} [options]
716
- * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
717
- * @returns {Promise} - The promise which resolves to an array.
718
- * The first element of the array is Array of {@link protos.google.cloud.discoveryengine.v1beta.Session|Session}.
719
- * The client library will perform auto-pagination by default: it will call the API as many
720
- * times as needed and will merge results from all the pages into this array.
721
- * Note that it can affect your quota.
722
- * We recommend using `listSessionsAsync()`
723
- * method described below for async iteration which you can stop as needed.
724
- * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
725
- * for more details and examples.
726
- */
684
+ * Lists all Sessions by their parent
685
+ * {@link protos.google.cloud.discoveryengine.v1beta.DataStore|DataStore}.
686
+ *
687
+ * @param {Object} request
688
+ * The request object that will be sent.
689
+ * @param {string} request.parent
690
+ * Required. The data store resource name. Format:
691
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
692
+ * @param {number} request.pageSize
693
+ * Maximum number of results to return. If unspecified, defaults
694
+ * to 50. Max allowed value is 1000.
695
+ * @param {string} request.pageToken
696
+ * A page token, received from a previous `ListSessions` call.
697
+ * Provide this to retrieve the subsequent page.
698
+ * @param {string} request.filter
699
+ * A filter to apply on the list results. The supported features are:
700
+ * user_pseudo_id, state.
701
+ *
702
+ * Example:
703
+ * "user_pseudo_id = some_id"
704
+ * @param {string} request.orderBy
705
+ * A comma-separated list of fields to order by, sorted in ascending order.
706
+ * Use "desc" after a field name for descending.
707
+ * Supported fields:
708
+ * * `update_time`
709
+ * * `create_time`
710
+ * * `session_name`
711
+ *
712
+ * Example:
713
+ * "update_time desc"
714
+ * "create_time"
715
+ * @param {object} [options]
716
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
717
+ * @returns {Promise} - The promise which resolves to an array.
718
+ * The first element of the array is Array of {@link protos.google.cloud.discoveryengine.v1beta.Session|Session}.
719
+ * The client library will perform auto-pagination by default: it will call the API as many
720
+ * times as needed and will merge results from all the pages into this array.
721
+ * Note that it can affect your quota.
722
+ * We recommend using `listSessionsAsync()`
723
+ * method described below for async iteration which you can stop as needed.
724
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
725
+ * for more details and examples.
726
+ */
727
727
  listSessions(request?: protos.google.cloud.discoveryengine.v1beta.IListSessionsRequest, options?: CallOptions): Promise<[
728
728
  protos.google.cloud.discoveryengine.v1beta.ISession[],
729
729
  protos.google.cloud.discoveryengine.v1beta.IListSessionsRequest | null,
@@ -819,55 +819,55 @@ export declare class ConversationalSearchServiceClient {
819
819
  */
820
820
  listSessionsAsync(request?: protos.google.cloud.discoveryengine.v1beta.IListSessionsRequest, options?: CallOptions): AsyncIterable<protos.google.cloud.discoveryengine.v1beta.ISession>;
821
821
  /**
822
- * Gets information about a location.
823
- *
824
- * @param {Object} request
825
- * The request object that will be sent.
826
- * @param {string} request.name
827
- * Resource name for the location.
828
- * @param {object} [options]
829
- * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html | CallOptions} for more details.
830
- * @returns {Promise} - The promise which resolves to an array.
831
- * The first element of the array is an object representing {@link google.cloud.location.Location | Location}.
832
- * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
833
- * for more details and examples.
834
- * @example
835
- * ```
836
- * const [response] = await client.getLocation(request);
837
- * ```
838
- */
822
+ * Gets information about a location.
823
+ *
824
+ * @param {Object} request
825
+ * The request object that will be sent.
826
+ * @param {string} request.name
827
+ * Resource name for the location.
828
+ * @param {object} [options]
829
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html | CallOptions} for more details.
830
+ * @returns {Promise} - The promise which resolves to an array.
831
+ * The first element of the array is an object representing {@link google.cloud.location.Location | Location}.
832
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
833
+ * for more details and examples.
834
+ * @example
835
+ * ```
836
+ * const [response] = await client.getLocation(request);
837
+ * ```
838
+ */
839
839
  getLocation(request: LocationProtos.google.cloud.location.IGetLocationRequest, options?: gax.CallOptions | Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>, callback?: Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>): Promise<LocationProtos.google.cloud.location.ILocation>;
840
840
  /**
841
- * Lists information about the supported locations for this service. Returns an iterable object.
842
- *
843
- * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
844
- * @param {Object} request
845
- * The request object that will be sent.
846
- * @param {string} request.name
847
- * The resource that owns the locations collection, if applicable.
848
- * @param {string} request.filter
849
- * The standard list filter.
850
- * @param {number} request.pageSize
851
- * The standard list page size.
852
- * @param {string} request.pageToken
853
- * The standard list page token.
854
- * @param {object} [options]
855
- * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
856
- * @returns {Object}
857
- * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
858
- * When you iterate the returned iterable, each element will be an object representing
859
- * {@link google.cloud.location.Location | Location}. The API will be called under the hood as needed, once per the page,
860
- * so you can stop the iteration when you don't need more results.
861
- * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
862
- * for more details and examples.
863
- * @example
864
- * ```
865
- * const iterable = client.listLocationsAsync(request);
866
- * for await (const response of iterable) {
867
- * // process response
868
- * }
869
- * ```
870
- */
841
+ * Lists information about the supported locations for this service. Returns an iterable object.
842
+ *
843
+ * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
844
+ * @param {Object} request
845
+ * The request object that will be sent.
846
+ * @param {string} request.name
847
+ * The resource that owns the locations collection, if applicable.
848
+ * @param {string} request.filter
849
+ * The standard list filter.
850
+ * @param {number} request.pageSize
851
+ * The standard list page size.
852
+ * @param {string} request.pageToken
853
+ * The standard list page token.
854
+ * @param {object} [options]
855
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
856
+ * @returns {Object}
857
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
858
+ * When you iterate the returned iterable, each element will be an object representing
859
+ * {@link google.cloud.location.Location | Location}. The API will be called under the hood as needed, once per the page,
860
+ * so you can stop the iteration when you don't need more results.
861
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
862
+ * for more details and examples.
863
+ * @example
864
+ * ```
865
+ * const iterable = client.listLocationsAsync(request);
866
+ * for await (const response of iterable) {
867
+ * // process response
868
+ * }
869
+ * ```
870
+ */
871
871
  listLocationsAsync(request: LocationProtos.google.cloud.location.IListLocationsRequest, options?: CallOptions): AsyncIterable<LocationProtos.google.cloud.location.ILocation>;
872
872
  /**
873
873
  * Return a fully-qualified engine resource name string.