Обзор API Документов Google

API Google Docs позволяет создавать и изменять документы в Google Docs.

Приложения могут интегрироваться с API Docs для создания качественных документов на основе данных, предоставленных как пользователем, так и системой. API Docs позволяет:

  • Автоматизация процессов
  • Создавайте документацию в пакетном режиме.
  • Форматирование документов
  • Создавайте счета-фактуры или договоры.
  • Получение конкретных атрибутов объектов

Ниже приведён список часто используемых терминов в API документации:

Идентификатор документа

Уникальный идентификатор документа. Это определенная строка, содержащая буквы, цифры и некоторые специальные символы, которые ссылаются на документ, и ее можно получить из URL-адреса документа. Идентификаторы документов остаются неизменными, даже если имя документа меняется. Для получения дополнительной информации о том, как найти идентификатор, см. раздел «Идентификатор документа» .

https://docs.google.com/document/d/DOCUMENT_ID/edit
Элемент

Структура, из которой состоит документ. К элементам верхнего уровня документа относятся: Body , DocumentStyle ) и List .

Документ Google Workspace

Файл, создаваемый приложением Google Workspace, например Google Docs. Формат MIME-типа для Docs — application/vnd.google-apps.document . Список поддерживаемых MIME-типов см. в разделе «Поддерживаемые MIME-типы Google Workspace и Google Drive» .

Индекс

Большинство элементов внутри основного содержимого имеют свойства startIndex и endIndex . Они указывают смещение начала и конца элемента относительно начала окружающего его сегмента .

Встроенное изображение

Изображение, которое появляется в тексте документа. Это не вложение.

Именованный диапазон

Непрерывный диапазон текста. NamedRange — это набор диапазонов с одинаковым namedRangeId . Именованные диапазоны позволяют разработчикам связывать части документа с произвольной пользовательской меткой, чтобы их содержимое можно было программно считывать или редактировать позже. Документ может содержать несколько именованных диапазонов с одинаковым именем, но каждый именованный диапазон имеет уникальный идентификатор (ID).

Сегмент

Body , Header , Footer или Footnote , содержащие структурные или содержательные элементы . Индексы элементов внутри сегмента указываются относительно начала этого сегмента.

Предположение

Внесение изменений в документ без изменения исходного текста. Если владелец одобрит ваши предложения, они заменят исходный текст.