@google-cloud/discoveryengine 2.1.0 → 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 (121) hide show
  1. package/CHANGELOG.md +7 -0
  2. package/build/protos/protos.d.ts +31 -316
  3. package/build/protos/protos.js +146 -593
  4. package/build/protos/protos.json +25 -1
  5. package/build/src/index.d.ts +1 -1
  6. package/build/src/index.js +1 -21
  7. package/build/src/v1/completion_service_client.d.ts +76 -76
  8. package/build/src/v1/completion_service_client.js +125 -262
  9. package/build/src/v1/control_service_client.d.ts +81 -81
  10. package/build/src/v1/control_service_client.js +96 -132
  11. package/build/src/v1/conversational_search_service_client.d.ts +143 -143
  12. package/build/src/v1/conversational_search_service_client.js +138 -226
  13. package/build/src/v1/data_store_service_client.d.ts +122 -122
  14. package/build/src/v1/data_store_service_client.js +134 -280
  15. package/build/src/v1/document_service_client.d.ts +120 -120
  16. package/build/src/v1/document_service_client.js +143 -300
  17. package/build/src/v1/engine_service_client.d.ts +103 -103
  18. package/build/src/v1/engine_service_client.js +134 -279
  19. package/build/src/v1/grounded_generation_service_client.d.ts +48 -48
  20. package/build/src/v1/grounded_generation_service_client.js +79 -100
  21. package/build/src/v1/project_service_client.d.ts +76 -76
  22. package/build/src/v1/project_service_client.js +108 -222
  23. package/build/src/v1/rank_service_client.d.ts +47 -47
  24. package/build/src/v1/rank_service_client.js +72 -85
  25. package/build/src/v1/recommendation_service_client.d.ts +47 -47
  26. package/build/src/v1/recommendation_service_client.js +70 -82
  27. package/build/src/v1/schema_service_client.d.ts +111 -111
  28. package/build/src/v1/schema_service_client.js +131 -273
  29. package/build/src/v1/search_service_client.d.ts +545 -545
  30. package/build/src/v1/search_service_client.js +90 -113
  31. package/build/src/v1/search_tuning_service_client.d.ts +77 -77
  32. package/build/src/v1/search_tuning_service_client.js +113 -235
  33. package/build/src/v1/serving_config_service_client.d.ts +48 -48
  34. package/build/src/v1/serving_config_service_client.js +69 -80
  35. package/build/src/v1/site_search_engine_service_client.d.ts +148 -148
  36. package/build/src/v1/site_search_engine_service_client.js +179 -378
  37. package/build/src/v1/user_event_service_client.d.ts +77 -77
  38. package/build/src/v1/user_event_service_client.js +121 -253
  39. package/build/src/v1alpha/acl_config_service_client.d.ts +49 -49
  40. package/build/src/v1alpha/acl_config_service_client.js +82 -106
  41. package/build/src/v1alpha/chunk_service_client.d.ts +88 -88
  42. package/build/src/v1alpha/chunk_service_client.js +92 -120
  43. package/build/src/v1alpha/completion_service_client.d.ts +77 -77
  44. package/build/src/v1alpha/completion_service_client.js +134 -280
  45. package/build/src/v1alpha/control_service_client.d.ts +85 -85
  46. package/build/src/v1alpha/control_service_client.js +105 -151
  47. package/build/src/v1alpha/conversational_search_service_client.d.ts +143 -143
  48. package/build/src/v1alpha/conversational_search_service_client.js +145 -237
  49. package/build/src/v1alpha/data_store_service_client.d.ts +126 -126
  50. package/build/src/v1alpha/data_store_service_client.js +151 -316
  51. package/build/src/v1alpha/document_service_client.d.ts +126 -126
  52. package/build/src/v1alpha/document_service_client.js +156 -328
  53. package/build/src/v1alpha/engine_service_client.d.ts +106 -106
  54. package/build/src/v1alpha/engine_service_client.js +155 -325
  55. package/build/src/v1alpha/estimate_billing_service_client.d.ts +76 -76
  56. package/build/src/v1alpha/estimate_billing_service_client.js +118 -243
  57. package/build/src/v1alpha/evaluation_service_client.d.ts +161 -161
  58. package/build/src/v1alpha/evaluation_service_client.js +143 -295
  59. package/build/src/v1alpha/grounded_generation_service_client.d.ts +48 -48
  60. package/build/src/v1alpha/grounded_generation_service_client.js +79 -100
  61. package/build/src/v1alpha/project_service_client.d.ts +78 -78
  62. package/build/src/v1alpha/project_service_client.js +126 -262
  63. package/build/src/v1alpha/rank_service_client.d.ts +47 -47
  64. package/build/src/v1alpha/rank_service_client.js +81 -104
  65. package/build/src/v1alpha/recommendation_service_client.d.ts +47 -47
  66. package/build/src/v1alpha/recommendation_service_client.js +79 -100
  67. package/build/src/v1alpha/sample_query_service_client.d.ts +123 -123
  68. package/build/src/v1alpha/sample_query_service_client.js +144 -301
  69. package/build/src/v1alpha/sample_query_set_service_client.d.ts +94 -94
  70. package/build/src/v1alpha/sample_query_set_service_client.js +106 -153
  71. package/build/src/v1alpha/schema_service_client.d.ts +112 -112
  72. package/build/src/v1alpha/schema_service_client.js +140 -292
  73. package/build/src/v1alpha/search_service_client.d.ts +327 -327
  74. package/build/src/v1alpha/search_service_client.js +88 -112
  75. package/build/src/v1alpha/search_tuning_service_client.d.ts +77 -77
  76. package/build/src/v1alpha/search_tuning_service_client.js +122 -253
  77. package/build/src/v1alpha/serving_config_service_client.d.ts +75 -75
  78. package/build/src/v1alpha/serving_config_service_client.js +97 -133
  79. package/build/src/v1alpha/site_search_engine_service_client.d.ts +151 -151
  80. package/build/src/v1alpha/site_search_engine_service_client.js +184 -387
  81. package/build/src/v1alpha/user_event_service_client.d.ts +78 -78
  82. package/build/src/v1alpha/user_event_service_client.js +130 -271
  83. package/build/src/v1beta/completion_service_client.d.ts +78 -78
  84. package/build/src/v1beta/completion_service_client.js +136 -279
  85. package/build/src/v1beta/control_service_client.d.ts +84 -84
  86. package/build/src/v1beta/control_service_client.js +103 -147
  87. package/build/src/v1beta/conversational_search_service_client.d.ts +142 -142
  88. package/build/src/v1beta/conversational_search_service_client.js +143 -233
  89. package/build/src/v1beta/data_store_service_client.d.ts +124 -124
  90. package/build/src/v1beta/data_store_service_client.js +141 -288
  91. package/build/src/v1beta/document_service_client.d.ts +124 -124
  92. package/build/src/v1beta/document_service_client.js +150 -309
  93. package/build/src/v1beta/engine_service_client.d.ts +106 -106
  94. package/build/src/v1beta/engine_service_client.js +153 -315
  95. package/build/src/v1beta/evaluation_service_client.d.ts +161 -161
  96. package/build/src/v1beta/evaluation_service_client.js +141 -285
  97. package/build/src/v1beta/grounded_generation_service_client.d.ts +49 -49
  98. package/build/src/v1beta/grounded_generation_service_client.js +86 -114
  99. package/build/src/v1beta/project_service_client.d.ts +76 -76
  100. package/build/src/v1beta/project_service_client.js +115 -231
  101. package/build/src/v1beta/rank_service_client.d.ts +47 -47
  102. package/build/src/v1beta/rank_service_client.js +79 -99
  103. package/build/src/v1beta/recommendation_service_client.d.ts +47 -47
  104. package/build/src/v1beta/recommendation_service_client.js +77 -96
  105. package/build/src/v1beta/sample_query_service_client.d.ts +123 -123
  106. package/build/src/v1beta/sample_query_service_client.js +142 -291
  107. package/build/src/v1beta/sample_query_set_service_client.d.ts +94 -94
  108. package/build/src/v1beta/sample_query_set_service_client.js +104 -149
  109. package/build/src/v1beta/schema_service_client.d.ts +111 -111
  110. package/build/src/v1beta/schema_service_client.js +138 -282
  111. package/build/src/v1beta/search_service_client.d.ts +665 -665
  112. package/build/src/v1beta/search_service_client.js +97 -128
  113. package/build/src/v1beta/search_tuning_service_client.d.ts +77 -77
  114. package/build/src/v1beta/search_tuning_service_client.js +120 -243
  115. package/build/src/v1beta/serving_config_service_client.d.ts +75 -75
  116. package/build/src/v1beta/serving_config_service_client.js +95 -129
  117. package/build/src/v1beta/site_search_engine_service_client.d.ts +151 -151
  118. package/build/src/v1beta/site_search_engine_service_client.js +186 -386
  119. package/build/src/v1beta/user_event_service_client.d.ts +78 -78
  120. package/build/src/v1beta/user_event_service_client.js +128 -261
  121. package/package.json +1 -1
@@ -192,7 +192,7 @@ export declare class ConversationalSearchServiceClient {
192
192
  */
193
193
  converseConversation(request?: protos.google.cloud.discoveryengine.v1.IConverseConversationRequest, options?: CallOptions): Promise<[
194
194
  protos.google.cloud.discoveryengine.v1.IConverseConversationResponse,
195
- (protos.google.cloud.discoveryengine.v1.IConverseConversationRequest | undefined),
195
+ protos.google.cloud.discoveryengine.v1.IConverseConversationRequest | undefined,
196
196
  {} | undefined
197
197
  ]>;
198
198
  converseConversation(request: protos.google.cloud.discoveryengine.v1.IConverseConversationRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1.IConverseConversationResponse, protos.google.cloud.discoveryengine.v1.IConverseConversationRequest | null | undefined, {} | null | undefined>): void;
@@ -221,7 +221,7 @@ export declare class ConversationalSearchServiceClient {
221
221
  */
222
222
  createConversation(request?: protos.google.cloud.discoveryengine.v1.ICreateConversationRequest, options?: CallOptions): Promise<[
223
223
  protos.google.cloud.discoveryengine.v1.IConversation,
224
- (protos.google.cloud.discoveryengine.v1.ICreateConversationRequest | undefined),
224
+ protos.google.cloud.discoveryengine.v1.ICreateConversationRequest | undefined,
225
225
  {} | undefined
226
226
  ]>;
227
227
  createConversation(request: protos.google.cloud.discoveryengine.v1.ICreateConversationRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1.IConversation, protos.google.cloud.discoveryengine.v1.ICreateConversationRequest | null | undefined, {} | null | undefined>): void;
@@ -248,7 +248,7 @@ export declare class ConversationalSearchServiceClient {
248
248
  */
249
249
  deleteConversation(request?: protos.google.cloud.discoveryengine.v1.IDeleteConversationRequest, options?: CallOptions): Promise<[
250
250
  protos.google.protobuf.IEmpty,
251
- (protos.google.cloud.discoveryengine.v1.IDeleteConversationRequest | undefined),
251
+ protos.google.cloud.discoveryengine.v1.IDeleteConversationRequest | undefined,
252
252
  {} | undefined
253
253
  ]>;
254
254
  deleteConversation(request: protos.google.cloud.discoveryengine.v1.IDeleteConversationRequest, options: CallOptions, callback: Callback<protos.google.protobuf.IEmpty, protos.google.cloud.discoveryengine.v1.IDeleteConversationRequest | null | undefined, {} | null | undefined>): void;
@@ -284,7 +284,7 @@ export declare class ConversationalSearchServiceClient {
284
284
  */
285
285
  updateConversation(request?: protos.google.cloud.discoveryengine.v1.IUpdateConversationRequest, options?: CallOptions): Promise<[
286
286
  protos.google.cloud.discoveryengine.v1.IConversation,
287
- (protos.google.cloud.discoveryengine.v1.IUpdateConversationRequest | undefined),
287
+ protos.google.cloud.discoveryengine.v1.IUpdateConversationRequest | undefined,
288
288
  {} | undefined
289
289
  ]>;
290
290
  updateConversation(request: protos.google.cloud.discoveryengine.v1.IUpdateConversationRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1.IConversation, protos.google.cloud.discoveryengine.v1.IUpdateConversationRequest | null | undefined, {} | null | undefined>): void;
@@ -308,7 +308,7 @@ export declare class ConversationalSearchServiceClient {
308
308
  */
309
309
  getConversation(request?: protos.google.cloud.discoveryengine.v1.IGetConversationRequest, options?: CallOptions): Promise<[
310
310
  protos.google.cloud.discoveryengine.v1.IConversation,
311
- (protos.google.cloud.discoveryengine.v1.IGetConversationRequest | undefined),
311
+ protos.google.cloud.discoveryengine.v1.IGetConversationRequest | undefined,
312
312
  {} | undefined
313
313
  ]>;
314
314
  getConversation(request: protos.google.cloud.discoveryengine.v1.IGetConversationRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1.IConversation, protos.google.cloud.discoveryengine.v1.IGetConversationRequest | null | undefined, {} | null | undefined>): void;
@@ -640,49 +640,49 @@ export declare class ConversationalSearchServiceClient {
640
640
  */
641
641
  streamAnswerQuery(request?: protos.google.cloud.discoveryengine.v1.IAnswerQueryRequest, options?: CallOptions): gax.CancellableStream;
642
642
  /**
643
- * Lists all Conversations by their parent
644
- * {@link protos.google.cloud.discoveryengine.v1.DataStore|DataStore}.
645
- *
646
- * @param {Object} request
647
- * The request object that will be sent.
648
- * @param {string} request.parent
649
- * Required. The data store resource name. Format:
650
- * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
651
- * @param {number} request.pageSize
652
- * Maximum number of results to return. If unspecified, defaults
653
- * to 50. Max allowed value is 1000.
654
- * @param {string} request.pageToken
655
- * A page token, received from a previous `ListConversations` call.
656
- * Provide this to retrieve the subsequent page.
657
- * @param {string} request.filter
658
- * A filter to apply on the list results. The supported features are:
659
- * user_pseudo_id, state.
660
- *
661
- * Example:
662
- * "user_pseudo_id = some_id"
663
- * @param {string} request.orderBy
664
- * A comma-separated list of fields to order by, sorted in ascending order.
665
- * Use "desc" after a field name for descending.
666
- * Supported fields:
667
- * * `update_time`
668
- * * `create_time`
669
- * * `conversation_name`
670
- *
671
- * Example:
672
- * "update_time desc"
673
- * "create_time"
674
- * @param {object} [options]
675
- * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
676
- * @returns {Promise} - The promise which resolves to an array.
677
- * The first element of the array is Array of {@link protos.google.cloud.discoveryengine.v1.Conversation|Conversation}.
678
- * The client library will perform auto-pagination by default: it will call the API as many
679
- * times as needed and will merge results from all the pages into this array.
680
- * Note that it can affect your quota.
681
- * We recommend using `listConversationsAsync()`
682
- * method described below for async iteration which you can stop as needed.
683
- * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
684
- * for more details and examples.
685
- */
643
+ * Lists all Conversations by their parent
644
+ * {@link protos.google.cloud.discoveryengine.v1.DataStore|DataStore}.
645
+ *
646
+ * @param {Object} request
647
+ * The request object that will be sent.
648
+ * @param {string} request.parent
649
+ * Required. The data store resource name. Format:
650
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
651
+ * @param {number} request.pageSize
652
+ * Maximum number of results to return. If unspecified, defaults
653
+ * to 50. Max allowed value is 1000.
654
+ * @param {string} request.pageToken
655
+ * A page token, received from a previous `ListConversations` call.
656
+ * Provide this to retrieve the subsequent page.
657
+ * @param {string} request.filter
658
+ * A filter to apply on the list results. The supported features are:
659
+ * user_pseudo_id, state.
660
+ *
661
+ * Example:
662
+ * "user_pseudo_id = some_id"
663
+ * @param {string} request.orderBy
664
+ * A comma-separated list of fields to order by, sorted in ascending order.
665
+ * Use "desc" after a field name for descending.
666
+ * Supported fields:
667
+ * * `update_time`
668
+ * * `create_time`
669
+ * * `conversation_name`
670
+ *
671
+ * Example:
672
+ * "update_time desc"
673
+ * "create_time"
674
+ * @param {object} [options]
675
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
676
+ * @returns {Promise} - The promise which resolves to an array.
677
+ * The first element of the array is Array of {@link protos.google.cloud.discoveryengine.v1.Conversation|Conversation}.
678
+ * The client library will perform auto-pagination by default: it will call the API as many
679
+ * times as needed and will merge results from all the pages into this array.
680
+ * Note that it can affect your quota.
681
+ * We recommend using `listConversationsAsync()`
682
+ * method described below for async iteration which you can stop as needed.
683
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
684
+ * for more details and examples.
685
+ */
686
686
  listConversations(request?: protos.google.cloud.discoveryengine.v1.IListConversationsRequest, options?: CallOptions): Promise<[
687
687
  protos.google.cloud.discoveryengine.v1.IConversation[],
688
688
  protos.google.cloud.discoveryengine.v1.IListConversationsRequest | null,
@@ -778,54 +778,54 @@ export declare class ConversationalSearchServiceClient {
778
778
  */
779
779
  listConversationsAsync(request?: protos.google.cloud.discoveryengine.v1.IListConversationsRequest, options?: CallOptions): AsyncIterable<protos.google.cloud.discoveryengine.v1.IConversation>;
780
780
  /**
781
- * Lists all Sessions by their parent
782
- * {@link protos.google.cloud.discoveryengine.v1.DataStore|DataStore}.
783
- *
784
- * @param {Object} request
785
- * The request object that will be sent.
786
- * @param {string} request.parent
787
- * Required. The data store resource name. Format:
788
- * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
789
- * @param {number} request.pageSize
790
- * Maximum number of results to return. If unspecified, defaults
791
- * to 50. Max allowed value is 1000.
792
- * @param {string} request.pageToken
793
- * A page token, received from a previous `ListSessions` call.
794
- * Provide this to retrieve the subsequent page.
795
- * @param {string} request.filter
796
- * A filter to apply on the list results. The supported features are:
797
- * user_pseudo_id, state.
798
- *
799
- * Example:
800
- * "user_pseudo_id = some_id"
801
- * @param {string} request.orderBy
802
- * A comma-separated list of fields to order by, sorted in ascending order.
803
- * Use "desc" after a field name for descending.
804
- * Supported fields:
805
- *
806
- * * `update_time`
807
- * * `create_time`
808
- * * `session_name`
809
- * * `is_pinned`
810
- *
811
- * Example:
812
- *
813
- * * "update_time desc"
814
- * * "create_time"
815
- * * "is_pinned desc,update_time desc": list sessions by is_pinned first, then
816
- * by update_time.
817
- * @param {object} [options]
818
- * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
819
- * @returns {Promise} - The promise which resolves to an array.
820
- * The first element of the array is Array of {@link protos.google.cloud.discoveryengine.v1.Session|Session}.
821
- * The client library will perform auto-pagination by default: it will call the API as many
822
- * times as needed and will merge results from all the pages into this array.
823
- * Note that it can affect your quota.
824
- * We recommend using `listSessionsAsync()`
825
- * method described below for async iteration which you can stop as needed.
826
- * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
827
- * for more details and examples.
828
- */
781
+ * Lists all Sessions by their parent
782
+ * {@link protos.google.cloud.discoveryengine.v1.DataStore|DataStore}.
783
+ *
784
+ * @param {Object} request
785
+ * The request object that will be sent.
786
+ * @param {string} request.parent
787
+ * Required. The data store resource name. Format:
788
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`
789
+ * @param {number} request.pageSize
790
+ * Maximum number of results to return. If unspecified, defaults
791
+ * to 50. Max allowed value is 1000.
792
+ * @param {string} request.pageToken
793
+ * A page token, received from a previous `ListSessions` call.
794
+ * Provide this to retrieve the subsequent page.
795
+ * @param {string} request.filter
796
+ * A filter to apply on the list results. The supported features are:
797
+ * user_pseudo_id, state.
798
+ *
799
+ * Example:
800
+ * "user_pseudo_id = some_id"
801
+ * @param {string} request.orderBy
802
+ * A comma-separated list of fields to order by, sorted in ascending order.
803
+ * Use "desc" after a field name for descending.
804
+ * Supported fields:
805
+ *
806
+ * * `update_time`
807
+ * * `create_time`
808
+ * * `session_name`
809
+ * * `is_pinned`
810
+ *
811
+ * Example:
812
+ *
813
+ * * "update_time desc"
814
+ * * "create_time"
815
+ * * "is_pinned desc,update_time desc": list sessions by is_pinned first, then
816
+ * by update_time.
817
+ * @param {object} [options]
818
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
819
+ * @returns {Promise} - The promise which resolves to an array.
820
+ * The first element of the array is Array of {@link protos.google.cloud.discoveryengine.v1.Session|Session}.
821
+ * The client library will perform auto-pagination by default: it will call the API as many
822
+ * times as needed and will merge results from all the pages into this array.
823
+ * Note that it can affect your quota.
824
+ * We recommend using `listSessionsAsync()`
825
+ * method described below for async iteration which you can stop as needed.
826
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
827
+ * for more details and examples.
828
+ */
829
829
  listSessions(request?: protos.google.cloud.discoveryengine.v1.IListSessionsRequest, options?: CallOptions): Promise<[
830
830
  protos.google.cloud.discoveryengine.v1.ISession[],
831
831
  protos.google.cloud.discoveryengine.v1.IListSessionsRequest | null,
@@ -931,55 +931,55 @@ export declare class ConversationalSearchServiceClient {
931
931
  */
932
932
  listSessionsAsync(request?: protos.google.cloud.discoveryengine.v1.IListSessionsRequest, options?: CallOptions): AsyncIterable<protos.google.cloud.discoveryengine.v1.ISession>;
933
933
  /**
934
- * Gets information about a location.
935
- *
936
- * @param {Object} request
937
- * The request object that will be sent.
938
- * @param {string} request.name
939
- * Resource name for the location.
940
- * @param {object} [options]
941
- * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html | CallOptions} for more details.
942
- * @returns {Promise} - The promise which resolves to an array.
943
- * The first element of the array is an object representing {@link google.cloud.location.Location | Location}.
944
- * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
945
- * for more details and examples.
946
- * @example
947
- * ```
948
- * const [response] = await client.getLocation(request);
949
- * ```
950
- */
934
+ * Gets information about a location.
935
+ *
936
+ * @param {Object} request
937
+ * The request object that will be sent.
938
+ * @param {string} request.name
939
+ * Resource name for the location.
940
+ * @param {object} [options]
941
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html | CallOptions} for more details.
942
+ * @returns {Promise} - The promise which resolves to an array.
943
+ * The first element of the array is an object representing {@link google.cloud.location.Location | Location}.
944
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
945
+ * for more details and examples.
946
+ * @example
947
+ * ```
948
+ * const [response] = await client.getLocation(request);
949
+ * ```
950
+ */
951
951
  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>;
952
952
  /**
953
- * Lists information about the supported locations for this service. Returns an iterable object.
954
- *
955
- * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
956
- * @param {Object} request
957
- * The request object that will be sent.
958
- * @param {string} request.name
959
- * The resource that owns the locations collection, if applicable.
960
- * @param {string} request.filter
961
- * The standard list filter.
962
- * @param {number} request.pageSize
963
- * The standard list page size.
964
- * @param {string} request.pageToken
965
- * The standard list page token.
966
- * @param {object} [options]
967
- * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
968
- * @returns {Object}
969
- * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
970
- * When you iterate the returned iterable, each element will be an object representing
971
- * {@link google.cloud.location.Location | Location}. The API will be called under the hood as needed, once per the page,
972
- * so you can stop the iteration when you don't need more results.
973
- * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
974
- * for more details and examples.
975
- * @example
976
- * ```
977
- * const iterable = client.listLocationsAsync(request);
978
- * for await (const response of iterable) {
979
- * // process response
980
- * }
981
- * ```
982
- */
953
+ * Lists information about the supported locations for this service. Returns an iterable object.
954
+ *
955
+ * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
956
+ * @param {Object} request
957
+ * The request object that will be sent.
958
+ * @param {string} request.name
959
+ * The resource that owns the locations collection, if applicable.
960
+ * @param {string} request.filter
961
+ * The standard list filter.
962
+ * @param {number} request.pageSize
963
+ * The standard list page size.
964
+ * @param {string} request.pageToken
965
+ * The standard list page token.
966
+ * @param {object} [options]
967
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
968
+ * @returns {Object}
969
+ * An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
970
+ * When you iterate the returned iterable, each element will be an object representing
971
+ * {@link google.cloud.location.Location | Location}. The API will be called under the hood as needed, once per the page,
972
+ * so you can stop the iteration when you don't need more results.
973
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
974
+ * for more details and examples.
975
+ * @example
976
+ * ```
977
+ * const iterable = client.listLocationsAsync(request);
978
+ * for await (const response of iterable) {
979
+ * // process response
980
+ * }
981
+ * ```
982
+ */
983
983
  listLocationsAsync(request: LocationProtos.google.cloud.location.IListLocationsRequest, options?: CallOptions): AsyncIterable<LocationProtos.google.cloud.location.ILocation>;
984
984
  /**
985
985
  * Return a fully-qualified engine resource name string.