Skip to main content

documents

Overview

Namedocuments
TypeResource
Idgoogle.discoveryengine.documents

Fields

NameDatatypeDescription
idstringImmutable. The identifier of the document. Id should conform to RFC-1034 standard with a length limit of 63 characters.
namestringImmutable. The full resource name of the document. Format: projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/branches/{branch}/documents/{document_id}. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
parentDocumentIdstringThe identifier of the parent document. Currently supports at most two level document hierarchy. Id should conform to RFC-1034 standard with a length limit of 63 characters.
schemaIdstringThe identifier of the schema located in the same data store.
structDataobjectThe structured JSON data for the document. It should conform to the registered Schema or an INVALID_ARGUMENT error is thrown.
contentobjectUnstructured data linked to this document.
derivedStructDataobjectOutput only. This field is OUTPUT_ONLY. It contains derived data that are not in the original input document.
jsonDatastringThe JSON string representation of the document. It should conform to the registered Schema or an INVALID_ARGUMENT error is thrown.

Methods

NameAccessible byRequired ParamsDescription
projects_locations_collections_data_stores_branches_documents_getSELECTbranchesId, collectionsId, dataStoresId, documentsId, locationsId, projectsIdGets a Document.
projects_locations_collections_data_stores_branches_documents_listSELECTbranchesId, collectionsId, dataStoresId, locationsId, projectsIdGets a list of Documents.
projects_locations_data_stores_branches_documents_getSELECTbranchesId, dataStoresId, documentsId, locationsId, projectsIdGets a Document.
projects_locations_data_stores_branches_documents_listSELECTbranchesId, dataStoresId, locationsId, projectsIdGets a list of Documents.
projects_locations_collections_data_stores_branches_documents_createINSERTbranchesId, collectionsId, dataStoresId, locationsId, projectsIdCreates a Document.
projects_locations_data_stores_branches_documents_createINSERTbranchesId, dataStoresId, locationsId, projectsIdCreates a Document.
projects_locations_collections_data_stores_branches_documents_deleteDELETEbranchesId, collectionsId, dataStoresId, documentsId, locationsId, projectsIdDeletes a Document.
projects_locations_data_stores_branches_documents_deleteDELETEbranchesId, dataStoresId, documentsId, locationsId, projectsIdDeletes a Document.
_projects_locations_collections_data_stores_branches_documents_listEXECbranchesId, collectionsId, dataStoresId, locationsId, projectsIdGets a list of Documents.
_projects_locations_data_stores_branches_documents_listEXECbranchesId, dataStoresId, locationsId, projectsIdGets a list of Documents.
projects_locations_collections_data_stores_branches_documents_importEXECbranchesId, collectionsId, dataStoresId, locationsId, projectsIdBulk import of multiple Documents. Request processing may be synchronous. Non-existing items will be created. Note: It is possible for a subset of the Documents to be successfully updated.
projects_locations_collections_data_stores_branches_documents_patchEXECbranchesId, collectionsId, dataStoresId, documentsId, locationsId, projectsIdUpdates a Document.
projects_locations_collections_data_stores_branches_documents_purgeEXECbranchesId, collectionsId, dataStoresId, locationsId, projectsIdPermanently deletes all selected Documents in a branch. This process is asynchronous. Depending on the number of Documents to be deleted, this operation can take hours to complete. Before the delete operation completes, some Documents might still be returned by DocumentService.GetDocument or DocumentService.ListDocuments. To get a list of the Documents to be deleted, set PurgeDocumentsRequest.force to false.
projects_locations_data_stores_branches_documents_importEXECbranchesId, dataStoresId, locationsId, projectsIdBulk import of multiple Documents. Request processing may be synchronous. Non-existing items will be created. Note: It is possible for a subset of the Documents to be successfully updated.
projects_locations_data_stores_branches_documents_patchEXECbranchesId, dataStoresId, documentsId, locationsId, projectsIdUpdates a Document.
projects_locations_data_stores_branches_documents_purgeEXECbranchesId, dataStoresId, locationsId, projectsIdPermanently deletes all selected Documents in a branch. This process is asynchronous. Depending on the number of Documents to be deleted, this operation can take hours to complete. Before the delete operation completes, some Documents might still be returned by DocumentService.GetDocument or DocumentService.ListDocuments. To get a list of the Documents to be deleted, set PurgeDocumentsRequest.force to false.