Reloads the specified document from its specified source, contentUri or content. The previously loaded content of the document will be deleted. Note: Even when the content of the document has not changed, there still may be side effects because of internal implementation changes. Note: If the document source is Google Cloud Storage URI, its metadata will be replaced with the custom metadata from Google Cloud Storage if the importGcsCustomMetadata
field is set to true in the request.
This method is a long-running operation. The returned Operation
type has the following method-specific fields:
metadata
:KnowledgeOperationMetadata
response
:Document
Note: The projects.agent.knowledgeBases.documents
resource is deprecated; only use projects.knowledgeBases.documents
.
HTTP request
POST https://{endpoint}/v2beta1/{name=projects/*/knowledgeBases/*/documents/*}:reload
Where {endpoint}
is one of the supported service endpoints.
The URLs use gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
name |
Required. The name of the document to reload. Format: |
Request body
The request body contains data with the following structure:
JSON representation |
---|
{ "importGcsCustomMetadata": boolean, // Union field |
Fields | |
---|---|
import |
Whether to import custom metadata from Google Cloud Storage. Only valid when the document source is Google Cloud Storage URI. |
Union field Optional. If provided, the service will load the contents from the source and update document in the knowledge base. Reloading from a new document source is allowed for smart messaging documents only. If you want to update the source for other document types, please delete the existing document and create a new one instead. |
|
gcs |
The path for a Cloud Storage source file for reloading document content. If not provided, the Document's existing source will be reloaded. |
Response body
If successful, the response body contains an instance of Operation
.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/dialogflow
For more information, see the Authentication Overview.