Method: spreadsheets.get

Возвращает электронную таблицу по заданному идентификатору. Идентификатор электронной таблицы должен быть указан вызывающей стороной.

По умолчанию данные внутри таблиц не возвращаются. Вы можете включить данные в таблицу одним из двух способов:

  • Укажите маску полей , содержащую список необходимых полей, используя параметр URL-адреса fields в HTTP.

  • Установите параметр URL includeGridData в значение true. Если задана маска поля, параметр includeGridData игнорируется.

При работе с большими электронными таблицами рекомендуется извлекать только те поля, которые вам нужны.

Чтобы получить только подмножества данных из электронной таблицы, используйте параметр URL ranges . Диапазоны указываются с помощью обозначения A1 . Вы можете определить одну ячейку (например, A1 ) или несколько ячеек (например, A1:D5 ). Вы также можете получить ячейки из других листов в той же электронной таблице (например, Sheet2!A1:C4 ) или получить несколько диапазонов одновременно (например, ?ranges=A1:D5&ranges=Sheet2!A1:C4 ). Ограничение диапазона возвращает только те части электронной таблицы, которые пересекаются с запрошенными диапазонами.

HTTP-запрос

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}

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

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

Параметры
spreadsheetId

string

Электронную таблицу для запроса.

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

Параметры
ranges[]

string

Диапазоны, которые необходимо извлечь из электронной таблицы.

includeGridData

boolean

Возвращает значение true, если должны быть возвращены данные сетки. Этот параметр игнорируется, если в запросе была задана маска поля.

excludeTablesInBandedRanges

boolean

Значение True, если таблицы следует исключать из диапазонов. Значение False, если значение не задано.

commentsViewMode

enum ( CommentsViewMode )

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

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

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

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

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

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

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

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

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