Omówienie interfejsu API Dokumentów Google

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

Aplikacje mogą się integrować z interfejsem Docs API, aby tworzyć dopracowane dokumenty na podstawie danych użytkownika i danych dostarczanych przez 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 typowych terminów używanych w interfejsie Docs API:

Identyfikator dokumentu

Unikalny identyfikator dokumentu. Jest to określony ciąg znaków zawierający litery, cyfry i niektóre znaki specjalne, który odwołuje się do dokumentu i może być utworzony na podstawie adresu URL dokumentu. Identyfikatory dokumentów są stabilne, 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, z której składa się dokument. Elementy najwyższego poziomu w dokumencie to Body, DocumentStyle i List.

dokument w Google Workspace,

Plik utworzony przez aplikację Google Workspace, taką jak 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. Wskazują one przesunięcie początku i końca elementu względem początku otaczającego go segmentu.

Obraz wbudowany

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. Zakresy o nazwie umożliwiają deweloperom kojarzenie części dokumentu z dowolną etykietą zdefiniowaną przez użytkownika, dzięki czemu ich zawartość może być odczytywana lub edytowana za pomocą kodu. Dokument może zawierać wiele zakresów nazwanych o tej samej nazwie, ale każdy z nich ma unikalny identyfikator.

Segment

Elementy Body, Header, Footer lub Footnote zawierające elementy strukturalne lub treści. Indeksy elementów w danym segmencie są podawane względem początku tego segmentu.

Proponowana zmiana

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