Omówienie interfejsu API Dokumentów Google

Interfejs Google Docs API umożliwia tworzenie i modyfikowanie dokumentów w Dokumentach Google.

Aplikacje mogą integrować się z interfejsem Docs API, aby tworzyć dopracowane dokumenty na podstawie danych dostarczonych przez użytkownika i system. Interfejs Docs API umożliwia:

  • Automatyzacja procesów
  • Zbiorcze tworzenie dokumentacji
  • Formatowanie dokumentów
  • generować faktury lub umowy,
  • Pobieranie określonych atrybutów obiektów

Oto lista najczęstszych terminów używanych w interfejsie Docs API:

Identyfikator dokumentu

Unikalny identyfikator dokumentu. Jest to ciąg znaków zawierający litery, cyfry i niektóre znaki specjalne, który odnosi się do dokumentu i może być wyodrębniony z jego adresu URL. Identyfikatory dokumentów są stałe, nawet jeśli nazwa dokumentu ulegnie zmianie. Więcej informacji o tym, jak znaleźć identyfikator, znajdziesz w artykule Identyfikator dokumentu.

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

Struktura, która tworzy dokument. Elementy najwyższego poziomu dokumentu to Body, DocumentStyle i List.

Dokument Google Workspace

Plik utworzony przez aplikację Google Workspace, np. Dokumenty Google. Format typu MIME w przypadku Dokumentów to application/vnd.google-apps.document. Listę typów MIME znajdziesz w artykule Obsługiwane typy MIME w Google Workspace i na Dysku Google.

Indeks

Większość elementów w treści ma właściwości startIndex i endIndex. Określają one przesunięcie początku i końca elementu względem początku otaczającego go segmentu.

Obraz w treści

Obraz, który pojawia się w tekście dokumentu. Nie jest to załącznik.

Zakres nazwany

Ciągły zakres tekstu. NamedRange to zbiór zakresów o tym samym namedRangeId. Nazwane zakresy umożliwiają deweloperom powiązanie części dokumentu z dowolną etykietą zdefiniowaną przez użytkownika, dzięki czemu zawartość można później odczytywać lub edytować automatycznie. Dokument może zawierać wiele zakresów nazwanych o tej samej nazwie, ale każdy zakres nazwany ma unikalny identyfikator.

Segment

Element Body, Header, Footer lub Footnote zawierający elementy strukturalne lub treści. Indeksy elementów w segmencie są określane względem początku tego segmentu.

Sugestia

zmiany w dokumencie bez edytowania oryginalnego tekstu. Jeśli właściciel zatwierdzi Twoje sugestie, zastąpią one oryginalny tekst.