Method: spreadsheets.values.batchGet

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

HTTP-запрос

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

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

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

Параметры
spreadsheetId

string

Идентификатор электронной таблицы, из которой извлекаются данные.

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

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

string

Обозначение A1 или обозначение R1C1 диапазона, из которого извлекаются значения.

majorDimension

enum ( Dimension )

Основное измерение, которое следует использовать в результатах.

Например, если данные электронной таблицы: A1=1,B1=2,A2=3,B2=4 , то запрос ranges=["A1:B2"],majorDimension=ROWS возвращает [[1,2],[3,4]] , тогда как запрос ranges=["A1:B2"],majorDimension=COLUMNS возвращает [[1,3],[2,4]] .

valueRenderOption

enum ( ValueRenderOption )

Как значения должны быть представлены в выходных данных. Опция рендеринга по умолчанию — ValueRenderOption.FORMATTED_VALUE .

dateTimeRenderOption

enum ( DateTimeRenderOption )

Как даты, время и продолжительность должны быть представлены в выходных данных. Это игнорируется, если valueRenderOption имеет FORMATTED_VALUE . Опция рендеринга dateTime по умолчанию — SERIAL_NUMBER .

Тело запроса

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

Тело ответа

Ответ при получении более одного диапазона значений в электронной таблице.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (ValueRange)
    }
  ]
}
Поля
spreadsheetId

string

Идентификатор таблицы, из которой были получены данные.

valueRanges[]

object ( ValueRange )

Запрошенные значения. Порядок ValueRanges такой же, как порядок запрошенных диапазонов.

Области авторизации

Требуется одна из следующих областей 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

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