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 ansprechende Dokumente aus Daten zu erstellen, die von Nutzern und Systemen bereitgestellt werden. Mit der Docs API können Sie Folgendes tun:

  • Prozesse automatisieren
  • Dokumentation im Bulk erstellen
  • Dokumente formatieren
  • Rechnungen oder Verträge erstellen
  • Bestimmte Attribute von Objekten abrufen

Im Folgenden finden Sie eine Liste häufig verwendeter Begriffe in der Docs API:

Dokument-ID

Die eindeutige Kennung für ein Dokument. Es handelt sich um einen bestimmten String mit Buchstaben, Zahlen und einigen Sonderzeichen, der auf ein Dokument verweist und aus der URL des Dokuments abgeleitet werden kann. Dokument-IDs sind 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 von 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 Unterstützte MIME-Typen in Google Workspace und Google Drive.

Index

Die meisten Elemente im Textkörper haben die Attribute startIndex und endIndex. Diese geben den Offset des Anfangs und Endes eines Elements relativ zum Anfang des umschließenden Segments an.

Inline-Bild

Ein Bild, das im Textfluss eines Dokuments angezeigt wird. Es ist kein Anhang.

Benannter Bereich

Ein zusammenhängender Textbereich. A 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 die Inhalte später programmatisch gelesen oder bearbeitet werden können. 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 Struktur- oder Inhalts-Elementen. Die Indizes der Elemente in einem Segment sind relativ zum Anfang dieses Segments.

Vorschlag

Änderungen an einem Dokument, ohne den ursprünglichen Text zu ändern. Wenn der Eigentümer des Dokuments die Änderungen annimmt, ersetzen diese den ursprünglichen Text an den entsprechenden Stellen.

  • Informationen zur Entwicklung mit Google Workspace-APIs, einschließlich der Verarbeitung von Authentifizierung und Autorisierung, finden Sie unter Entwicklung in Google Workspace.

  • Eine konzeptionelle Übersicht über ein Dokument finden Sie unter Dokument.

  • Informationen zum Konfigurieren und Ausführen einer Docs API-App finden Sie in der JavaScript-Kurzanleitung.