Method: spreadsheets.values.get

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

HTTP-запрос

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

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

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

Параметры
spreadsheetId

string

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

range

string

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

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

Параметры
majorDimension

enum ( Dimension )

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

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

valueRenderOption

enum ( ValueRenderOption )

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

dateTimeRenderOption

enum ( DateTimeRenderOption )

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

Тело запроса

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

Тело ответа

В случае успеха тело ответа содержит экземпляр ValueRange .

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

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

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