REST Resource: projects.locations.dataStores.branches.documents

Ressource: Dokument

In einem Dokument werden alle Rohmetadaten der Elemente erfasst, die empfohlen oder gesucht werden sollen.

JSON-Darstellung 
{
  "name": string,
  "id": string,
  "schemaId": string,
  "content": {
    object (Content)
  },
  "parentDocumentId": string,
  "derivedStructData": {
    object
  },
  "aclInfo": {
    object (AclInfo)
  },
  "indexTime": string,
  "indexStatus": {
    object (IndexStatus)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structData": {
    object
  },
  "jsonData": string
  // End of mutually exclusive fields.
}
Felder
name

string

Nicht veränderbar. Der vollständige Ressourcenname des Dokuments. Format: projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}.

Dieses Feld muss einen UTF-8-codierten String mit maximal 1.024 Zeichen enthalten.
id

string

Nicht veränderbar. Die Kennung des Dokuments.

Die ID sollte dem RFC-1034-Standard entsprechen und darf maximal 128 Zeichen lang sein.
schemaId

string

Die Kennung des Schemas, das sich im selben Datenspeicher befindet.
content

object (Content)

Die mit diesem Dokument verknüpften unstrukturierten Daten. Inhalte können nur festgelegt werden und müssen festgelegt werden, wenn sich dieses Dokument in einem CONTENT_REQUIRED-Datenspeicher befindet.
parentDocumentId

string

Die Kennung des übergeordneten Dokuments. Derzeit werden nur Dokumenthierarchien mit maximal zwei Ebenen unterstützt.

Die ID sollte dem RFC-1034-Standard entsprechen und darf maximal 63 Zeichen lang sein.
derivedStructData

object (Struct format)

Nur Ausgabe. Dieses Feld ist OUTPUT_ONLY. Es enthält abgeleitete Daten, die nicht im ursprünglichen Eingabedokument enthalten sind.
aclInfo

object (AclInfo)

Informationen zur Zugriffssteuerung für das Dokument.
indexTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, an dem das Dokument zuletzt indexiert wurde.

Wenn dieses Feld ausgefüllt ist, wurde das Dokument indexiert. Obwohl Dokumente in der Regel innerhalb von Sekunden nach der Indexierung suchbar sind, kann es manchmal bis zu einigen Stunden dauern.

Wenn in diesem Feld nichts steht, wurde das Dokument noch nie indexiert.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen enthält. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
indexStatus

object (IndexStatus)

Nur Ausgabe. Der Indexstatus des Dokuments.

  • Wenn das Dokument erfolgreich indexiert wurde, ist das Feld „indexTime“ ausgefüllt.
  • Wenn das Dokument aufgrund von Fehlern nicht indexiert wurde, ist das Feld „errorSamples“ ausgefüllt.
  • Wenn das Dokument gerade indexiert wird, ist das Feld „pendingMessage“ ausgefüllt.
Datendarstellung. Es muss entweder struct_data oder json_data angegeben werden. Andernfalls wird ein INVALID_ARGUMENT-Fehler ausgegeben. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
structData

object (Struct format)

Die strukturierten JSON-Daten für das Dokument. Muss dem registrierten Schema entsprechen, andernfalls wird ein Fehler INVALID_ARGUMENT ausgegeben.
jsonData

string

Die JSON-String-Darstellung des Dokuments. Muss dem registrierten Schema entsprechen, andernfalls wird ein INVALID_ARGUMENT-Fehler ausgegeben.
Ende der sich gegenseitig ausschließenden Felder.

Methoden

create

 Erstellt ein Document.

delete

 Löscht ein Document-Element.

get

 Ruft ein Document ab.

import

 Bulk-Import mehrerer Document-Elemente.

list

 Ruft eine Liste der Document-Elemente ab.

patch

 Aktualisiert ein Document-Element.

purge

 Löscht alle ausgewählten Document-Elmente in einem Zweig endgültig.