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

Следует ли заполнять поле Document.tabs вместо текстовых полей содержимого, таких как body и documentStyle в Document .

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

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

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

commentsViewMode

enum ( CommentsViewMode )

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

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

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

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

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

В случае успеха тело ответа содержит экземпляр объекта 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

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