@google-cloud/discoveryengine 0.6.0 → 0.7.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 (44) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/README.md +38 -22
  3. package/build/protos/google/cloud/discoveryengine/v1/common.proto +100 -0
  4. package/build/protos/google/cloud/discoveryengine/v1/completion_service.proto +116 -0
  5. package/build/protos/google/cloud/discoveryengine/v1/document.proto +118 -0
  6. package/build/protos/google/cloud/discoveryengine/v1/document_service.proto +313 -0
  7. package/build/protos/google/cloud/discoveryengine/v1/import_config.proto +334 -0
  8. package/build/protos/google/cloud/discoveryengine/v1/purge_config.proto +86 -0
  9. package/build/protos/google/cloud/discoveryengine/v1/schema.proto +58 -0
  10. package/build/protos/google/cloud/discoveryengine/v1/schema_service.proto +256 -0
  11. package/build/protos/google/cloud/discoveryengine/v1/search_service.proto +289 -0
  12. package/build/protos/google/cloud/discoveryengine/v1/user_event.proto +458 -0
  13. package/build/protos/google/cloud/discoveryengine/v1/user_event_service.proto +133 -0
  14. package/build/protos/google/cloud/discoveryengine/v1beta/import_config.proto +54 -0
  15. package/build/protos/google/cloud/discoveryengine/v1beta/search_service.proto +29 -4
  16. package/build/protos/protos.d.ts +6589 -0
  17. package/build/protos/protos.js +16050 -1
  18. package/build/protos/protos.json +1807 -0
  19. package/build/src/index.d.ts +18 -19
  20. package/build/src/index.js +9 -9
  21. package/build/src/v1/completion_service_client.d.ts +455 -0
  22. package/build/src/v1/completion_service_client.js +659 -0
  23. package/build/src/v1/completion_service_client_config.json +43 -0
  24. package/build/src/v1/document_service_client.d.ts +995 -0
  25. package/build/src/v1/document_service_client.js +1191 -0
  26. package/build/src/v1/document_service_client_config.json +82 -0
  27. package/build/src/v1/index.d.ts +5 -0
  28. package/build/src/v1/index.js +31 -0
  29. package/build/src/v1/schema_service_client.d.ts +795 -0
  30. package/build/src/v1/schema_service_client.js +1129 -0
  31. package/build/src/v1/schema_service_client_config.json +63 -0
  32. package/build/src/v1/search_service_client.d.ts +857 -0
  33. package/build/src/v1/search_service_client.js +1073 -0
  34. package/build/src/v1/search_service_client_config.json +43 -0
  35. package/build/src/v1/user_event_service_client.d.ts +638 -0
  36. package/build/src/v1/user_event_service_client.js +933 -0
  37. package/build/src/v1/user_event_service_client_config.json +62 -0
  38. package/build/src/v1beta/document_service_client.d.ts +52 -0
  39. package/build/src/v1beta/document_service_client.js +6 -0
  40. package/build/src/v1beta/schema_service_client.js +6 -0
  41. package/build/src/v1beta/search_service_client.d.ts +78 -12
  42. package/build/src/v1beta/search_service_client.js +52 -8
  43. package/build/src/v1beta/user_event_service_client.js +6 -0
  44. package/package.json +2 -2
@@ -0,0 +1,995 @@
1
+ /// <reference types="node" />
2
+ import type * as gax from 'google-gax';
3
+ import type { Callback, CallOptions, Descriptors, ClientOptions, LROperation, PaginationCallback } from 'google-gax';
4
+ import { Transform } from 'stream';
5
+ import * as protos from '../../protos/protos';
6
+ /**
7
+ * Service for ingesting {@link google.cloud.discoveryengine.v1.Document|Document}
8
+ * information of the customer's website.
9
+ * @class
10
+ * @memberof v1
11
+ */
12
+ export declare class DocumentServiceClient {
13
+ private _terminated;
14
+ private _opts;
15
+ private _providedCustomServicePath;
16
+ private _gaxModule;
17
+ private _gaxGrpc;
18
+ private _protos;
19
+ private _defaults;
20
+ auth: gax.GoogleAuth;
21
+ descriptors: Descriptors;
22
+ warn: (code: string, message: string, warnType?: string) => void;
23
+ innerApiCalls: {
24
+ [name: string]: Function;
25
+ };
26
+ pathTemplates: {
27
+ [name: string]: gax.PathTemplate;
28
+ };
29
+ operationsClient: gax.OperationsClient;
30
+ documentServiceStub?: Promise<{
31
+ [name: string]: Function;
32
+ }>;
33
+ /**
34
+ * Construct an instance of DocumentServiceClient.
35
+ *
36
+ * @param {object} [options] - The configuration object.
37
+ * The options accepted by the constructor are described in detail
38
+ * in [this document](https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#creating-the-client-instance).
39
+ * The common options are:
40
+ * @param {object} [options.credentials] - Credentials object.
41
+ * @param {string} [options.credentials.client_email]
42
+ * @param {string} [options.credentials.private_key]
43
+ * @param {string} [options.email] - Account email address. Required when
44
+ * using a .pem or .p12 keyFilename.
45
+ * @param {string} [options.keyFilename] - Full path to the a .json, .pem, or
46
+ * .p12 key downloaded from the Google Developers Console. If you provide
47
+ * a path to a JSON file, the projectId option below is not necessary.
48
+ * NOTE: .pem and .p12 require you to specify options.email as well.
49
+ * @param {number} [options.port] - The port on which to connect to
50
+ * the remote host.
51
+ * @param {string} [options.projectId] - The project ID from the Google
52
+ * Developer's Console, e.g. 'grape-spaceship-123'. We will also check
53
+ * the environment variable GCLOUD_PROJECT for your project ID. If your
54
+ * app is running in an environment which supports
55
+ * {@link https://developers.google.com/identity/protocols/application-default-credentials Application Default Credentials},
56
+ * your project ID will be detected automatically.
57
+ * @param {string} [options.apiEndpoint] - The domain name of the
58
+ * API remote host.
59
+ * @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
60
+ * Follows the structure of {@link gapicConfig}.
61
+ * @param {boolean | "rest"} [options.fallback] - Use HTTP fallback mode.
62
+ * Pass "rest" to use HTTP/1.1 REST API instead of gRPC.
63
+ * For more information, please check the
64
+ * {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
65
+ * @param {gax} [gaxInstance]: loaded instance of `google-gax`. Useful if you
66
+ * need to avoid loading the default gRPC version and want to use the fallback
67
+ * HTTP implementation. Load only fallback version and pass it to the constructor:
68
+ * ```
69
+ * const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC
70
+ * const client = new DocumentServiceClient({fallback: 'rest'}, gax);
71
+ * ```
72
+ */
73
+ constructor(opts?: ClientOptions, gaxInstance?: typeof gax | typeof gax.fallback);
74
+ /**
75
+ * Initialize the client.
76
+ * Performs asynchronous operations (such as authentication) and prepares the client.
77
+ * This function will be called automatically when any class method is called for the
78
+ * first time, but if you need to initialize it before calling an actual method,
79
+ * feel free to call initialize() directly.
80
+ *
81
+ * You can await on this method if you want to make sure the client is initialized.
82
+ *
83
+ * @returns {Promise} A promise that resolves to an authenticated service stub.
84
+ */
85
+ initialize(): Promise<{
86
+ [name: string]: Function;
87
+ }>;
88
+ /**
89
+ * The DNS address for this API service.
90
+ * @returns {string} The DNS address for this service.
91
+ */
92
+ static get servicePath(): string;
93
+ /**
94
+ * The DNS address for this API service - same as servicePath(),
95
+ * exists for compatibility reasons.
96
+ * @returns {string} The DNS address for this service.
97
+ */
98
+ static get apiEndpoint(): string;
99
+ /**
100
+ * The port for this API service.
101
+ * @returns {number} The default port for this service.
102
+ */
103
+ static get port(): number;
104
+ /**
105
+ * The scopes needed to make gRPC calls for every method defined
106
+ * in this service.
107
+ * @returns {string[]} List of default scopes.
108
+ */
109
+ static get scopes(): string[];
110
+ getProjectId(): Promise<string>;
111
+ getProjectId(callback: Callback<string, undefined, undefined>): void;
112
+ /**
113
+ * Gets a {@link google.cloud.discoveryengine.v1.Document|Document}.
114
+ *
115
+ * @param {Object} request
116
+ * The request object that will be sent.
117
+ * @param {string} request.name
118
+ * Required. Full resource name of
119
+ * {@link google.cloud.discoveryengine.v1.Document|Document}, such as
120
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`.
121
+ *
122
+ * If the caller does not have permission to access the
123
+ * {@link google.cloud.discoveryengine.v1.Document|Document}, regardless of whether
124
+ * or not it exists, a `PERMISSION_DENIED` error is returned.
125
+ *
126
+ * If the requested {@link google.cloud.discoveryengine.v1.Document|Document} does
127
+ * not exist, a `NOT_FOUND` error is returned.
128
+ * @param {object} [options]
129
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
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 | Document}.
132
+ * Please see the
133
+ * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
134
+ * for more details and examples.
135
+ * @example <caption>include:samples/generated/v1/document_service.get_document.js</caption>
136
+ * region_tag:discoveryengine_v1_generated_DocumentService_GetDocument_async
137
+ */
138
+ getDocument(request?: protos.google.cloud.discoveryengine.v1.IGetDocumentRequest, options?: CallOptions): Promise<[
139
+ protos.google.cloud.discoveryengine.v1.IDocument,
140
+ protos.google.cloud.discoveryengine.v1.IGetDocumentRequest | undefined,
141
+ {} | undefined
142
+ ]>;
143
+ 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
+ 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
+ /**
146
+ * Creates a {@link google.cloud.discoveryengine.v1.Document|Document}.
147
+ *
148
+ * @param {Object} request
149
+ * The request object that will be sent.
150
+ * @param {string} request.parent
151
+ * Required. The parent resource name, such as
152
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.
153
+ * @param {google.cloud.discoveryengine.v1.Document} request.document
154
+ * Required. The {@link google.cloud.discoveryengine.v1.Document|Document} to
155
+ * create.
156
+ * @param {string} request.documentId
157
+ * Required. The ID to use for the
158
+ * {@link google.cloud.discoveryengine.v1.Document|Document}, which will become the
159
+ * final component of the
160
+ * {@link google.cloud.discoveryengine.v1.Document.name|Document.name}.
161
+ *
162
+ * If the caller does not have permission to create the
163
+ * {@link google.cloud.discoveryengine.v1.Document|Document}, regardless of whether
164
+ * or not it exists, a `PERMISSION_DENIED` error is returned.
165
+ *
166
+ * 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}.
169
+ * Otherwise, an `ALREADY_EXISTS` error is returned.
170
+ *
171
+ * This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034)
172
+ * standard with a length limit of 63 characters. Otherwise, an
173
+ * `INVALID_ARGUMENT` error is returned.
174
+ * @param {object} [options]
175
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
176
+ * @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 | Document}.
178
+ * Please see the
179
+ * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
180
+ * for more details and examples.
181
+ * @example <caption>include:samples/generated/v1/document_service.create_document.js</caption>
182
+ * region_tag:discoveryengine_v1_generated_DocumentService_CreateDocument_async
183
+ */
184
+ createDocument(request?: protos.google.cloud.discoveryengine.v1.ICreateDocumentRequest, options?: CallOptions): Promise<[
185
+ protos.google.cloud.discoveryengine.v1.IDocument,
186
+ protos.google.cloud.discoveryengine.v1.ICreateDocumentRequest | undefined,
187
+ {} | undefined
188
+ ]>;
189
+ 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
+ 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
+ /**
192
+ * Updates a {@link google.cloud.discoveryengine.v1.Document|Document}.
193
+ *
194
+ * @param {Object} request
195
+ * The request object that will be sent.
196
+ * @param {google.cloud.discoveryengine.v1.Document} request.document
197
+ * Required. The document to update/create.
198
+ *
199
+ * If the caller does not have permission to update the
200
+ * {@link google.cloud.discoveryengine.v1.Document|Document}, regardless of whether
201
+ * or not it exists, a `PERMISSION_DENIED` error is returned.
202
+ *
203
+ * If the {@link google.cloud.discoveryengine.v1.Document|Document} to update does
204
+ * not exist and
205
+ * {@link google.cloud.discoveryengine.v1.UpdateDocumentRequest.allow_missing|allow_missing}
206
+ * is not set, a `NOT_FOUND` error is returned.
207
+ * @param {boolean} request.allowMissing
208
+ * 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.
211
+ * @param {object} [options]
212
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
213
+ * @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 | Document}.
215
+ * Please see the
216
+ * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
217
+ * for more details and examples.
218
+ * @example <caption>include:samples/generated/v1/document_service.update_document.js</caption>
219
+ * region_tag:discoveryengine_v1_generated_DocumentService_UpdateDocument_async
220
+ */
221
+ updateDocument(request?: protos.google.cloud.discoveryengine.v1.IUpdateDocumentRequest, options?: CallOptions): Promise<[
222
+ protos.google.cloud.discoveryengine.v1.IDocument,
223
+ protos.google.cloud.discoveryengine.v1.IUpdateDocumentRequest | undefined,
224
+ {} | undefined
225
+ ]>;
226
+ 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
+ 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
+ /**
229
+ * Deletes a {@link google.cloud.discoveryengine.v1.Document|Document}.
230
+ *
231
+ * @param {Object} request
232
+ * The request object that will be sent.
233
+ * @param {string} request.name
234
+ * Required. Full resource name of
235
+ * {@link google.cloud.discoveryengine.v1.Document|Document}, such as
236
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document}`.
237
+ *
238
+ * If the caller does not have permission to delete the
239
+ * {@link google.cloud.discoveryengine.v1.Document|Document}, regardless of whether
240
+ * or not it exists, a `PERMISSION_DENIED` error is returned.
241
+ *
242
+ * If the {@link google.cloud.discoveryengine.v1.Document|Document} to delete does
243
+ * not exist, a `NOT_FOUND` error is returned.
244
+ * @param {object} [options]
245
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
246
+ * @returns {Promise} - The promise which resolves to an array.
247
+ * The first element of the array is an object representing {@link google.protobuf.Empty | Empty}.
248
+ * Please see the
249
+ * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
250
+ * for more details and examples.
251
+ * @example <caption>include:samples/generated/v1/document_service.delete_document.js</caption>
252
+ * region_tag:discoveryengine_v1_generated_DocumentService_DeleteDocument_async
253
+ */
254
+ deleteDocument(request?: protos.google.cloud.discoveryengine.v1.IDeleteDocumentRequest, options?: CallOptions): Promise<[
255
+ protos.google.protobuf.IEmpty,
256
+ protos.google.cloud.discoveryengine.v1.IDeleteDocumentRequest | undefined,
257
+ {} | undefined
258
+ ]>;
259
+ deleteDocument(request: protos.google.cloud.discoveryengine.v1.IDeleteDocumentRequest, options: CallOptions, callback: Callback<protos.google.protobuf.IEmpty, protos.google.cloud.discoveryengine.v1.IDeleteDocumentRequest | null | undefined, {} | null | undefined>): void;
260
+ 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
+ /**
262
+ * Bulk import of multiple
263
+ * {@link google.cloud.discoveryengine.v1.Document|Document}s. Request processing
264
+ * may be synchronous. Non-existing items will be created.
265
+ *
266
+ * Note: It is possible for a subset of the
267
+ * {@link google.cloud.discoveryengine.v1.Document|Document}s to be successfully
268
+ * updated.
269
+ *
270
+ * @param {Object} request
271
+ * The request object that will be sent.
272
+ * @param {google.cloud.discoveryengine.v1.ImportDocumentsRequest.InlineSource} request.inlineSource
273
+ * The Inline source for the input content for documents.
274
+ * @param {google.cloud.discoveryengine.v1.GcsSource} request.gcsSource
275
+ * Cloud Storage location for the input content.
276
+ * @param {google.cloud.discoveryengine.v1.BigQuerySource} request.bigquerySource
277
+ * BigQuery input source.
278
+ * @param {string} request.parent
279
+ * Required. The parent branch resource name, such as
280
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.
281
+ * Requires create/update permission.
282
+ * @param {google.cloud.discoveryengine.v1.ImportErrorConfig} request.errorConfig
283
+ * The desired location of errors incurred during the Import.
284
+ * @param {google.cloud.discoveryengine.v1.ImportDocumentsRequest.ReconciliationMode} request.reconciliationMode
285
+ * The mode of reconciliation between existing documents and the documents to
286
+ * be imported. Defaults to
287
+ * {@link google.cloud.discoveryengine.v1.ImportDocumentsRequest.ReconciliationMode.INCREMENTAL|ReconciliationMode.INCREMENTAL}.
288
+ * @param {boolean} request.autoGenerateIds
289
+ * Whether to automatically generate IDs for the documents if absent.
290
+ *
291
+ * If set to `true`,
292
+ * {@link google.cloud.discoveryengine.v1.Document.id|Document.id}s are
293
+ * automatically generated based on the hash of the payload, where IDs may not
294
+ * be consistent during multiple imports. In which case
295
+ * {@link google.cloud.discoveryengine.v1.ImportDocumentsRequest.ReconciliationMode.FULL|ReconciliationMode.FULL}
296
+ * 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
298
+ * to be specified using
299
+ * {@link google.cloud.discoveryengine.v1.ImportDocumentsRequest.id_field|id_field},
300
+ * otherwises, documents without IDs will fail to be imported.
301
+ *
302
+ * 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}
306
+ * or
307
+ * {@link google.cloud.discoveryengine.v1.BigQuerySource.data_schema|BigQuerySource.data_schema}
308
+ * is `custom`. Otherwise, an INVALID_ARGUMENT error is thrown.
309
+ * @param {string} request.idField
310
+ * The field in the Cloud Storage and BigQuery sources that indicates the
311
+ * unique IDs of the documents.
312
+ *
313
+ * For {@link google.cloud.discoveryengine.v1.GcsSource|GcsSource} it is the key of
314
+ * the JSON field. For instance, `my_id` for JSON `{"my_id": "some_uuid"}`.
315
+ * For {@link google.cloud.discoveryengine.v1.BigQuerySource|BigQuerySource} it is
316
+ * the column name of the BigQuery table where the unique ids are stored.
317
+ *
318
+ * 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
320
+ * or the BigQuery column must be of string type, and the values must be set
321
+ * as valid strings conform to [RFC-1034](https://tools.ietf.org/html/rfc1034)
322
+ * with 1-63 characters. Otherwise, documents without valid IDs will fail to
323
+ * be imported.
324
+ *
325
+ * 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}
329
+ * or
330
+ * {@link google.cloud.discoveryengine.v1.BigQuerySource.data_schema|BigQuerySource.data_schema}
331
+ * is `custom`. And only set this field when
332
+ * {@link google.cloud.discoveryengine.v1.ImportDocumentsRequest.auto_generate_ids|auto_generate_ids}
333
+ * is unset or set as `false`. Otherwise, an INVALID_ARGUMENT error is thrown.
334
+ *
335
+ * If it is unset, a default value `_id` is used when importing from the
336
+ * allowed data sources.
337
+ * @param {object} [options]
338
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
339
+ * @returns {Promise} - The promise which resolves to an array.
340
+ * The first element of the array is an object representing
341
+ * a long running operation. Its `promise()` method returns a promise
342
+ * you can `await` for.
343
+ * Please see the
344
+ * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
345
+ * for more details and examples.
346
+ * @example <caption>include:samples/generated/v1/document_service.import_documents.js</caption>
347
+ * region_tag:discoveryengine_v1_generated_DocumentService_ImportDocuments_async
348
+ */
349
+ importDocuments(request?: protos.google.cloud.discoveryengine.v1.IImportDocumentsRequest, options?: CallOptions): Promise<[
350
+ LROperation<protos.google.cloud.discoveryengine.v1.IImportDocumentsResponse, protos.google.cloud.discoveryengine.v1.IImportDocumentsMetadata>,
351
+ protos.google.longrunning.IOperation | undefined,
352
+ {} | undefined
353
+ ]>;
354
+ importDocuments(request: protos.google.cloud.discoveryengine.v1.IImportDocumentsRequest, options: CallOptions, callback: Callback<LROperation<protos.google.cloud.discoveryengine.v1.IImportDocumentsResponse, protos.google.cloud.discoveryengine.v1.IImportDocumentsMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
355
+ importDocuments(request: protos.google.cloud.discoveryengine.v1.IImportDocumentsRequest, callback: Callback<LROperation<protos.google.cloud.discoveryengine.v1.IImportDocumentsResponse, protos.google.cloud.discoveryengine.v1.IImportDocumentsMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
356
+ /**
357
+ * Check the status of the long running operation returned by `importDocuments()`.
358
+ * @param {String} name
359
+ * The operation name that will be passed.
360
+ * @returns {Promise} - The promise which resolves to an object.
361
+ * 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)
364
+ * for more details and examples.
365
+ * @example <caption>include:samples/generated/v1/document_service.import_documents.js</caption>
366
+ * region_tag:discoveryengine_v1_generated_DocumentService_ImportDocuments_async
367
+ */
368
+ checkImportDocumentsProgress(name: string): Promise<LROperation<protos.google.cloud.discoveryengine.v1.ImportDocumentsResponse, protos.google.cloud.discoveryengine.v1.ImportDocumentsMetadata>>;
369
+ /**
370
+ * Permanently deletes all selected
371
+ * {@link google.cloud.discoveryengine.v1.Document|Document}s in a branch.
372
+ *
373
+ * This process is asynchronous. Depending on the number of
374
+ * {@link google.cloud.discoveryengine.v1.Document|Document}s to be deleted, this
375
+ * operation can take hours to complete. Before the delete operation
376
+ * completes, some {@link google.cloud.discoveryengine.v1.Document|Document}s might
377
+ * still be returned by
378
+ * {@link google.cloud.discoveryengine.v1.DocumentService.GetDocument|DocumentService.GetDocument}
379
+ * or
380
+ * {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}.
381
+ *
382
+ * To get a list of the {@link google.cloud.discoveryengine.v1.Document|Document}s
383
+ * to be deleted, set
384
+ * {@link google.cloud.discoveryengine.v1.PurgeDocumentsRequest.force|PurgeDocumentsRequest.force}
385
+ * to false.
386
+ *
387
+ * @param {Object} request
388
+ * The request object that will be sent.
389
+ * @param {string} request.parent
390
+ * Required. The parent resource name, such as
391
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.
392
+ * @param {string} request.filter
393
+ * Required. Filter matching documents to purge. Only currently supported
394
+ * value is
395
+ * `*` (all items).
396
+ * @param {boolean} request.force
397
+ * Actually performs the purge. If `force` is set to false, return the
398
+ * expected purge count without deleting any documents.
399
+ * @param {object} [options]
400
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
401
+ * @returns {Promise} - The promise which resolves to an array.
402
+ * The first element of the array is an object representing
403
+ * a long running operation. Its `promise()` method returns a promise
404
+ * you can `await` for.
405
+ * Please see the
406
+ * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
407
+ * for more details and examples.
408
+ * @example <caption>include:samples/generated/v1/document_service.purge_documents.js</caption>
409
+ * region_tag:discoveryengine_v1_generated_DocumentService_PurgeDocuments_async
410
+ */
411
+ purgeDocuments(request?: protos.google.cloud.discoveryengine.v1.IPurgeDocumentsRequest, options?: CallOptions): Promise<[
412
+ LROperation<protos.google.cloud.discoveryengine.v1.IPurgeDocumentsResponse, protos.google.cloud.discoveryengine.v1.IPurgeDocumentsMetadata>,
413
+ protos.google.longrunning.IOperation | undefined,
414
+ {} | undefined
415
+ ]>;
416
+ purgeDocuments(request: protos.google.cloud.discoveryengine.v1.IPurgeDocumentsRequest, options: CallOptions, callback: Callback<LROperation<protos.google.cloud.discoveryengine.v1.IPurgeDocumentsResponse, protos.google.cloud.discoveryengine.v1.IPurgeDocumentsMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
417
+ purgeDocuments(request: protos.google.cloud.discoveryengine.v1.IPurgeDocumentsRequest, callback: Callback<LROperation<protos.google.cloud.discoveryengine.v1.IPurgeDocumentsResponse, protos.google.cloud.discoveryengine.v1.IPurgeDocumentsMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
418
+ /**
419
+ * Check the status of the long running operation returned by `purgeDocuments()`.
420
+ * @param {String} name
421
+ * The operation name that will be passed.
422
+ * @returns {Promise} - The promise which resolves to an object.
423
+ * 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)
426
+ * for more details and examples.
427
+ * @example <caption>include:samples/generated/v1/document_service.purge_documents.js</caption>
428
+ * region_tag:discoveryengine_v1_generated_DocumentService_PurgeDocuments_async
429
+ */
430
+ checkPurgeDocumentsProgress(name: string): Promise<LROperation<protos.google.cloud.discoveryengine.v1.PurgeDocumentsResponse, protos.google.cloud.discoveryengine.v1.PurgeDocumentsMetadata>>;
431
+ /**
432
+ * Gets a list of {@link google.cloud.discoveryengine.v1.Document|Document}s.
433
+ *
434
+ * @param {Object} request
435
+ * The request object that will be sent.
436
+ * @param {string} request.parent
437
+ * Required. The parent branch resource name, such as
438
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.
439
+ * Use `default_branch` as the branch ID, to list documents under the default
440
+ * branch.
441
+ *
442
+ * If the caller does not have permission to list {@link |Documents}s under this
443
+ * branch, regardless of whether or not this branch exists, a
444
+ * `PERMISSION_DENIED` error is returned.
445
+ * @param {number} request.pageSize
446
+ * Maximum number of {@link google.cloud.discoveryengine.v1.Document|Document}s to
447
+ * return. If unspecified, defaults to 100. The maximum allowed value is 1000.
448
+ * Values above 1000 will be coerced to 1000.
449
+ *
450
+ * If this field is negative, an `INVALID_ARGUMENT` error is returned.
451
+ * @param {string} request.pageToken
452
+ * A page token
453
+ * {@link google.cloud.discoveryengine.v1.ListDocumentsResponse.next_page_token|ListDocumentsResponse.next_page_token},
454
+ * received from a previous
455
+ * {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
456
+ * call. Provide this to retrieve the subsequent page.
457
+ *
458
+ * When paginating, all other parameters provided to
459
+ * {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
460
+ * must match the call that provided the page token. Otherwise, an
461
+ * `INVALID_ARGUMENT` error is returned.
462
+ * @param {object} [options]
463
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
464
+ * @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 | Document}.
466
+ * The client library will perform auto-pagination by default: it will call the API as many
467
+ * times as needed and will merge results from all the pages into this array.
468
+ * Note that it can affect your quota.
469
+ * We recommend using `listDocumentsAsync()`
470
+ * 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)
473
+ * for more details and examples.
474
+ */
475
+ listDocuments(request?: protos.google.cloud.discoveryengine.v1.IListDocumentsRequest, options?: CallOptions): Promise<[
476
+ protos.google.cloud.discoveryengine.v1.IDocument[],
477
+ protos.google.cloud.discoveryengine.v1.IListDocumentsRequest | null,
478
+ protos.google.cloud.discoveryengine.v1.IListDocumentsResponse
479
+ ]>;
480
+ listDocuments(request: protos.google.cloud.discoveryengine.v1.IListDocumentsRequest, options: CallOptions, callback: PaginationCallback<protos.google.cloud.discoveryengine.v1.IListDocumentsRequest, protos.google.cloud.discoveryengine.v1.IListDocumentsResponse | null | undefined, protos.google.cloud.discoveryengine.v1.IDocument>): void;
481
+ listDocuments(request: protos.google.cloud.discoveryengine.v1.IListDocumentsRequest, callback: PaginationCallback<protos.google.cloud.discoveryengine.v1.IListDocumentsRequest, protos.google.cloud.discoveryengine.v1.IListDocumentsResponse | null | undefined, protos.google.cloud.discoveryengine.v1.IDocument>): void;
482
+ /**
483
+ * Equivalent to `method.name.toCamelCase()`, but returns a NodeJS Stream object.
484
+ * @param {Object} request
485
+ * The request object that will be sent.
486
+ * @param {string} request.parent
487
+ * Required. The parent branch resource name, such as
488
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.
489
+ * Use `default_branch` as the branch ID, to list documents under the default
490
+ * branch.
491
+ *
492
+ * If the caller does not have permission to list {@link |Documents}s under this
493
+ * branch, regardless of whether or not this branch exists, a
494
+ * `PERMISSION_DENIED` error is returned.
495
+ * @param {number} request.pageSize
496
+ * Maximum number of {@link google.cloud.discoveryengine.v1.Document|Document}s to
497
+ * return. If unspecified, defaults to 100. The maximum allowed value is 1000.
498
+ * Values above 1000 will be coerced to 1000.
499
+ *
500
+ * If this field is negative, an `INVALID_ARGUMENT` error is returned.
501
+ * @param {string} request.pageToken
502
+ * A page token
503
+ * {@link google.cloud.discoveryengine.v1.ListDocumentsResponse.next_page_token|ListDocumentsResponse.next_page_token},
504
+ * received from a previous
505
+ * {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
506
+ * call. Provide this to retrieve the subsequent page.
507
+ *
508
+ * When paginating, all other parameters provided to
509
+ * {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
510
+ * must match the call that provided the page token. Otherwise, an
511
+ * `INVALID_ARGUMENT` error is returned.
512
+ * @param {object} [options]
513
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
514
+ * @returns {Stream}
515
+ * An object stream which emits an object representing {@link google.cloud.discoveryengine.v1.Document | Document} on 'data' event.
516
+ * The client library will perform auto-pagination by default: it will call the API as many
517
+ * times as needed. Note that it can affect your quota.
518
+ * We recommend using `listDocumentsAsync()`
519
+ * 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)
522
+ * for more details and examples.
523
+ */
524
+ listDocumentsStream(request?: protos.google.cloud.discoveryengine.v1.IListDocumentsRequest, options?: CallOptions): Transform;
525
+ /**
526
+ * Equivalent to `listDocuments`, but returns an iterable object.
527
+ *
528
+ * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
529
+ * @param {Object} request
530
+ * The request object that will be sent.
531
+ * @param {string} request.parent
532
+ * Required. The parent branch resource name, such as
533
+ * `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}`.
534
+ * Use `default_branch` as the branch ID, to list documents under the default
535
+ * branch.
536
+ *
537
+ * If the caller does not have permission to list {@link |Documents}s under this
538
+ * branch, regardless of whether or not this branch exists, a
539
+ * `PERMISSION_DENIED` error is returned.
540
+ * @param {number} request.pageSize
541
+ * Maximum number of {@link google.cloud.discoveryengine.v1.Document|Document}s to
542
+ * return. If unspecified, defaults to 100. The maximum allowed value is 1000.
543
+ * Values above 1000 will be coerced to 1000.
544
+ *
545
+ * If this field is negative, an `INVALID_ARGUMENT` error is returned.
546
+ * @param {string} request.pageToken
547
+ * A page token
548
+ * {@link google.cloud.discoveryengine.v1.ListDocumentsResponse.next_page_token|ListDocumentsResponse.next_page_token},
549
+ * received from a previous
550
+ * {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
551
+ * call. Provide this to retrieve the subsequent page.
552
+ *
553
+ * When paginating, all other parameters provided to
554
+ * {@link google.cloud.discoveryengine.v1.DocumentService.ListDocuments|DocumentService.ListDocuments}
555
+ * must match the call that provided the page token. Otherwise, an
556
+ * `INVALID_ARGUMENT` error is returned.
557
+ * @param {object} [options]
558
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
559
+ * @returns {Object}
560
+ * An iterable Object that allows [async iteration](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols).
561
+ * When you iterate the returned iterable, each element will be an object representing
562
+ * {@link google.cloud.discoveryengine.v1.Document | Document}. The API will be called under the hood as needed, once per the page,
563
+ * 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)
566
+ * for more details and examples.
567
+ * @example <caption>include:samples/generated/v1/document_service.list_documents.js</caption>
568
+ * region_tag:discoveryengine_v1_generated_DocumentService_ListDocuments_async
569
+ */
570
+ listDocumentsAsync(request?: protos.google.cloud.discoveryengine.v1.IListDocumentsRequest, options?: CallOptions): AsyncIterable<protos.google.cloud.discoveryengine.v1.IDocument>;
571
+ /**
572
+ * Gets the latest state of a long-running operation. Clients can use this
573
+ * method to poll the operation result at intervals as recommended by the API
574
+ * service.
575
+ *
576
+ * @param {Object} request - The request object that will be sent.
577
+ * @param {string} request.name - The name of the operation resource.
578
+ * @param {Object=} options
579
+ * Optional parameters. You can override the default settings for this call,
580
+ * e.g, timeout, retries, paginations, etc. See {@link
581
+ * https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions}
582
+ * for the details.
583
+ * @param {function(?Error, ?Object)=} callback
584
+ * The function which will be called with the result of the API call.
585
+ *
586
+ * The second parameter to the callback is an object representing
587
+ * {@link google.longrunning.Operation | google.longrunning.Operation}.
588
+ * @return {Promise} - The promise which resolves to an array.
589
+ * The first element of the array is an object representing
590
+ * {@link google.longrunning.Operation | google.longrunning.Operation}.
591
+ * The promise has a method named "cancel" which cancels the ongoing API call.
592
+ *
593
+ * @example
594
+ * ```
595
+ * const client = longrunning.operationsClient();
596
+ * const name = '';
597
+ * const [response] = await client.getOperation({name});
598
+ * // doThingsWith(response)
599
+ * ```
600
+ */
601
+ getOperation(request: protos.google.longrunning.GetOperationRequest, options?: gax.CallOptions | Callback<protos.google.longrunning.Operation, protos.google.longrunning.GetOperationRequest, {} | null | undefined>, callback?: Callback<protos.google.longrunning.Operation, protos.google.longrunning.GetOperationRequest, {} | null | undefined>): Promise<[protos.google.longrunning.Operation]>;
602
+ /**
603
+ * Lists operations that match the specified filter in the request. If the
604
+ * server doesn't support this method, it returns `UNIMPLEMENTED`. Returns an iterable object.
605
+ *
606
+ * For-await-of syntax is used with the iterable to recursively get response element on-demand.
607
+ *
608
+ * @param {Object} request - The request object that will be sent.
609
+ * @param {string} request.name - The name of the operation collection.
610
+ * @param {string} request.filter - The standard list filter.
611
+ * @param {number=} request.pageSize -
612
+ * The maximum number of resources contained in the underlying API
613
+ * response. If page streaming is performed per-resource, this
614
+ * parameter does not affect the return value. If page streaming is
615
+ * performed per-page, this determines the maximum number of
616
+ * resources in a page.
617
+ * @param {Object=} options
618
+ * Optional parameters. You can override the default settings for this call,
619
+ * e.g, timeout, retries, paginations, etc. See {@link
620
+ * https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions} for the
621
+ * details.
622
+ * @returns {Object}
623
+ * An iterable Object that conforms to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | iteration protocols}.
624
+ *
625
+ * @example
626
+ * ```
627
+ * const client = longrunning.operationsClient();
628
+ * for await (const response of client.listOperationsAsync(request));
629
+ * // doThingsWith(response)
630
+ * ```
631
+ */
632
+ listOperationsAsync(request: protos.google.longrunning.ListOperationsRequest, options?: gax.CallOptions): AsyncIterable<protos.google.longrunning.ListOperationsResponse>;
633
+ /**
634
+ * Starts asynchronous cancellation on a long-running operation. The server
635
+ * makes a best effort to cancel the operation, but success is not
636
+ * guaranteed. If the server doesn't support this method, it returns
637
+ * `google.rpc.Code.UNIMPLEMENTED`. Clients can use
638
+ * {@link Operations.GetOperation} or
639
+ * other methods to check whether the cancellation succeeded or whether the
640
+ * operation completed despite cancellation. On successful cancellation,
641
+ * the operation is not deleted; instead, it becomes an operation with
642
+ * an {@link Operation.error} value with a {@link google.rpc.Status.code} of
643
+ * 1, corresponding to `Code.CANCELLED`.
644
+ *
645
+ * @param {Object} request - The request object that will be sent.
646
+ * @param {string} request.name - The name of the operation resource to be cancelled.
647
+ * @param {Object=} options
648
+ * Optional parameters. You can override the default settings for this call,
649
+ * e.g, timeout, retries, paginations, etc. See {@link
650
+ * https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions} for the
651
+ * details.
652
+ * @param {function(?Error)=} callback
653
+ * The function which will be called with the result of the API call.
654
+ * @return {Promise} - The promise which resolves when API call finishes.
655
+ * The promise has a method named "cancel" which cancels the ongoing API
656
+ * call.
657
+ *
658
+ * @example
659
+ * ```
660
+ * const client = longrunning.operationsClient();
661
+ * await client.cancelOperation({name: ''});
662
+ * ```
663
+ */
664
+ cancelOperation(request: protos.google.longrunning.CancelOperationRequest, options?: gax.CallOptions | Callback<protos.google.protobuf.Empty, protos.google.longrunning.CancelOperationRequest, {} | undefined | null>, callback?: Callback<protos.google.longrunning.CancelOperationRequest, protos.google.protobuf.Empty, {} | undefined | null>): Promise<protos.google.protobuf.Empty>;
665
+ /**
666
+ * Deletes a long-running operation. This method indicates that the client is
667
+ * no longer interested in the operation result. It does not cancel the
668
+ * operation. If the server doesn't support this method, it returns
669
+ * `google.rpc.Code.UNIMPLEMENTED`.
670
+ *
671
+ * @param {Object} request - The request object that will be sent.
672
+ * @param {string} request.name - The name of the operation resource to be deleted.
673
+ * @param {Object=} options
674
+ * Optional parameters. You can override the default settings for this call,
675
+ * e.g, timeout, retries, paginations, etc. See {@link
676
+ * https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions}
677
+ * for the details.
678
+ * @param {function(?Error)=} callback
679
+ * The function which will be called with the result of the API call.
680
+ * @return {Promise} - The promise which resolves when API call finishes.
681
+ * The promise has a method named "cancel" which cancels the ongoing API
682
+ * call.
683
+ *
684
+ * @example
685
+ * ```
686
+ * const client = longrunning.operationsClient();
687
+ * await client.deleteOperation({name: ''});
688
+ * ```
689
+ */
690
+ deleteOperation(request: protos.google.longrunning.DeleteOperationRequest, options?: gax.CallOptions | Callback<protos.google.protobuf.Empty, protos.google.longrunning.DeleteOperationRequest, {} | null | undefined>, callback?: Callback<protos.google.protobuf.Empty, protos.google.longrunning.DeleteOperationRequest, {} | null | undefined>): Promise<protos.google.protobuf.Empty>;
691
+ /**
692
+ * Return a fully-qualified projectLocationCollectionDataStoreBranch resource name string.
693
+ *
694
+ * @param {string} project
695
+ * @param {string} location
696
+ * @param {string} collection
697
+ * @param {string} data_store
698
+ * @param {string} branch
699
+ * @returns {string} Resource name string.
700
+ */
701
+ projectLocationCollectionDataStoreBranchPath(project: string, location: string, collection: string, dataStore: string, branch: string): string;
702
+ /**
703
+ * Parse the project from ProjectLocationCollectionDataStoreBranch resource.
704
+ *
705
+ * @param {string} projectLocationCollectionDataStoreBranchName
706
+ * A fully-qualified path representing project_location_collection_data_store_branch resource.
707
+ * @returns {string} A string representing the project.
708
+ */
709
+ matchProjectFromProjectLocationCollectionDataStoreBranchName(projectLocationCollectionDataStoreBranchName: string): string | number;
710
+ /**
711
+ * Parse the location from ProjectLocationCollectionDataStoreBranch resource.
712
+ *
713
+ * @param {string} projectLocationCollectionDataStoreBranchName
714
+ * A fully-qualified path representing project_location_collection_data_store_branch resource.
715
+ * @returns {string} A string representing the location.
716
+ */
717
+ matchLocationFromProjectLocationCollectionDataStoreBranchName(projectLocationCollectionDataStoreBranchName: string): string | number;
718
+ /**
719
+ * Parse the collection from ProjectLocationCollectionDataStoreBranch resource.
720
+ *
721
+ * @param {string} projectLocationCollectionDataStoreBranchName
722
+ * A fully-qualified path representing project_location_collection_data_store_branch resource.
723
+ * @returns {string} A string representing the collection.
724
+ */
725
+ matchCollectionFromProjectLocationCollectionDataStoreBranchName(projectLocationCollectionDataStoreBranchName: string): string | number;
726
+ /**
727
+ * Parse the data_store from ProjectLocationCollectionDataStoreBranch resource.
728
+ *
729
+ * @param {string} projectLocationCollectionDataStoreBranchName
730
+ * A fully-qualified path representing project_location_collection_data_store_branch resource.
731
+ * @returns {string} A string representing the data_store.
732
+ */
733
+ matchDataStoreFromProjectLocationCollectionDataStoreBranchName(projectLocationCollectionDataStoreBranchName: string): string | number;
734
+ /**
735
+ * Parse the branch from ProjectLocationCollectionDataStoreBranch resource.
736
+ *
737
+ * @param {string} projectLocationCollectionDataStoreBranchName
738
+ * A fully-qualified path representing project_location_collection_data_store_branch resource.
739
+ * @returns {string} A string representing the branch.
740
+ */
741
+ matchBranchFromProjectLocationCollectionDataStoreBranchName(projectLocationCollectionDataStoreBranchName: string): string | number;
742
+ /**
743
+ * Return a fully-qualified projectLocationCollectionDataStoreBranchDocument resource name string.
744
+ *
745
+ * @param {string} project
746
+ * @param {string} location
747
+ * @param {string} collection
748
+ * @param {string} data_store
749
+ * @param {string} branch
750
+ * @param {string} document
751
+ * @returns {string} Resource name string.
752
+ */
753
+ projectLocationCollectionDataStoreBranchDocumentPath(project: string, location: string, collection: string, dataStore: string, branch: string, document: string): string;
754
+ /**
755
+ * Parse the project from ProjectLocationCollectionDataStoreBranchDocument resource.
756
+ *
757
+ * @param {string} projectLocationCollectionDataStoreBranchDocumentName
758
+ * A fully-qualified path representing project_location_collection_data_store_branch_document resource.
759
+ * @returns {string} A string representing the project.
760
+ */
761
+ matchProjectFromProjectLocationCollectionDataStoreBranchDocumentName(projectLocationCollectionDataStoreBranchDocumentName: string): string | number;
762
+ /**
763
+ * Parse the location from ProjectLocationCollectionDataStoreBranchDocument resource.
764
+ *
765
+ * @param {string} projectLocationCollectionDataStoreBranchDocumentName
766
+ * A fully-qualified path representing project_location_collection_data_store_branch_document resource.
767
+ * @returns {string} A string representing the location.
768
+ */
769
+ matchLocationFromProjectLocationCollectionDataStoreBranchDocumentName(projectLocationCollectionDataStoreBranchDocumentName: string): string | number;
770
+ /**
771
+ * Parse the collection from ProjectLocationCollectionDataStoreBranchDocument resource.
772
+ *
773
+ * @param {string} projectLocationCollectionDataStoreBranchDocumentName
774
+ * A fully-qualified path representing project_location_collection_data_store_branch_document resource.
775
+ * @returns {string} A string representing the collection.
776
+ */
777
+ matchCollectionFromProjectLocationCollectionDataStoreBranchDocumentName(projectLocationCollectionDataStoreBranchDocumentName: string): string | number;
778
+ /**
779
+ * Parse the data_store from ProjectLocationCollectionDataStoreBranchDocument resource.
780
+ *
781
+ * @param {string} projectLocationCollectionDataStoreBranchDocumentName
782
+ * A fully-qualified path representing project_location_collection_data_store_branch_document resource.
783
+ * @returns {string} A string representing the data_store.
784
+ */
785
+ matchDataStoreFromProjectLocationCollectionDataStoreBranchDocumentName(projectLocationCollectionDataStoreBranchDocumentName: string): string | number;
786
+ /**
787
+ * Parse the branch from ProjectLocationCollectionDataStoreBranchDocument resource.
788
+ *
789
+ * @param {string} projectLocationCollectionDataStoreBranchDocumentName
790
+ * A fully-qualified path representing project_location_collection_data_store_branch_document resource.
791
+ * @returns {string} A string representing the branch.
792
+ */
793
+ matchBranchFromProjectLocationCollectionDataStoreBranchDocumentName(projectLocationCollectionDataStoreBranchDocumentName: string): string | number;
794
+ /**
795
+ * Parse the document from ProjectLocationCollectionDataStoreBranchDocument resource.
796
+ *
797
+ * @param {string} projectLocationCollectionDataStoreBranchDocumentName
798
+ * A fully-qualified path representing project_location_collection_data_store_branch_document resource.
799
+ * @returns {string} A string representing the document.
800
+ */
801
+ matchDocumentFromProjectLocationCollectionDataStoreBranchDocumentName(projectLocationCollectionDataStoreBranchDocumentName: string): string | number;
802
+ /**
803
+ * Return a fully-qualified projectLocationCollectionDataStoreSchema resource name string.
804
+ *
805
+ * @param {string} project
806
+ * @param {string} location
807
+ * @param {string} collection
808
+ * @param {string} data_store
809
+ * @param {string} schema
810
+ * @returns {string} Resource name string.
811
+ */
812
+ projectLocationCollectionDataStoreSchemaPath(project: string, location: string, collection: string, dataStore: string, schema: string): string;
813
+ /**
814
+ * Parse the project from ProjectLocationCollectionDataStoreSchema resource.
815
+ *
816
+ * @param {string} projectLocationCollectionDataStoreSchemaName
817
+ * A fully-qualified path representing project_location_collection_data_store_schema resource.
818
+ * @returns {string} A string representing the project.
819
+ */
820
+ matchProjectFromProjectLocationCollectionDataStoreSchemaName(projectLocationCollectionDataStoreSchemaName: string): string | number;
821
+ /**
822
+ * Parse the location from ProjectLocationCollectionDataStoreSchema resource.
823
+ *
824
+ * @param {string} projectLocationCollectionDataStoreSchemaName
825
+ * A fully-qualified path representing project_location_collection_data_store_schema resource.
826
+ * @returns {string} A string representing the location.
827
+ */
828
+ matchLocationFromProjectLocationCollectionDataStoreSchemaName(projectLocationCollectionDataStoreSchemaName: string): string | number;
829
+ /**
830
+ * Parse the collection from ProjectLocationCollectionDataStoreSchema resource.
831
+ *
832
+ * @param {string} projectLocationCollectionDataStoreSchemaName
833
+ * A fully-qualified path representing project_location_collection_data_store_schema resource.
834
+ * @returns {string} A string representing the collection.
835
+ */
836
+ matchCollectionFromProjectLocationCollectionDataStoreSchemaName(projectLocationCollectionDataStoreSchemaName: string): string | number;
837
+ /**
838
+ * Parse the data_store from ProjectLocationCollectionDataStoreSchema resource.
839
+ *
840
+ * @param {string} projectLocationCollectionDataStoreSchemaName
841
+ * A fully-qualified path representing project_location_collection_data_store_schema resource.
842
+ * @returns {string} A string representing the data_store.
843
+ */
844
+ matchDataStoreFromProjectLocationCollectionDataStoreSchemaName(projectLocationCollectionDataStoreSchemaName: string): string | number;
845
+ /**
846
+ * Parse the schema from ProjectLocationCollectionDataStoreSchema resource.
847
+ *
848
+ * @param {string} projectLocationCollectionDataStoreSchemaName
849
+ * A fully-qualified path representing project_location_collection_data_store_schema resource.
850
+ * @returns {string} A string representing the schema.
851
+ */
852
+ matchSchemaFromProjectLocationCollectionDataStoreSchemaName(projectLocationCollectionDataStoreSchemaName: string): string | number;
853
+ /**
854
+ * Return a fully-qualified projectLocationDataStoreBranch resource name string.
855
+ *
856
+ * @param {string} project
857
+ * @param {string} location
858
+ * @param {string} data_store
859
+ * @param {string} branch
860
+ * @returns {string} Resource name string.
861
+ */
862
+ projectLocationDataStoreBranchPath(project: string, location: string, dataStore: string, branch: string): string;
863
+ /**
864
+ * Parse the project from ProjectLocationDataStoreBranch resource.
865
+ *
866
+ * @param {string} projectLocationDataStoreBranchName
867
+ * A fully-qualified path representing project_location_data_store_branch resource.
868
+ * @returns {string} A string representing the project.
869
+ */
870
+ matchProjectFromProjectLocationDataStoreBranchName(projectLocationDataStoreBranchName: string): string | number;
871
+ /**
872
+ * Parse the location from ProjectLocationDataStoreBranch resource.
873
+ *
874
+ * @param {string} projectLocationDataStoreBranchName
875
+ * A fully-qualified path representing project_location_data_store_branch resource.
876
+ * @returns {string} A string representing the location.
877
+ */
878
+ matchLocationFromProjectLocationDataStoreBranchName(projectLocationDataStoreBranchName: string): string | number;
879
+ /**
880
+ * Parse the data_store from ProjectLocationDataStoreBranch resource.
881
+ *
882
+ * @param {string} projectLocationDataStoreBranchName
883
+ * A fully-qualified path representing project_location_data_store_branch resource.
884
+ * @returns {string} A string representing the data_store.
885
+ */
886
+ matchDataStoreFromProjectLocationDataStoreBranchName(projectLocationDataStoreBranchName: string): string | number;
887
+ /**
888
+ * Parse the branch from ProjectLocationDataStoreBranch resource.
889
+ *
890
+ * @param {string} projectLocationDataStoreBranchName
891
+ * A fully-qualified path representing project_location_data_store_branch resource.
892
+ * @returns {string} A string representing the branch.
893
+ */
894
+ matchBranchFromProjectLocationDataStoreBranchName(projectLocationDataStoreBranchName: string): string | number;
895
+ /**
896
+ * Return a fully-qualified projectLocationDataStoreBranchDocument resource name string.
897
+ *
898
+ * @param {string} project
899
+ * @param {string} location
900
+ * @param {string} data_store
901
+ * @param {string} branch
902
+ * @param {string} document
903
+ * @returns {string} Resource name string.
904
+ */
905
+ projectLocationDataStoreBranchDocumentPath(project: string, location: string, dataStore: string, branch: string, document: string): string;
906
+ /**
907
+ * Parse the project from ProjectLocationDataStoreBranchDocument resource.
908
+ *
909
+ * @param {string} projectLocationDataStoreBranchDocumentName
910
+ * A fully-qualified path representing project_location_data_store_branch_document resource.
911
+ * @returns {string} A string representing the project.
912
+ */
913
+ matchProjectFromProjectLocationDataStoreBranchDocumentName(projectLocationDataStoreBranchDocumentName: string): string | number;
914
+ /**
915
+ * Parse the location from ProjectLocationDataStoreBranchDocument resource.
916
+ *
917
+ * @param {string} projectLocationDataStoreBranchDocumentName
918
+ * A fully-qualified path representing project_location_data_store_branch_document resource.
919
+ * @returns {string} A string representing the location.
920
+ */
921
+ matchLocationFromProjectLocationDataStoreBranchDocumentName(projectLocationDataStoreBranchDocumentName: string): string | number;
922
+ /**
923
+ * Parse the data_store from ProjectLocationDataStoreBranchDocument resource.
924
+ *
925
+ * @param {string} projectLocationDataStoreBranchDocumentName
926
+ * A fully-qualified path representing project_location_data_store_branch_document resource.
927
+ * @returns {string} A string representing the data_store.
928
+ */
929
+ matchDataStoreFromProjectLocationDataStoreBranchDocumentName(projectLocationDataStoreBranchDocumentName: string): string | number;
930
+ /**
931
+ * Parse the branch from ProjectLocationDataStoreBranchDocument resource.
932
+ *
933
+ * @param {string} projectLocationDataStoreBranchDocumentName
934
+ * A fully-qualified path representing project_location_data_store_branch_document resource.
935
+ * @returns {string} A string representing the branch.
936
+ */
937
+ matchBranchFromProjectLocationDataStoreBranchDocumentName(projectLocationDataStoreBranchDocumentName: string): string | number;
938
+ /**
939
+ * Parse the document from ProjectLocationDataStoreBranchDocument resource.
940
+ *
941
+ * @param {string} projectLocationDataStoreBranchDocumentName
942
+ * A fully-qualified path representing project_location_data_store_branch_document resource.
943
+ * @returns {string} A string representing the document.
944
+ */
945
+ matchDocumentFromProjectLocationDataStoreBranchDocumentName(projectLocationDataStoreBranchDocumentName: string): string | number;
946
+ /**
947
+ * Return a fully-qualified projectLocationDataStoreSchema resource name string.
948
+ *
949
+ * @param {string} project
950
+ * @param {string} location
951
+ * @param {string} data_store
952
+ * @param {string} schema
953
+ * @returns {string} Resource name string.
954
+ */
955
+ projectLocationDataStoreSchemaPath(project: string, location: string, dataStore: string, schema: string): string;
956
+ /**
957
+ * Parse the project from ProjectLocationDataStoreSchema resource.
958
+ *
959
+ * @param {string} projectLocationDataStoreSchemaName
960
+ * A fully-qualified path representing project_location_data_store_schema resource.
961
+ * @returns {string} A string representing the project.
962
+ */
963
+ matchProjectFromProjectLocationDataStoreSchemaName(projectLocationDataStoreSchemaName: string): string | number;
964
+ /**
965
+ * Parse the location from ProjectLocationDataStoreSchema resource.
966
+ *
967
+ * @param {string} projectLocationDataStoreSchemaName
968
+ * A fully-qualified path representing project_location_data_store_schema resource.
969
+ * @returns {string} A string representing the location.
970
+ */
971
+ matchLocationFromProjectLocationDataStoreSchemaName(projectLocationDataStoreSchemaName: string): string | number;
972
+ /**
973
+ * Parse the data_store from ProjectLocationDataStoreSchema resource.
974
+ *
975
+ * @param {string} projectLocationDataStoreSchemaName
976
+ * A fully-qualified path representing project_location_data_store_schema resource.
977
+ * @returns {string} A string representing the data_store.
978
+ */
979
+ matchDataStoreFromProjectLocationDataStoreSchemaName(projectLocationDataStoreSchemaName: string): string | number;
980
+ /**
981
+ * Parse the schema from ProjectLocationDataStoreSchema resource.
982
+ *
983
+ * @param {string} projectLocationDataStoreSchemaName
984
+ * A fully-qualified path representing project_location_data_store_schema resource.
985
+ * @returns {string} A string representing the schema.
986
+ */
987
+ matchSchemaFromProjectLocationDataStoreSchemaName(projectLocationDataStoreSchemaName: string): string | number;
988
+ /**
989
+ * Terminate the gRPC channel and close the client.
990
+ *
991
+ * The client will no longer be usable and all future behavior is undefined.
992
+ * @returns {Promise} A promise that resolves when the client is closed.
993
+ */
994
+ close(): Promise<void>;
995
+ }