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, если данные сетки должны быть возвращены. Этот параметр игнорируется, если в запросе была установлена ​​маска поля.

Тело запроса

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

Тело ответа

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

Дополнительную информацию см. в руководстве по авторизации .