- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- Соответствующий диапазон значений
- Попробуйте!
Возвращает один или несколько диапазонов значений, соответствующих указанным фильтрам данных. Вызывающая сторона должна указать идентификатор электронной таблицы и один или несколько DataFilters
. Будут возвращены диапазоны, соответствующие любому из фильтров данных в запросе.
HTTP-запрос
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
spreadsheetId | Идентификатор электронной таблицы, из которой извлекаются данные. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "dataFilters": [ { object ( |
Поля | |
---|---|
dataFilters[] | Фильтры данных, используемые для сопоставления диапазонов извлекаемых значений. В ответ включаются диапазоны, соответствующие любому из указанных фильтров данных. |
majorDimension | Основное измерение, которое следует использовать в результатах. Например, если данные электронной таблицы: |
valueRenderOption | Как значения должны быть представлены в выходных данных. Опция рендеринга по умолчанию — |
dateTimeRenderOption | Как даты, время и продолжительность должны быть представлены в выходных данных. Это игнорируется, если |
Тело ответа
Ответ при получении более одного диапазона значений в электронной таблице, выбранной DataFilters
.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
Поля | |
---|---|
spreadsheetId | Идентификатор таблицы, из которой были получены данные. |
valueRanges[] | Запрошенные значения со списком соответствующих им фильтров данных. |
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
-
https://www.googleapis.com/auth/spreadsheets
Дополнительную информацию см. в руководстве по авторизации .
Соответствующий диапазон значений
Диапазон значений, которому соответствует один или несколько средств подачи данных.
JSON-представление |
---|
{ "valueRange": { object ( |
Поля | |
---|---|
valueRange | Значения, соответствующие |
dataFilters[] | |
- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- Соответствующий диапазон значений
- Попробуйте!
Возвращает один или несколько диапазонов значений, соответствующих указанным фильтрам данных. Вызывающая сторона должна указать идентификатор электронной таблицы и один или несколько DataFilters
. Будут возвращены диапазоны, соответствующие любому из фильтров данных в запросе.
HTTP-запрос
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
spreadsheetId | Идентификатор электронной таблицы, из которой извлекаются данные. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "dataFilters": [ { object ( |
Поля | |
---|---|
dataFilters[] | Фильтры данных, используемые для сопоставления диапазонов извлекаемых значений. В ответ включаются диапазоны, соответствующие любому из указанных фильтров данных. |
majorDimension | Основное измерение, которое следует использовать в результатах. Например, если данные электронной таблицы: |
valueRenderOption | Как значения должны быть представлены в выходных данных. Опция рендеринга по умолчанию — |
dateTimeRenderOption | Как даты, время и продолжительность должны быть представлены в выходных данных. Это игнорируется, если |
Тело ответа
Ответ при получении более одного диапазона значений в электронной таблице, выбранной DataFilters
.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
Поля | |
---|---|
spreadsheetId | Идентификатор таблицы, из которой были получены данные. |
valueRanges[] | Запрошенные значения со списком соответствующих им фильтров данных. |
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
-
https://www.googleapis.com/auth/spreadsheets
Дополнительную информацию см. в руководстве по авторизации .
Соответствующий диапазон значений
Диапазон значений, которому соответствует один или несколько средств подачи данных.
JSON-представление |
---|
{ "valueRange": { object ( |
Поля | |
---|---|
valueRange | Значения, соответствующие |
dataFilters[] | |