Google Docs API – Übersicht

Mit der Google Docs API können Sie Dokumente in Google Docs erstellen und ändern.

Anwendungen können in die Docs API eingebunden werden, um ausgefeilte Dokumente aus von Nutzern und vom System bereitgestellten Daten zu erstellen. Mit der Docs API können Sie:

  • Prozesse automatisieren
  • Mehrere Dokumentationen gleichzeitig erstellen
  • Dokumente formatieren
  • Rechnungen oder Verträge erstellen
  • Spezifische Attribute von Objekten abrufen

Im Folgenden finden Sie eine Liste mit allgemeinen Begriffen, die in der Docs API verwendet werden:

Dokument-ID

Die eindeutige Kennung für ein Dokument. Es ist ein bestimmter String, der Buchstaben, Zahlen und einige Sonderzeichen enthält, die auf ein Dokument verweisen und aus der URL des Dokuments abgeleitet werden können. Dokument-IDs bleiben stabil, auch wenn sich der Dokumentname ändert. Weitere Informationen zum Ermitteln der ID finden Sie unter Dokument-ID.

https://docs.google.com/document/d/DOCUMENT_ID/edit
Element

Die Struktur, aus der ein Dokument besteht. Zu den Elementen der obersten Ebene eines Dokuments gehören Body, DocumentStyle und List.

Google Workspace-Dokument

Eine Datei, die in einer Google Workspace-Anwendung wie Google Docs erstellt wird. Das MIME-Typ-Format für Docs ist application/vnd.google-apps.document. Eine Liste der MIME-Typen finden Sie unter Von Google Workspace und Google Drive unterstützte MIME-Typen.

Index

Die meisten Elemente im Textkörper haben die Eigenschaften startIndex und endIndex. Diese geben den Versatz von Anfang und Ende eines Elements bezogen auf den Anfang des einschließenden Segments an.

Inline-Bild

Ein Bild, das während des Textflusses in einem Dokument angezeigt wird. Es ist kein Anhang.

Benannter Bereich

Ein zusammenhängender Textbereich. Ein NamedRange ist eine Sammlung von Bereichen mit derselben namedRangeId. Mit benannten Bereichen können Entwickler Teile eines Dokuments mit einem beliebigen benutzerdefinierten Label verknüpfen, sodass ihr Inhalt später programmatisch gelesen oder bearbeitet werden kann. Ein Dokument kann mehrere benannte Bereiche mit demselben Namen enthalten, aber jeder benannte Bereich hat eine eindeutige ID.

Segment

Das Body, Header, Footer oder Footnote mit strukturellen oder inhaltlichen Elementen. Die Indexe der Elemente in einem Segment beziehen sich auf den Anfang des Segments.

Vorschlag

Änderungen an einem Dokument, ohne den Originaltext zu ändern. Wenn der Inhaber Ihre Vorschläge annimmt, ersetzen sie den ursprünglichen Text.

  • Weitere Informationen zum Entwickeln mit Google Workspace APIs, einschließlich der Authentifizierung und Autorisierung, finden Sie unter In Google Workspace entwickeln.

  • Einen konzeptionellen Überblick über ein Dokument finden Sie unter Document.

  • Wie Sie eine Docs API-Anwendung konfigurieren und ausführen, erfahren Sie in der JavaScript-Kurzanleitung.