@google-cloud/discoveryengine 0.7.0 → 1.0.0
Sign up to get free protection for your applications and to get access to all the features.
- package/CHANGELOG.md +24 -0
- package/README.md +6 -0
- package/build/protos/google/cloud/discoveryengine/v1beta/common.proto +1 -2
- package/build/protos/google/cloud/discoveryengine/v1beta/completion_service.proto +15 -2
- package/build/protos/google/cloud/discoveryengine/v1beta/conversation.proto +131 -0
- package/build/protos/google/cloud/discoveryengine/v1beta/conversational_search_service.proto +281 -0
- package/build/protos/google/cloud/discoveryengine/v1beta/document.proto +6 -5
- package/build/protos/google/cloud/discoveryengine/v1beta/document_service.proto +2 -1
- package/build/protos/google/cloud/discoveryengine/v1beta/import_config.proto +26 -22
- package/build/protos/google/cloud/discoveryengine/v1beta/schema.proto +1 -1
- package/build/protos/google/cloud/discoveryengine/v1beta/search_service.proto +193 -47
- package/build/protos/google/cloud/discoveryengine/v1beta/user_event.proto +41 -36
- package/build/protos/google/cloud/discoveryengine/v1beta/user_event_service.proto +2 -2
- package/build/protos/protos.d.ts +6529 -4472
- package/build/protos/protos.js +16561 -11622
- package/build/protos/protos.json +1842 -1317
- package/build/src/v1/completion_service_client.d.ts +6 -7
- package/build/src/v1/document_service_client.d.ts +83 -94
- package/build/src/v1/document_service_client.js +18 -22
- package/build/src/v1/schema_service_client.d.ts +39 -49
- package/build/src/v1/schema_service_client.js +17 -22
- package/build/src/v1/search_service_client.d.ts +31 -34
- package/build/src/v1/search_service_client.js +21 -23
- package/build/src/v1/user_event_service_client.d.ts +6 -10
- package/build/src/v1/user_event_service_client.js +1 -2
- package/build/src/v1beta/completion_service_client.d.ts +106 -8
- package/build/src/v1beta/completion_service_client.js +128 -0
- package/build/src/v1beta/conversational_search_service_client.d.ts +876 -0
- package/build/src/v1beta/conversational_search_service_client.js +1149 -0
- package/build/src/v1beta/conversational_search_service_client_config.json +68 -0
- package/build/src/v1beta/document_service_client.d.ts +183 -98
- package/build/src/v1beta/document_service_client.js +166 -22
- package/build/src/v1beta/index.d.ts +1 -0
- package/build/src/v1beta/index.js +3 -1
- package/build/src/v1beta/recommendation_service_client.d.ts +103 -11
- package/build/src/v1beta/recommendation_service_client.js +128 -0
- package/build/src/v1beta/schema_service_client.d.ts +132 -49
- package/build/src/v1beta/schema_service_client.js +163 -22
- package/build/src/v1beta/search_service_client.d.ts +163 -67
- package/build/src/v1beta/search_service_client.js +175 -45
- package/build/src/v1beta/user_event_service_client.d.ts +104 -15
- package/build/src/v1beta/user_event_service_client.js +147 -2
- package/package.json +8 -11
@@ -123,7 +123,7 @@ export declare class CompletionServiceClient {
|
|
123
123
|
*
|
124
124
|
* * `document` - Using suggestions generated from user-imported documents.
|
125
125
|
* * `search-history` - Using suggestions generated from the past history of
|
126
|
-
* {@link google.cloud.discoveryengine.v1.SearchService.Search|SearchService.Search}
|
126
|
+
* {@link protos.google.cloud.discoveryengine.v1.SearchService.Search|SearchService.Search}
|
127
127
|
* API calls. Do not use it when there is no traffic for Search API.
|
128
128
|
* * `user-event` - Using suggestions generated from user-imported search
|
129
129
|
* events.
|
@@ -132,7 +132,7 @@ export declare class CompletionServiceClient {
|
|
132
132
|
*
|
133
133
|
* * `document` is the default model for regular dataStores.
|
134
134
|
* * `search-history` is the default model for
|
135
|
-
* {@link google.cloud.discoveryengine.v1.IndustryVertical.SITE_SEARCH|IndustryVertical.SITE_SEARCH}
|
135
|
+
* {@link protos.google.cloud.discoveryengine.v1.IndustryVertical.SITE_SEARCH|IndustryVertical.SITE_SEARCH}
|
136
136
|
* dataStores.
|
137
137
|
* @param {string} request.userPseudoId
|
138
138
|
* A unique identifier for tracking visitors. For example, this could be
|
@@ -143,18 +143,17 @@ export declare class CompletionServiceClient {
|
|
143
143
|
* This field should NOT have a fixed value such as `unknown_visitor`.
|
144
144
|
*
|
145
145
|
* This should be the same identifier as
|
146
|
-
* {@link google.cloud.discoveryengine.v1.UserEvent.user_pseudo_id|UserEvent.user_pseudo_id}
|
146
|
+
* {@link protos.google.cloud.discoveryengine.v1.UserEvent.user_pseudo_id|UserEvent.user_pseudo_id}
|
147
147
|
* and
|
148
|
-
* {@link google.cloud.discoveryengine.v1.SearchRequest.user_pseudo_id|SearchRequest.user_pseudo_id}.
|
148
|
+
* {@link protos.google.cloud.discoveryengine.v1.SearchRequest.user_pseudo_id|SearchRequest.user_pseudo_id}.
|
149
149
|
*
|
150
150
|
* The field must be a UTF-8 encoded string with a length limit of 128
|
151
151
|
* characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
|
152
152
|
* @param {object} [options]
|
153
153
|
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
154
154
|
* @returns {Promise} - The promise which resolves to an array.
|
155
|
-
* The first element of the array is an object representing {@link google.cloud.discoveryengine.v1.CompleteQueryResponse
|
156
|
-
* Please see the
|
157
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
|
155
|
+
* The first element of the array is an object representing {@link protos.google.cloud.discoveryengine.v1.CompleteQueryResponse|CompleteQueryResponse}.
|
156
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
158
157
|
* for more details and examples.
|
159
158
|
* @example <caption>include:samples/generated/v1/completion_service.complete_query.js</caption>
|
160
159
|
* region_tag:discoveryengine_v1_generated_CompletionService_CompleteQuery_async
|
@@ -4,7 +4,7 @@ import type { Callback, CallOptions, Descriptors, ClientOptions, LROperation, Pa
|
|
4
4
|
import { Transform } from 'stream';
|
5
5
|
import * as protos from '../../protos/protos';
|
6
6
|
/**
|
7
|
-
* Service for ingesting {@link google.cloud.discoveryengine.v1.Document|Document}
|
7
|
+
* Service for ingesting {@link protos.google.cloud.discoveryengine.v1.Document|Document}
|
8
8
|
* information of the customer's website.
|
9
9
|
* @class
|
10
10
|
* @memberof v1
|
@@ -110,27 +110,26 @@ export declare class DocumentServiceClient {
|
|
110
110
|
getProjectId(): Promise<string>;
|
111
111
|
getProjectId(callback: Callback<string, undefined, undefined>): void;
|
112
112
|
/**
|
113
|
-
* Gets a {@link google.cloud.discoveryengine.v1.Document|Document}.
|
113
|
+
* Gets a {@link protos.google.cloud.discoveryengine.v1.Document|Document}.
|
114
114
|
*
|
115
115
|
* @param {Object} request
|
116
116
|
* The request object that will be sent.
|
117
117
|
* @param {string} request.name
|
118
118
|
* Required. Full resource name of
|
119
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document}, such as
|
119
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}, such as
|
120
120
|
* `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`.
|
121
121
|
*
|
122
122
|
* If the caller does not have permission to access the
|
123
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document}, regardless of whether
|
123
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}, regardless of whether
|
124
124
|
* or not it exists, a `PERMISSION_DENIED` error is returned.
|
125
125
|
*
|
126
|
-
* If the requested {@link google.cloud.discoveryengine.v1.Document|Document} does
|
126
|
+
* If the requested {@link protos.google.cloud.discoveryengine.v1.Document|Document} does
|
127
127
|
* not exist, a `NOT_FOUND` error is returned.
|
128
128
|
* @param {object} [options]
|
129
129
|
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
130
130
|
* @returns {Promise} - The promise which resolves to an array.
|
131
|
-
* The first element of the array is an object representing {@link google.cloud.discoveryengine.v1.Document
|
132
|
-
* Please see the
|
133
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
|
131
|
+
* The first element of the array is an object representing {@link protos.google.cloud.discoveryengine.v1.Document|Document}.
|
132
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
134
133
|
* for more details and examples.
|
135
134
|
* @example <caption>include:samples/generated/v1/document_service.get_document.js</caption>
|
136
135
|
* region_tag:discoveryengine_v1_generated_DocumentService_GetDocument_async
|
@@ -143,7 +142,7 @@ export declare class DocumentServiceClient {
|
|
143
142
|
getDocument(request: protos.google.cloud.discoveryengine.v1.IGetDocumentRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1.IDocument, protos.google.cloud.discoveryengine.v1.IGetDocumentRequest | null | undefined, {} | null | undefined>): void;
|
144
143
|
getDocument(request: protos.google.cloud.discoveryengine.v1.IGetDocumentRequest, callback: Callback<protos.google.cloud.discoveryengine.v1.IDocument, protos.google.cloud.discoveryengine.v1.IGetDocumentRequest | null | undefined, {} | null | undefined>): void;
|
145
144
|
/**
|
146
|
-
* Creates a {@link google.cloud.discoveryengine.v1.Document|Document}.
|
145
|
+
* Creates a {@link protos.google.cloud.discoveryengine.v1.Document|Document}.
|
147
146
|
*
|
148
147
|
* @param {Object} request
|
149
148
|
* The request object that will be sent.
|
@@ -151,21 +150,21 @@ export declare class DocumentServiceClient {
|
|
151
150
|
* Required. The parent resource name, such as
|
152
151
|
* `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.
|
153
152
|
* @param {google.cloud.discoveryengine.v1.Document} request.document
|
154
|
-
* Required. The {@link google.cloud.discoveryengine.v1.Document|Document} to
|
153
|
+
* Required. The {@link protos.google.cloud.discoveryengine.v1.Document|Document} to
|
155
154
|
* create.
|
156
155
|
* @param {string} request.documentId
|
157
156
|
* Required. The ID to use for the
|
158
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document}, which will become the
|
157
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}, which will become the
|
159
158
|
* final component of the
|
160
|
-
* {@link google.cloud.discoveryengine.v1.Document.name|Document.name}.
|
159
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document.name|Document.name}.
|
161
160
|
*
|
162
161
|
* If the caller does not have permission to create the
|
163
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document}, regardless of whether
|
162
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}, regardless of whether
|
164
163
|
* or not it exists, a `PERMISSION_DENIED` error is returned.
|
165
164
|
*
|
166
165
|
* This field must be unique among all
|
167
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document}s with the same
|
168
|
-
* {@link google.cloud.discoveryengine.v1.CreateDocumentRequest.parent|parent}.
|
166
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}s with the same
|
167
|
+
* {@link protos.google.cloud.discoveryengine.v1.CreateDocumentRequest.parent|parent}.
|
169
168
|
* Otherwise, an `ALREADY_EXISTS` error is returned.
|
170
169
|
*
|
171
170
|
* This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034)
|
@@ -174,9 +173,8 @@ export declare class DocumentServiceClient {
|
|
174
173
|
* @param {object} [options]
|
175
174
|
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
176
175
|
* @returns {Promise} - The promise which resolves to an array.
|
177
|
-
* The first element of the array is an object representing {@link google.cloud.discoveryengine.v1.Document
|
178
|
-
* Please see the
|
179
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
|
176
|
+
* The first element of the array is an object representing {@link protos.google.cloud.discoveryengine.v1.Document|Document}.
|
177
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
180
178
|
* for more details and examples.
|
181
179
|
* @example <caption>include:samples/generated/v1/document_service.create_document.js</caption>
|
182
180
|
* region_tag:discoveryengine_v1_generated_DocumentService_CreateDocument_async
|
@@ -189,7 +187,7 @@ export declare class DocumentServiceClient {
|
|
189
187
|
createDocument(request: protos.google.cloud.discoveryengine.v1.ICreateDocumentRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1.IDocument, protos.google.cloud.discoveryengine.v1.ICreateDocumentRequest | null | undefined, {} | null | undefined>): void;
|
190
188
|
createDocument(request: protos.google.cloud.discoveryengine.v1.ICreateDocumentRequest, callback: Callback<protos.google.cloud.discoveryengine.v1.IDocument, protos.google.cloud.discoveryengine.v1.ICreateDocumentRequest | null | undefined, {} | null | undefined>): void;
|
191
189
|
/**
|
192
|
-
* Updates a {@link google.cloud.discoveryengine.v1.Document|Document}.
|
190
|
+
* Updates a {@link protos.google.cloud.discoveryengine.v1.Document|Document}.
|
193
191
|
*
|
194
192
|
* @param {Object} request
|
195
193
|
* The request object that will be sent.
|
@@ -197,23 +195,22 @@ export declare class DocumentServiceClient {
|
|
197
195
|
* Required. The document to update/create.
|
198
196
|
*
|
199
197
|
* If the caller does not have permission to update the
|
200
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document}, regardless of whether
|
198
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}, regardless of whether
|
201
199
|
* or not it exists, a `PERMISSION_DENIED` error is returned.
|
202
200
|
*
|
203
|
-
* If the {@link google.cloud.discoveryengine.v1.Document|Document} to update does
|
201
|
+
* If the {@link protos.google.cloud.discoveryengine.v1.Document|Document} to update does
|
204
202
|
* not exist and
|
205
|
-
* {@link google.cloud.discoveryengine.v1.UpdateDocumentRequest.allow_missing|allow_missing}
|
203
|
+
* {@link protos.google.cloud.discoveryengine.v1.UpdateDocumentRequest.allow_missing|allow_missing}
|
206
204
|
* is not set, a `NOT_FOUND` error is returned.
|
207
205
|
* @param {boolean} request.allowMissing
|
208
206
|
* If set to true, and the
|
209
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document} is not found, a new
|
210
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document} will be created.
|
207
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document} is not found, a new
|
208
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document} will be created.
|
211
209
|
* @param {object} [options]
|
212
210
|
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
213
211
|
* @returns {Promise} - The promise which resolves to an array.
|
214
|
-
* The first element of the array is an object representing {@link google.cloud.discoveryengine.v1.Document
|
215
|
-
* Please see the
|
216
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
|
212
|
+
* The first element of the array is an object representing {@link protos.google.cloud.discoveryengine.v1.Document|Document}.
|
213
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
217
214
|
* for more details and examples.
|
218
215
|
* @example <caption>include:samples/generated/v1/document_service.update_document.js</caption>
|
219
216
|
* region_tag:discoveryengine_v1_generated_DocumentService_UpdateDocument_async
|
@@ -226,27 +223,26 @@ export declare class DocumentServiceClient {
|
|
226
223
|
updateDocument(request: protos.google.cloud.discoveryengine.v1.IUpdateDocumentRequest, options: CallOptions, callback: Callback<protos.google.cloud.discoveryengine.v1.IDocument, protos.google.cloud.discoveryengine.v1.IUpdateDocumentRequest | null | undefined, {} | null | undefined>): void;
|
227
224
|
updateDocument(request: protos.google.cloud.discoveryengine.v1.IUpdateDocumentRequest, callback: Callback<protos.google.cloud.discoveryengine.v1.IDocument, protos.google.cloud.discoveryengine.v1.IUpdateDocumentRequest | null | undefined, {} | null | undefined>): void;
|
228
225
|
/**
|
229
|
-
* Deletes a {@link google.cloud.discoveryengine.v1.Document|Document}.
|
226
|
+
* Deletes a {@link protos.google.cloud.discoveryengine.v1.Document|Document}.
|
230
227
|
*
|
231
228
|
* @param {Object} request
|
232
229
|
* The request object that will be sent.
|
233
230
|
* @param {string} request.name
|
234
231
|
* Required. Full resource name of
|
235
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document}, such as
|
232
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}, such as
|
236
233
|
* `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`.
|
237
234
|
*
|
238
235
|
* If the caller does not have permission to delete the
|
239
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document}, regardless of whether
|
236
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}, regardless of whether
|
240
237
|
* or not it exists, a `PERMISSION_DENIED` error is returned.
|
241
238
|
*
|
242
|
-
* If the {@link google.cloud.discoveryengine.v1.Document|Document} to delete does
|
239
|
+
* If the {@link protos.google.cloud.discoveryengine.v1.Document|Document} to delete does
|
243
240
|
* not exist, a `NOT_FOUND` error is returned.
|
244
241
|
* @param {object} [options]
|
245
242
|
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
246
243
|
* @returns {Promise} - The promise which resolves to an array.
|
247
|
-
* The first element of the array is an object representing {@link google.protobuf.Empty
|
248
|
-
* Please see the
|
249
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
|
244
|
+
* The first element of the array is an object representing {@link protos.google.protobuf.Empty|Empty}.
|
245
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
|
250
246
|
* for more details and examples.
|
251
247
|
* @example <caption>include:samples/generated/v1/document_service.delete_document.js</caption>
|
252
248
|
* region_tag:discoveryengine_v1_generated_DocumentService_DeleteDocument_async
|
@@ -260,11 +256,11 @@ export declare class DocumentServiceClient {
|
|
260
256
|
deleteDocument(request: protos.google.cloud.discoveryengine.v1.IDeleteDocumentRequest, callback: Callback<protos.google.protobuf.IEmpty, protos.google.cloud.discoveryengine.v1.IDeleteDocumentRequest | null | undefined, {} | null | undefined>): void;
|
261
257
|
/**
|
262
258
|
* Bulk import of multiple
|
263
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document}s. Request processing
|
259
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}s. Request processing
|
264
260
|
* may be synchronous. Non-existing items will be created.
|
265
261
|
*
|
266
262
|
* Note: It is possible for a subset of the
|
267
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document}s to be successfully
|
263
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}s to be successfully
|
268
264
|
* updated.
|
269
265
|
*
|
270
266
|
* @param {Object} request
|
@@ -284,52 +280,52 @@ export declare class DocumentServiceClient {
|
|
284
280
|
* @param {google.cloud.discoveryengine.v1.ImportDocumentsRequest.ReconciliationMode} request.reconciliationMode
|
285
281
|
* The mode of reconciliation between existing documents and the documents to
|
286
282
|
* be imported. Defaults to
|
287
|
-
* {@link google.cloud.discoveryengine.v1.ImportDocumentsRequest.ReconciliationMode.INCREMENTAL|ReconciliationMode.INCREMENTAL}.
|
283
|
+
* {@link protos.google.cloud.discoveryengine.v1.ImportDocumentsRequest.ReconciliationMode.INCREMENTAL|ReconciliationMode.INCREMENTAL}.
|
288
284
|
* @param {boolean} request.autoGenerateIds
|
289
285
|
* Whether to automatically generate IDs for the documents if absent.
|
290
286
|
*
|
291
287
|
* If set to `true`,
|
292
|
-
* {@link google.cloud.discoveryengine.v1.Document.id|Document.id}s are
|
288
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document.id|Document.id}s are
|
293
289
|
* automatically generated based on the hash of the payload, where IDs may not
|
294
290
|
* be consistent during multiple imports. In which case
|
295
|
-
* {@link google.cloud.discoveryengine.v1.ImportDocumentsRequest.ReconciliationMode.FULL|ReconciliationMode.FULL}
|
291
|
+
* {@link protos.google.cloud.discoveryengine.v1.ImportDocumentsRequest.ReconciliationMode.FULL|ReconciliationMode.FULL}
|
296
292
|
* is highly recommended to avoid duplicate contents. If unset or set to
|
297
|
-
* `false`, {@link google.cloud.discoveryengine.v1.Document.id|Document.id}s have
|
293
|
+
* `false`, {@link protos.google.cloud.discoveryengine.v1.Document.id|Document.id}s have
|
298
294
|
* to be specified using
|
299
|
-
* {@link google.cloud.discoveryengine.v1.ImportDocumentsRequest.id_field|id_field},
|
295
|
+
* {@link protos.google.cloud.discoveryengine.v1.ImportDocumentsRequest.id_field|id_field},
|
300
296
|
* otherwises, documents without IDs will fail to be imported.
|
301
297
|
*
|
302
298
|
* Only set this field when using
|
303
|
-
* {@link google.cloud.discoveryengine.v1.GcsSource|GcsSource} or
|
304
|
-
* {@link google.cloud.discoveryengine.v1.BigQuerySource|BigQuerySource}, and when
|
305
|
-
* {@link google.cloud.discoveryengine.v1.GcsSource.data_schema|GcsSource.data_schema}
|
299
|
+
* {@link protos.google.cloud.discoveryengine.v1.GcsSource|GcsSource} or
|
300
|
+
* {@link protos.google.cloud.discoveryengine.v1.BigQuerySource|BigQuerySource}, and when
|
301
|
+
* {@link protos.google.cloud.discoveryengine.v1.GcsSource.data_schema|GcsSource.data_schema}
|
306
302
|
* or
|
307
|
-
* {@link google.cloud.discoveryengine.v1.BigQuerySource.data_schema|BigQuerySource.data_schema}
|
303
|
+
* {@link protos.google.cloud.discoveryengine.v1.BigQuerySource.data_schema|BigQuerySource.data_schema}
|
308
304
|
* is `custom`. Otherwise, an INVALID_ARGUMENT error is thrown.
|
309
305
|
* @param {string} request.idField
|
310
306
|
* The field in the Cloud Storage and BigQuery sources that indicates the
|
311
307
|
* unique IDs of the documents.
|
312
308
|
*
|
313
|
-
* For {@link google.cloud.discoveryengine.v1.GcsSource|GcsSource} it is the key of
|
309
|
+
* For {@link protos.google.cloud.discoveryengine.v1.GcsSource|GcsSource} it is the key of
|
314
310
|
* the JSON field. For instance, `my_id` for JSON `{"my_id": "some_uuid"}`.
|
315
|
-
* For {@link google.cloud.discoveryengine.v1.BigQuerySource|BigQuerySource} it is
|
311
|
+
* For {@link protos.google.cloud.discoveryengine.v1.BigQuerySource|BigQuerySource} it is
|
316
312
|
* the column name of the BigQuery table where the unique ids are stored.
|
317
313
|
*
|
318
314
|
* The values of the JSON field or the BigQuery column will be used as the
|
319
|
-
* {@link google.cloud.discoveryengine.v1.Document.id|Document.id}s. The JSON field
|
315
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document.id|Document.id}s. The JSON field
|
320
316
|
* or the BigQuery column must be of string type, and the values must be set
|
321
317
|
* as valid strings conform to [RFC-1034](https://tools.ietf.org/html/rfc1034)
|
322
318
|
* with 1-63 characters. Otherwise, documents without valid IDs will fail to
|
323
319
|
* be imported.
|
324
320
|
*
|
325
321
|
* Only set this field when using
|
326
|
-
* {@link google.cloud.discoveryengine.v1.GcsSource|GcsSource} or
|
327
|
-
* {@link google.cloud.discoveryengine.v1.BigQuerySource|BigQuerySource}, and when
|
328
|
-
* {@link google.cloud.discoveryengine.v1.GcsSource.data_schema|GcsSource.data_schema}
|
322
|
+
* {@link protos.google.cloud.discoveryengine.v1.GcsSource|GcsSource} or
|
323
|
+
* {@link protos.google.cloud.discoveryengine.v1.BigQuerySource|BigQuerySource}, and when
|
324
|
+
* {@link protos.google.cloud.discoveryengine.v1.GcsSource.data_schema|GcsSource.data_schema}
|
329
325
|
* or
|
330
|
-
* {@link google.cloud.discoveryengine.v1.BigQuerySource.data_schema|BigQuerySource.data_schema}
|
326
|
+
* {@link protos.google.cloud.discoveryengine.v1.BigQuerySource.data_schema|BigQuerySource.data_schema}
|
331
327
|
* is `custom`. And only set this field when
|
332
|
-
* {@link google.cloud.discoveryengine.v1.ImportDocumentsRequest.auto_generate_ids|auto_generate_ids}
|
328
|
+
* {@link protos.google.cloud.discoveryengine.v1.ImportDocumentsRequest.auto_generate_ids|auto_generate_ids}
|
333
329
|
* is unset or set as `false`. Otherwise, an INVALID_ARGUMENT error is thrown.
|
334
330
|
*
|
335
331
|
* If it is unset, a default value `_id` is used when importing from the
|
@@ -340,8 +336,7 @@ export declare class DocumentServiceClient {
|
|
340
336
|
* The first element of the array is an object representing
|
341
337
|
* a long running operation. Its `promise()` method returns a promise
|
342
338
|
* you can `await` for.
|
343
|
-
* Please see the
|
344
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
|
339
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
345
340
|
* for more details and examples.
|
346
341
|
* @example <caption>include:samples/generated/v1/document_service.import_documents.js</caption>
|
347
342
|
* region_tag:discoveryengine_v1_generated_DocumentService_ImportDocuments_async
|
@@ -359,8 +354,7 @@ export declare class DocumentServiceClient {
|
|
359
354
|
* The operation name that will be passed.
|
360
355
|
* @returns {Promise} - The promise which resolves to an object.
|
361
356
|
* The decoded operation object has result and metadata field to get information from.
|
362
|
-
* Please see the
|
363
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
|
357
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
364
358
|
* for more details and examples.
|
365
359
|
* @example <caption>include:samples/generated/v1/document_service.import_documents.js</caption>
|
366
360
|
* region_tag:discoveryengine_v1_generated_DocumentService_ImportDocuments_async
|
@@ -368,20 +362,20 @@ export declare class DocumentServiceClient {
|
|
368
362
|
checkImportDocumentsProgress(name: string): Promise<LROperation<protos.google.cloud.discoveryengine.v1.ImportDocumentsResponse, protos.google.cloud.discoveryengine.v1.ImportDocumentsMetadata>>;
|
369
363
|
/**
|
370
364
|
* Permanently deletes all selected
|
371
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document}s in a branch.
|
365
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}s in a branch.
|
372
366
|
*
|
373
367
|
* This process is asynchronous. Depending on the number of
|
374
|
-
* {@link google.cloud.discoveryengine.v1.Document|Document}s to be deleted, this
|
368
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}s to be deleted, this
|
375
369
|
* operation can take hours to complete. Before the delete operation
|
376
|
-
* completes, some {@link google.cloud.discoveryengine.v1.Document|Document}s might
|
370
|
+
* completes, some {@link protos.google.cloud.discoveryengine.v1.Document|Document}s might
|
377
371
|
* still be returned by
|
378
|
-
* {@link google.cloud.discoveryengine.v1.DocumentService.GetDocument|DocumentService.GetDocument}
|
372
|
+
* {@link protos.google.cloud.discoveryengine.v1.DocumentService.GetDocument|DocumentService.GetDocument}
|
379
373
|
* or
|
380
|
-
* {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}.
|
374
|
+
* {@link protos.google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}.
|
381
375
|
*
|
382
|
-
* To get a list of the {@link google.cloud.discoveryengine.v1.Document|Document}s
|
376
|
+
* To get a list of the {@link protos.google.cloud.discoveryengine.v1.Document|Document}s
|
383
377
|
* to be deleted, set
|
384
|
-
* {@link google.cloud.discoveryengine.v1.PurgeDocumentsRequest.force|PurgeDocumentsRequest.force}
|
378
|
+
* {@link protos.google.cloud.discoveryengine.v1.PurgeDocumentsRequest.force|PurgeDocumentsRequest.force}
|
385
379
|
* to false.
|
386
380
|
*
|
387
381
|
* @param {Object} request
|
@@ -402,8 +396,7 @@ export declare class DocumentServiceClient {
|
|
402
396
|
* The first element of the array is an object representing
|
403
397
|
* a long running operation. Its `promise()` method returns a promise
|
404
398
|
* you can `await` for.
|
405
|
-
* Please see the
|
406
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
|
399
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
407
400
|
* for more details and examples.
|
408
401
|
* @example <caption>include:samples/generated/v1/document_service.purge_documents.js</caption>
|
409
402
|
* region_tag:discoveryengine_v1_generated_DocumentService_PurgeDocuments_async
|
@@ -421,15 +414,14 @@ export declare class DocumentServiceClient {
|
|
421
414
|
* The operation name that will be passed.
|
422
415
|
* @returns {Promise} - The promise which resolves to an object.
|
423
416
|
* The decoded operation object has result and metadata field to get information from.
|
424
|
-
* Please see the
|
425
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
|
417
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
426
418
|
* for more details and examples.
|
427
419
|
* @example <caption>include:samples/generated/v1/document_service.purge_documents.js</caption>
|
428
420
|
* region_tag:discoveryengine_v1_generated_DocumentService_PurgeDocuments_async
|
429
421
|
*/
|
430
422
|
checkPurgeDocumentsProgress(name: string): Promise<LROperation<protos.google.cloud.discoveryengine.v1.PurgeDocumentsResponse, protos.google.cloud.discoveryengine.v1.PurgeDocumentsMetadata>>;
|
431
423
|
/**
|
432
|
-
* Gets a list of {@link google.cloud.discoveryengine.v1.Document|Document}s.
|
424
|
+
* Gets a list of {@link protos.google.cloud.discoveryengine.v1.Document|Document}s.
|
433
425
|
*
|
434
426
|
* @param {Object} request
|
435
427
|
* The request object that will be sent.
|
@@ -439,37 +431,36 @@ export declare class DocumentServiceClient {
|
|
439
431
|
* Use `default_branch` as the branch ID, to list documents under the default
|
440
432
|
* branch.
|
441
433
|
*
|
442
|
-
* If the caller does not have permission to list {@link
|
434
|
+
* If the caller does not have permission to list {@link protos.|Documents}s under this
|
443
435
|
* branch, regardless of whether or not this branch exists, a
|
444
436
|
* `PERMISSION_DENIED` error is returned.
|
445
437
|
* @param {number} request.pageSize
|
446
|
-
* Maximum number of {@link google.cloud.discoveryengine.v1.Document|Document}s to
|
438
|
+
* Maximum number of {@link protos.google.cloud.discoveryengine.v1.Document|Document}s to
|
447
439
|
* return. If unspecified, defaults to 100. The maximum allowed value is 1000.
|
448
440
|
* Values above 1000 will be coerced to 1000.
|
449
441
|
*
|
450
442
|
* If this field is negative, an `INVALID_ARGUMENT` error is returned.
|
451
443
|
* @param {string} request.pageToken
|
452
444
|
* A page token
|
453
|
-
* {@link google.cloud.discoveryengine.v1.ListDocumentsResponse.next_page_token|ListDocumentsResponse.next_page_token},
|
445
|
+
* {@link protos.google.cloud.discoveryengine.v1.ListDocumentsResponse.next_page_token|ListDocumentsResponse.next_page_token},
|
454
446
|
* received from a previous
|
455
|
-
* {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
447
|
+
* {@link protos.google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
456
448
|
* call. Provide this to retrieve the subsequent page.
|
457
449
|
*
|
458
450
|
* When paginating, all other parameters provided to
|
459
|
-
* {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
451
|
+
* {@link protos.google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
460
452
|
* must match the call that provided the page token. Otherwise, an
|
461
453
|
* `INVALID_ARGUMENT` error is returned.
|
462
454
|
* @param {object} [options]
|
463
455
|
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
464
456
|
* @returns {Promise} - The promise which resolves to an array.
|
465
|
-
* The first element of the array is Array of {@link google.cloud.discoveryengine.v1.Document
|
457
|
+
* The first element of the array is Array of {@link protos.google.cloud.discoveryengine.v1.Document|Document}.
|
466
458
|
* The client library will perform auto-pagination by default: it will call the API as many
|
467
459
|
* times as needed and will merge results from all the pages into this array.
|
468
460
|
* Note that it can affect your quota.
|
469
461
|
* We recommend using `listDocumentsAsync()`
|
470
462
|
* method described below for async iteration which you can stop as needed.
|
471
|
-
* Please see the
|
472
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
|
463
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
|
473
464
|
* for more details and examples.
|
474
465
|
*/
|
475
466
|
listDocuments(request?: protos.google.cloud.discoveryengine.v1.IListDocumentsRequest, options?: CallOptions): Promise<[
|
@@ -489,36 +480,35 @@ export declare class DocumentServiceClient {
|
|
489
480
|
* Use `default_branch` as the branch ID, to list documents under the default
|
490
481
|
* branch.
|
491
482
|
*
|
492
|
-
* If the caller does not have permission to list {@link
|
483
|
+
* If the caller does not have permission to list {@link protos.|Documents}s under this
|
493
484
|
* branch, regardless of whether or not this branch exists, a
|
494
485
|
* `PERMISSION_DENIED` error is returned.
|
495
486
|
* @param {number} request.pageSize
|
496
|
-
* Maximum number of {@link google.cloud.discoveryengine.v1.Document|Document}s to
|
487
|
+
* Maximum number of {@link protos.google.cloud.discoveryengine.v1.Document|Document}s to
|
497
488
|
* return. If unspecified, defaults to 100. The maximum allowed value is 1000.
|
498
489
|
* Values above 1000 will be coerced to 1000.
|
499
490
|
*
|
500
491
|
* If this field is negative, an `INVALID_ARGUMENT` error is returned.
|
501
492
|
* @param {string} request.pageToken
|
502
493
|
* A page token
|
503
|
-
* {@link google.cloud.discoveryengine.v1.ListDocumentsResponse.next_page_token|ListDocumentsResponse.next_page_token},
|
494
|
+
* {@link protos.google.cloud.discoveryengine.v1.ListDocumentsResponse.next_page_token|ListDocumentsResponse.next_page_token},
|
504
495
|
* received from a previous
|
505
|
-
* {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
496
|
+
* {@link protos.google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
506
497
|
* call. Provide this to retrieve the subsequent page.
|
507
498
|
*
|
508
499
|
* When paginating, all other parameters provided to
|
509
|
-
* {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
500
|
+
* {@link protos.google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
510
501
|
* must match the call that provided the page token. Otherwise, an
|
511
502
|
* `INVALID_ARGUMENT` error is returned.
|
512
503
|
* @param {object} [options]
|
513
504
|
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
514
505
|
* @returns {Stream}
|
515
|
-
* An object stream which emits an object representing {@link google.cloud.discoveryengine.v1.Document
|
506
|
+
* An object stream which emits an object representing {@link protos.google.cloud.discoveryengine.v1.Document|Document} on 'data' event.
|
516
507
|
* The client library will perform auto-pagination by default: it will call the API as many
|
517
508
|
* times as needed. Note that it can affect your quota.
|
518
509
|
* We recommend using `listDocumentsAsync()`
|
519
510
|
* method described below for async iteration which you can stop as needed.
|
520
|
-
* Please see the
|
521
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
|
511
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
|
522
512
|
* for more details and examples.
|
523
513
|
*/
|
524
514
|
listDocumentsStream(request?: protos.google.cloud.discoveryengine.v1.IListDocumentsRequest, options?: CallOptions): Transform;
|
@@ -534,35 +524,34 @@ export declare class DocumentServiceClient {
|
|
534
524
|
* Use `default_branch` as the branch ID, to list documents under the default
|
535
525
|
* branch.
|
536
526
|
*
|
537
|
-
* If the caller does not have permission to list {@link
|
527
|
+
* If the caller does not have permission to list {@link protos.|Documents}s under this
|
538
528
|
* branch, regardless of whether or not this branch exists, a
|
539
529
|
* `PERMISSION_DENIED` error is returned.
|
540
530
|
* @param {number} request.pageSize
|
541
|
-
* Maximum number of {@link google.cloud.discoveryengine.v1.Document|Document}s to
|
531
|
+
* Maximum number of {@link protos.google.cloud.discoveryengine.v1.Document|Document}s to
|
542
532
|
* return. If unspecified, defaults to 100. The maximum allowed value is 1000.
|
543
533
|
* Values above 1000 will be coerced to 1000.
|
544
534
|
*
|
545
535
|
* If this field is negative, an `INVALID_ARGUMENT` error is returned.
|
546
536
|
* @param {string} request.pageToken
|
547
537
|
* A page token
|
548
|
-
* {@link google.cloud.discoveryengine.v1.ListDocumentsResponse.next_page_token|ListDocumentsResponse.next_page_token},
|
538
|
+
* {@link protos.google.cloud.discoveryengine.v1.ListDocumentsResponse.next_page_token|ListDocumentsResponse.next_page_token},
|
549
539
|
* received from a previous
|
550
|
-
* {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
540
|
+
* {@link protos.google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
551
541
|
* call. Provide this to retrieve the subsequent page.
|
552
542
|
*
|
553
543
|
* When paginating, all other parameters provided to
|
554
|
-
* {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
544
|
+
* {@link protos.google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
555
545
|
* must match the call that provided the page token. Otherwise, an
|
556
546
|
* `INVALID_ARGUMENT` error is returned.
|
557
547
|
* @param {object} [options]
|
558
548
|
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
559
549
|
* @returns {Object}
|
560
|
-
* An iterable Object that allows
|
550
|
+
* An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
|
561
551
|
* When you iterate the returned iterable, each element will be an object representing
|
562
|
-
* {@link google.cloud.discoveryengine.v1.Document
|
552
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}. The API will be called under the hood as needed, once per the page,
|
563
553
|
* so you can stop the iteration when you don't need more results.
|
564
|
-
* Please see the
|
565
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
|
554
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
|
566
555
|
* for more details and examples.
|
567
556
|
* @example <caption>include:samples/generated/v1/document_service.list_documents.js</caption>
|
568
557
|
* region_tag:discoveryengine_v1_generated_DocumentService_ListDocuments_async
|
@@ -27,7 +27,7 @@ const jsonProtos = require("../../protos/protos.json");
|
|
27
27
|
const gapicConfig = require("./document_service_client_config.json");
|
28
28
|
const version = require('../../../package.json').version;
|
29
29
|
/**
|
30
|
-
* Service for ingesting {@link google.cloud.discoveryengine.v1.Document|Document}
|
30
|
+
* Service for ingesting {@link protos.google.cloud.discoveryengine.v1.Document|Document}
|
31
31
|
* information of the customer's website.
|
32
32
|
* @class
|
33
33
|
* @memberof v1
|
@@ -448,8 +448,7 @@ class DocumentServiceClient {
|
|
448
448
|
* The operation name that will be passed.
|
449
449
|
* @returns {Promise} - The promise which resolves to an object.
|
450
450
|
* The decoded operation object has result and metadata field to get information from.
|
451
|
-
* Please see the
|
452
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
|
451
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
453
452
|
* for more details and examples.
|
454
453
|
* @example <caption>include:samples/generated/v1/document_service.import_documents.js</caption>
|
455
454
|
* region_tag:discoveryengine_v1_generated_DocumentService_ImportDocuments_async
|
@@ -487,8 +486,7 @@ class DocumentServiceClient {
|
|
487
486
|
* The operation name that will be passed.
|
488
487
|
* @returns {Promise} - The promise which resolves to an object.
|
489
488
|
* The decoded operation object has result and metadata field to get information from.
|
490
|
-
* Please see the
|
491
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
|
489
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
|
492
490
|
* for more details and examples.
|
493
491
|
* @example <caption>include:samples/generated/v1/document_service.purge_documents.js</caption>
|
494
492
|
* region_tag:discoveryengine_v1_generated_DocumentService_PurgeDocuments_async
|
@@ -530,36 +528,35 @@ class DocumentServiceClient {
|
|
530
528
|
* Use `default_branch` as the branch ID, to list documents under the default
|
531
529
|
* branch.
|
532
530
|
*
|
533
|
-
* If the caller does not have permission to list {@link
|
531
|
+
* If the caller does not have permission to list {@link protos.|Documents}s under this
|
534
532
|
* branch, regardless of whether or not this branch exists, a
|
535
533
|
* `PERMISSION_DENIED` error is returned.
|
536
534
|
* @param {number} request.pageSize
|
537
|
-
* Maximum number of {@link google.cloud.discoveryengine.v1.Document|Document}s to
|
535
|
+
* Maximum number of {@link protos.google.cloud.discoveryengine.v1.Document|Document}s to
|
538
536
|
* return. If unspecified, defaults to 100. The maximum allowed value is 1000.
|
539
537
|
* Values above 1000 will be coerced to 1000.
|
540
538
|
*
|
541
539
|
* If this field is negative, an `INVALID_ARGUMENT` error is returned.
|
542
540
|
* @param {string} request.pageToken
|
543
541
|
* A page token
|
544
|
-
* {@link google.cloud.discoveryengine.v1.ListDocumentsResponse.next_page_token|ListDocumentsResponse.next_page_token},
|
542
|
+
* {@link protos.google.cloud.discoveryengine.v1.ListDocumentsResponse.next_page_token|ListDocumentsResponse.next_page_token},
|
545
543
|
* received from a previous
|
546
|
-
* {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
544
|
+
* {@link protos.google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
547
545
|
* call. Provide this to retrieve the subsequent page.
|
548
546
|
*
|
549
547
|
* When paginating, all other parameters provided to
|
550
|
-
* {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
548
|
+
* {@link protos.google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
551
549
|
* must match the call that provided the page token. Otherwise, an
|
552
550
|
* `INVALID_ARGUMENT` error is returned.
|
553
551
|
* @param {object} [options]
|
554
552
|
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
555
553
|
* @returns {Stream}
|
556
|
-
* An object stream which emits an object representing {@link google.cloud.discoveryengine.v1.Document
|
554
|
+
* An object stream which emits an object representing {@link protos.google.cloud.discoveryengine.v1.Document|Document} on 'data' event.
|
557
555
|
* The client library will perform auto-pagination by default: it will call the API as many
|
558
556
|
* times as needed. Note that it can affect your quota.
|
559
557
|
* We recommend using `listDocumentsAsync()`
|
560
558
|
* method described below for async iteration which you can stop as needed.
|
561
|
-
* Please see the
|
562
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
|
559
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
|
563
560
|
* for more details and examples.
|
564
561
|
*/
|
565
562
|
listDocumentsStream(request, options) {
|
@@ -589,35 +586,34 @@ class DocumentServiceClient {
|
|
589
586
|
* Use `default_branch` as the branch ID, to list documents under the default
|
590
587
|
* branch.
|
591
588
|
*
|
592
|
-
* If the caller does not have permission to list {@link
|
589
|
+
* If the caller does not have permission to list {@link protos.|Documents}s under this
|
593
590
|
* branch, regardless of whether or not this branch exists, a
|
594
591
|
* `PERMISSION_DENIED` error is returned.
|
595
592
|
* @param {number} request.pageSize
|
596
|
-
* Maximum number of {@link google.cloud.discoveryengine.v1.Document|Document}s to
|
593
|
+
* Maximum number of {@link protos.google.cloud.discoveryengine.v1.Document|Document}s to
|
597
594
|
* return. If unspecified, defaults to 100. The maximum allowed value is 1000.
|
598
595
|
* Values above 1000 will be coerced to 1000.
|
599
596
|
*
|
600
597
|
* If this field is negative, an `INVALID_ARGUMENT` error is returned.
|
601
598
|
* @param {string} request.pageToken
|
602
599
|
* A page token
|
603
|
-
* {@link google.cloud.discoveryengine.v1.ListDocumentsResponse.next_page_token|ListDocumentsResponse.next_page_token},
|
600
|
+
* {@link protos.google.cloud.discoveryengine.v1.ListDocumentsResponse.next_page_token|ListDocumentsResponse.next_page_token},
|
604
601
|
* received from a previous
|
605
|
-
* {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
602
|
+
* {@link protos.google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
606
603
|
* call. Provide this to retrieve the subsequent page.
|
607
604
|
*
|
608
605
|
* When paginating, all other parameters provided to
|
609
|
-
* {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
606
|
+
* {@link protos.google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
|
610
607
|
* must match the call that provided the page token. Otherwise, an
|
611
608
|
* `INVALID_ARGUMENT` error is returned.
|
612
609
|
* @param {object} [options]
|
613
610
|
* Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
|
614
611
|
* @returns {Object}
|
615
|
-
* An iterable Object that allows
|
612
|
+
* An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
|
616
613
|
* When you iterate the returned iterable, each element will be an object representing
|
617
|
-
* {@link google.cloud.discoveryengine.v1.Document
|
614
|
+
* {@link protos.google.cloud.discoveryengine.v1.Document|Document}. The API will be called under the hood as needed, once per the page,
|
618
615
|
* so you can stop the iteration when you don't need more results.
|
619
|
-
* Please see the
|
620
|
-
* [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
|
616
|
+
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
|
621
617
|
* for more details and examples.
|
622
618
|
* @example <caption>include:samples/generated/v1/document_service.list_documents.js</caption>
|
623
619
|
* region_tag:discoveryengine_v1_generated_DocumentService_ListDocuments_async
|