REST Resource: projects.locations.dataStores.documents

Risorsa: Documento

Un documento è una singola unità di contenuti importata in un datastore. È una risorsa secondaria di un datastore. Durante l'importazione, un documento viene analizzato e suddiviso in uno o più segmenti.

Rappresentazione JSON 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "content": {
    object (Content)
  },
  "etag": string,
  "metadata": {
    object (DocumentMetadata)
  }
}
Campi
name

string

Identificatore. Il nome completo della risorsa del documento.

Formato: projects/{project}/locations/{location}/dataStores/{dataStoreId}/documents/{documentId} Il documentId deve avere una lunghezza compresa tra 1 e 63 caratteri e deve essere conforme allo standard RFC1035.

Quando ImportDocuments importa i file direttamente (il formato di origine predefinito), il servizio ricava il documentId dall'URI Cloud Storage del file: la nuova importazione dello stesso URI aggiorna lo stesso documento e un file rinominato o spostato diventa un nuovo documento. Con SOURCE_FORMAT_DOCUMENT_JSON, il documentId viene preso da name fornito nel file di input.
createTime

string (Timestamp format)

Solo output. Timestamp della creazione del documento.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento del documento.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
content

object (Content)

Facoltativo. I dati non strutturati collegati a questo documento: il file Cloud Storage da cui è stato importato. Obbligatorio in ogni riga di un file di input SOURCE_FORMAT_DOCUMENT_JSON.
etag

string

Facoltativo. L'etag del documento.
metadata

object (DocumentMetadata)

Facoltativo. Metadati definiti dall'utente per questo documento. I valori dei metadati devono essere conformi al documentMetadataSchema definito nel datastore principale.

Contenuti

Dati non strutturati collegati a questo documento.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "gcsUri": string
  // End of mutually exclusive fields.
}
Campi
I contenuti del documento non strutturato. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
gcsUri

string

L'URI Cloud Storage dei contenuti. Sono supportati solo gli URI Cloud Storage (ad es. gs://bucket-name/path/to/file).
Fine dei campi che si escludono a vicenda.

DocumentMetadata

Metadati definiti dall'utente associati a un documento.

Rappresentazione JSON 
{
  "value": {
    object
  }
}
Campi
value

object (Struct format)

Facoltativo. Il valore dei metadati, come oggetto JSON. Il valore deve essere conforme alla documentMetadataSchema definita nel datastore principale.

Metodi

get

 Recupera un documento.

list

 Elenca i documenti in un datastore.
Cerca nei documenti di un singolo datastore.