Erstellt ein leeres Dokument unter Verwendung des in der Anfrage angegebenen Titels. Andere Felder in der Anfrage, einschließlich der 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, "tabs": [ { object ( |
Felder | |
---|---|
documentId |
Nur Ausgabe. Die ID des Dokuments. |
title |
Der Titel des Dokuments. |
tabs[] |
Tabs, die Teil eines Dokuments sind. Tabs können untergeordnete Tabs enthalten, also Tabs, die in einem anderen Tab verschachtelt sind. Untergeordnete Tabs werden durch das Feld |
revisionId |
Nur Ausgabe. Die Versions-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 fortlaufende Nummer, sondern ein intransparenter String. Das Format der Versions-ID kann sich im Laufe der Zeit ändern. Eine zurückgegebene Versions-ID ist nur 24 Stunden nach der Rückgabe gültig und kann nicht für mehrere Nutzer verwendet werden. Wenn sich die Überarbeitungs-ID zwischen den Aufrufen nicht ändert, hat sich das Dokument nicht geändert. Umgekehrt bedeutet eine geänderte ID (für dasselbe Dokument und denselben Nutzer) normalerweise, dass das Dokument aktualisiert wurde. Eine geänderte ID kann jedoch auch auf interne Faktoren wie Änderungen des ID-Formats zurückzuführen sein. |
suggestionsViewMode |
Nur Ausgabe. Der Ansichtsmodus für Vorschläge wurde auf das Dokument angewendet. Hinweis: Wenn Sie ein Dokument bearbeiten, müssen Änderungen auf einem Dokument mit |
body |
Nur Ausgabe. Der Haupttext des Dokuments. Altes Feld: Verwenden Sie stattdessen |
headers |
Nur Ausgabe. Die Überschriften im Dokument, sortiert nach Überschriften-ID. Alt-Feld: Verwenden Sie stattdessen |
footers |
Nur Ausgabe. Die Fußzeilen im Dokument, mit einer Fußzeilen-ID versehen. Altes Feld: Verwenden Sie stattdessen |
footnotes |
Nur Ausgabe. Die Fußnoten im Dokument, sortiert nach Fußnoten-ID. Alt-Feld: Verwenden Sie stattdessen |
documentStyle |
Nur Ausgabe. Der Stil des Dokuments. Altes Feld: Verwenden Sie stattdessen |
suggestedDocumentStyleChanges |
Nur Ausgabe. Die vorgeschlagenen Änderungen am Stil des Dokuments, unterstützt durch die Vorschlags-ID. Altes Feld: Verwenden Sie stattdessen |
namedStyles |
Nur Ausgabe. Die benannten Stile des Dokuments. Alt-Feld: Verwenden Sie stattdessen |
suggestedNamedStylesChanges |
Nur Ausgabe. Die vorgeschlagenen Änderungen an den benannten Stilen des Dokuments, sortiert nach Vorschlags-ID. Altes Feld: Verwenden Sie stattdessen |
lists |
Nur Ausgabe. Die Listen im Dokument, aufgeschlüsselt nach Listen-ID. Alt-Feld: Verwenden Sie stattdessen |
namedRanges |
Nur Ausgabe. Die benannten Bereiche im Dokument, aufgeschlüsselt nach Name. Altes Feld: Verwenden Sie stattdessen |
inlineObjects |
Nur Ausgabe. Die Inline-Objekte im Dokument, die mit der Objekt-ID versehen sind. Alt-Feld: Verwenden Sie stattdessen |
positionedObjects |
Nur Ausgabe. Die positionierten Objekte im Dokument, sortiert nach Objekt-ID. Altes Feld: Verwenden Sie stattdessen |
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.