Erstellt ein leeres Dokument mit dem in der Anfrage angegebenen Titel. Alle anderen Felder in der Anfrage und alle bereitgestellten Inhalte werden ignoriert.
Gibt das erstellte Dokument zurück
HTTP-Anfrage
POST https://docs.googleapis.com/v1/documents
Die URL verwendet die Syntax der gRPC-Transcodierung.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "documentId": string, "title": string, "body": { object ( |
Felder | |
---|---|
documentId |
Nur Ausgabe. Die ID des Dokuments. |
title |
Der Titel des Dokuments. |
body |
Nur Ausgabe. Der Hauptteil des Dokuments. |
headers |
Nur Ausgabe. Die Header im Dokument, verschlüsselt nach Header-ID. |
footers |
Nur Ausgabe. Die Fußzeilen im Dokument, eingegeben nach Fußzeilen-ID. |
footnotes |
Nur Ausgabe. Die Fußnoten im Dokument, eingegeben nach Fußnoten-ID. |
documentStyle |
Nur Ausgabe. Der Stil des Dokuments. |
suggestedDocumentStyleChanges |
Nur Ausgabe. Die vorgeschlagenen Änderungen am Format des Dokuments, angegeben nach Vorschlags-ID. |
namedStyles |
Nur Ausgabe. Die benannten Stile des Dokuments. |
suggestedNamedStylesChanges |
Nur Ausgabe. Die vorgeschlagenen Änderungen an den benannten Stilen des Dokuments, angegeben nach Vorschlags-ID. |
lists |
Nur Ausgabe. Die Listen im Dokument, nach Schlüssel-ID geordnet. |
namedRanges |
Nur Ausgabe. Die benannten Bereiche im Dokument, benannt nach dem Namen. |
revisionId |
Nur Ausgabe. Die Überarbeitungs-ID des Dokuments. Kann in Aktualisierungsanfragen verwendet werden, um anzugeben, auf welche Überarbeitung eines Dokuments Aktualisierungen angewendet werden sollen und wie sich die Anfrage verhalten soll, wenn das Dokument seit dieser Überarbeitung bearbeitet wurde. Wird nur ausgefüllt, wenn der Nutzer Bearbeitungszugriff auf das Dokument hat. Die Überarbeitungs-ID ist keine sequenzielle Nummer, sondern ein intransparenter String. Das Format der Überarbeitungs-ID kann sich im Laufe der Zeit ändern. Eine zurückgegebene Überarbeitungs-ID ist nach der Rückgabe 24 Stunden lang gültig und kann nicht mit anderen Nutzern geteilt werden. Wenn die Überarbeitungs-ID zwischen Aufrufen unverändert bleibt, bleibt das Dokument unverändert. Umgekehrt bedeutet in der Regel auch eine geänderte ID für dasselbe Dokument und denselben Nutzer, dass das Dokument aktualisiert wurde. Eine geänderte ID kann aber auch durch interne Faktoren wie Änderungen des ID-Formats verursacht werden. |
suggestionsViewMode |
Nur Ausgabe. Der Ansichtsmodus für Vorschläge, der auf das Dokument angewendet wird Hinweis: Wenn Sie ein Dokument bearbeiten, müssen die Änderungen auf einem Dokument mit |
inlineObjects |
Nur Ausgabe. Die Inline-Objekte im Dokument, verschlüsselt nach Objekt-ID. |
positionedObjects |
Nur Ausgabe. Die Positionierung der Objekte im Dokument, eingegeben nach Objekt-ID. |
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Document
.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.