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

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

Тело запроса

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

Тело ответа

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

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