Создает пустой документ, используя заголовок, указанный в запросе. Другие поля в запросе, включая любой предоставленный контент, игнорируются.
Возвращает созданный документ.
HTTP-запрос
POST https://docs.googleapis.com/v1/documents
URL-адрес использует синтаксис транскодирования gRPC .
Тело запроса
Тело запроса содержит данные со следующей структурой:
Представление JSON |
---|
{ "documentId": string, "title": string, "body": { object ( |
Поля | |
---|---|
documentId | Только вывод. Идентификатор документа. |
title | Название документа. |
body | Только вывод. Основная часть документа. |
headers | Только вывод. Заголовки в документе, отмеченные идентификатором заголовка. |
footers | Только вывод. Нижние колонтитулы в документе, отмеченные идентификатором нижнего колонтитула. |
footnotes | Только вывод. Сноски в документе, отмеченные идентификатором сноски. |
documentStyle | Только вывод. Стиль документа. |
suggestedDocumentStyleChanges | Только вывод. Предлагаемые изменения стиля документа, отмеченные идентификатором предложения. |
namedStyles | Только вывод. Именованные стили документа. |
suggestedNamedStylesChanges | Только вывод. Предлагаемые изменения именованных стилей документа, отмеченные идентификатором предложения. |
lists | Только вывод. Списки в документе, отмеченные идентификатором списка. |
namedRanges | Только вывод. Именованные диапазоны в документе, включаемые по имени. |
revisionId | Только вывод. Идентификатор редакции документа. Может использоваться в запросах на обновление, чтобы указать, к какой версии документа применять обновления, и как должен вести себя запрос, если документ редактировался после этой версии. Заполняется только в том случае, если у пользователя есть права на редактирование документа. Идентификатор версии — это не порядковый номер, а непрозрачная строка. Формат идентификатора версии может меняться со временем. Возвращенный идентификатор версии гарантированно действителен только в течение 24 часов после его возврата и не может быть передан другим пользователям. Если идентификатор редакции не меняется между вызовами, то документ не изменился. И наоборот, измененный идентификатор (для того же документа и пользователя) обычно означает, что документ был обновлен. Однако изменение идентификатора также может быть вызвано внутренними факторами, такими как изменение формата идентификатора. |
suggestionsViewMode | Только вывод. Режим просмотра предложений, примененный к документу. Примечание. При редактировании документа изменения должны основываться на документе с |
inlineObjects | Только вывод. Встроенные объекты в документе, отмеченные идентификатором объекта. |
positionedObjects | Только вывод. Позиционированные объекты в документе, отмеченные идентификатором объекта. |
Тело ответа
В случае успеха тело ответа содержит только что созданный экземпляр Document
.
Области авторизации
Требуется одна из следующих областей действия OAuth:
-
https://www.googleapis.com/auth/documents
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
Дополнительные сведения см. в руководстве по авторизации .