REST Resource: projects.locations.collections.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.
Für die Datendarstellung. Es muss entweder struct_data oder json_data angegeben werden. Andernfalls wird ein Fehler INVALID_ARGUMENT 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.

Inhalt

Mit diesem Dokument verknüpfte unstrukturierte Daten

JSON-Darstellung 
{
  "mimeType": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "rawBytes": string,
  "uri": string
  // End of mutually exclusive fields.
}
Felder
mimeType

string

Der MIME-Typ des Inhalts. Unterstützte Datentypen:

  • application/pdf (PDF, derzeit werden nur native PDFs unterstützt)
  • text/html (HTML)
  • text/plain (TXT)
  • application/xml oder text/xml (XML)
  • application/json (JSON)
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document (DOCX)
  • application/vnd.openxmlformats-officedocument.presentationml.presentation (PPTX)
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (XLSX)
  • application/vnd.ms-excel.sheet.macroenabled.12 (XLSM)

Die folgenden Typen werden nur unterstützt, wenn der Layoutparser im Datenspeicher aktiviert ist:

  • image/bmp (BMP)
  • image/gif (GIF)
  • image/jpeg (JPEG)
  • image/png (PNG)
  • image/tiff (TIFF)

Siehe https://www.iana.org/assignments/media-types/media-types.xhtml.
Der Inhalt des nicht strukturierten Dokuments. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
rawBytes

string (bytes format)

Der Inhalt, dargestellt als Bytestream. Die maximale Länge beträgt 1.000.000 Bytes (1 MB bzw. ~0,95 MiB).

Hinweis: Wie bei allen bytes-Feldern wird dieses Feld in Protokollzwischenspeichern als reiner Binärwert und in JSON als base64-codierter String dargestellt. abc123!?$*&()'-=@~ sollte in JSON beispielsweise als YWJjMTIzIT8kKiYoKSctPUB+ dargestellt werden. Weitere Informationen finden Sie unter https://developers.google.com/protocol-buffers/docs/proto3#json.

Ein base64-codierter String.
uri

string

Der URI des Inhalts. Es werden nur Cloud Storage-URIs unterstützt, z. B. gs://bucket-name/path/to/file. Die maximale Dateigröße beträgt 2,5 MB für textbasierte Formate und 200 MB für andere Formate.
Ende der sich gegenseitig ausschließenden Felder.

AclInfo

ACL-Informationen des Dokuments

JSON-Darstellung 
{
  "readers": [
    {
      object (AccessRestriction)
    }
  ]
}
Felder
readers[]

object (AccessRestriction)

Leser des Dokuments

AccessRestriction

AclRestriction zum Modellieren komplexer Einschränkungen für die Übernahme.

Beispiel: Modellieren einer „Both Permit“-Übernahme, bei der ein Nutzer Zugriff auf das übergeordnete Dokument benötigt, um auf ein untergeordnetes Dokument zugreifen zu können.

Dokumenthierarchie: Space_S –> Page_P

Leser: Space_S: group_1, user_1; Page_P: group_2, group_3, user_2

Space_S-ACL-Einschränkung – { "aclInfo": { "readers": [ { "principals": [ { "groupId": "group_1" }, { "userId": "user_1" } ] } ] } }

Page_P-ACL-Einschränkung. { "aclInfo": { "readers": [ { "principals": [ { "groupId": "group_2" }, { "groupId": "group_3" }, { "userId": "user_2" } ], }, { "principals": [ { "groupId": "group_1" }, { "userId": "user_1" } ], } ] } }

JSON-Darstellung 
{
  "principals": [
    {
      object (Principal)
    }
  ],
  "idpWide": boolean
}
Felder
principals[]

object (Principal)

Die Liste der Hauptkonten.
idpWide

boolean

Alle Nutzer innerhalb des Identitätsanbieters.

Prinzipal

Die Prinzipal-ID eines Nutzers oder einer Gruppe.

JSON-Darstellung 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userId": string,
  "groupId": string,
  "externalEntityId": string
  // End of mutually exclusive fields.
}
Felder
Union-Feld „principal“. Der Prinzipal kann ein Nutzer oder eine Gruppe sein. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
userId

string

Nutzer-ID. Bei einem Google Workspace-Nutzerkonto ist „userId“ die E‑Mail-Adresse des Google Workspace-Nutzers. Bei einem Nutzerkonto eines anderen Identitätsanbieters als Google ist „userId“ die zugeordnete Nutzer-ID, die bei der Konfiguration des Personalpools konfiguriert wurde.
groupId

string

Gruppen-ID. Bei einem Google Workspace-Nutzerkonto ist „groupId“ die E‑Mail-Adresse der Google Workspace-Gruppe. Bei einem Nutzerkonto eines anderen Identitätsanbieters als Google ist „groupId“ die zugeordnete Gruppen-ID, die bei der Konfiguration des Personalpools konfiguriert wurde.
externalEntityId

string

Für Identitäten von Drittanbieteranwendungen, die nicht im Identitätsanbieter des Kunden vorhanden sind
Ende der sich gegenseitig ausschließenden Felder.

IndexStatus

Der Indexstatus des Dokuments.

JSON-Darstellung 
{
  "indexTime": string,
  "errorSamples": [
    {
      object (Status)
    }
  ],
  "pendingMessage": string
}
Felder
indexTime

string (Timestamp format)

Der Zeitpunkt, an dem das Dokument 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.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. 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".
errorSamples[]

object (Status)

Ein Beispiel für Fehler, die beim Indexieren des Dokuments aufgetreten sind. Wenn dieses Feld ausgefüllt ist, wurde das Dokument aufgrund von Fehlern nicht indexiert.
pendingMessage

string

Nicht veränderbar. Die Meldung gibt an, dass das Dokument gerade indexiert wird. Wenn dieses Feld ausgefüllt ist, steht die Indexierung des Dokuments noch aus.

Methoden

create

 Erstellt ein Document-Element.

delete

 Löscht ein Document-Element.

get

 Ruft ein Document-Element 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.