Method: documents.get

Получает последнюю версию указанного документа.

HTTP-запрос

GET https://docs.googleapis.com/v1/documents/{documentId}

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
documentId

string

Идентификатор документа, который необходимо получить.

Параметры запроса

Параметры
suggestionsViewMode

enum ( SuggestionsViewMode )

Режим просмотра предложений, применяемый к документу. Это позволяет просматривать документ со всеми предложениями, отображаемыми непосредственно в тексте, а также с принятыми или отклоненными предложениями. Если режим не указан, используется DEFAULT_FOR_CURRENT_ACCESS .

includeTabsContent

boolean

Whether to populate the Document.tabs field instead of the text content fields like body and documentStyle on Document .

  • Если true : содержимое документа заполняется в поле Document.tabs вместо текстовых полей в Document .

  • Если false : содержимое первой вкладки документа заполняет поля содержимого в Document , за исключением Document.tabs . Если документ имеет только одну вкладку, то для заполнения содержимого документа используется эта вкладка. Document.tabs будет пустым.

Если вы используете маску поля, которая ссылается на поле Document.tabs (или любое подполе), API неявно обрабатывает запрос так, как если бы вы установили includeTabsContent в true .

commentsViewMode

enum ( CommentsViewMode )

The comments view mode to apply to the document. This allows viewing the document with comments omitted or included. If one is not specified, COMMENTS_VIEW_MODE_OMITTED is used.

Если вы задаете commentsViewMode какое-либо значение, вам также необходимо установить includeTabsContent в true или использовать маску поля, которая ссылается на поле Document.tabs (или любое подполе).

Если вы установите commentsViewMode в значение COMMENTS_VIEW_MODE_INCLUDED , вам также необходимо явно установить suggestionsViewMode в значение SUGGESTIONS_INLINE .

Если вы установите commentsViewMode в значение COMMENTS_VIEW_MODE_INCLUDED или COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS , вы не сможете установить suggestionsViewMode в значение PREVIEW_WITHOUT_SUGGESTIONS или PREVIEW_SUGGESTIONS_ACCEPTED .

Текст запроса

Тело запроса должно быть пустым.

Ответный текст

В случае успеха тело ответа содержит экземпляр объекта Document .

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

  • https://www.googleapis.com/auth/documents
  • https://www.googleapis.com/auth/documents.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.file

Для получения более подробной информации см. руководство по авторизации .