- HTTP-запрос
- Параметры пути
- Параметры запроса
- Тело запроса
- Тело ответа
- Области авторизации
- Попробуй это!
Возвращает электронную таблицу с заданным идентификатором. Вызывающий должен указать идентификатор электронной таблицы.
По умолчанию данные в сетках не возвращаются. Вы можете включить данные сетки одним из двух способов:
Укажите маску поля , в которой перечислены нужные поля, используя параметр 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 | Электронная таблица для запроса. |
Параметры запроса
Параметры | |
---|---|
ranges[] | Диапазоны для извлечения из электронной таблицы. |
includeGridData | Истинно, если должны быть возвращены данные сетки. Этот параметр игнорируется, если в запросе была задана маска поля. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа содержит экземпляр 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
Дополнительные сведения см. в руководстве по авторизации .