- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- Попробуйте!
Устанавливает значения в одном или нескольких диапазонах электронной таблицы. Вызывающая сторона должна указать идентификатор электронной таблицы, valueInputOption
и один или несколько DataFilterValueRanges
.
HTTP-запрос
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
spreadsheetId | Идентификатор таблицы, которую необходимо обновить. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "valueInputOption": enum ( |
Поля | |
---|---|
valueInputOption | Как следует интерпретировать входные данные. |
data[] | Новые значения, которые будут применены к электронной таблице. Если указанному |
includeValuesInResponse | Определяет, должен ли ответ на обновление включать значения обновленных ячеек. По умолчанию ответы не включают обновленные значения. Поле |
responseValueRenderOption | Определяет, как должны отображаться значения в ответе. Опция рендеринга по умолчанию — |
responseDateTimeRenderOption | Определяет, как должны отображаться даты, время и продолжительность в ответе. Это игнорируется, если |
Тело ответа
Ответ при обновлении диапазона значений в электронной таблице.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"spreadsheetId": string,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
Поля | |
---|---|
spreadsheetId | Таблица, к которой были применены обновления. |
totalUpdatedRows | Общее количество строк, в которых была обновлена хотя бы одна ячейка. |
totalUpdatedColumns | Общее количество столбцов, в которых была обновлена хотя бы одна ячейка. |
totalUpdatedCells | Общее количество обновленных ячеек. |
totalUpdatedSheets | Общее количество листов, на которых была обновлена хотя бы одна ячейка листа. |
responses[] | Ответ для каждого диапазона обновлен. |
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
-
https://www.googleapis.com/auth/spreadsheets
Дополнительную информацию см. в руководстве по авторизации .
DataFilterValueRange
Диапазон значений, расположение которых определяется DataFilter
.
JSON-представление |
---|
{ "dataFilter": { object ( |
Поля | |
---|---|
dataFilter | Фильтр данных, описывающий расположение значений в электронной таблице. |
majorDimension | Основное измерение ценностей. |
values[] | Данные, которые необходимо записать. Если предоставленные значения превышают любой из диапазонов, соответствующих фильтру данных, запрос не выполняется. Если предоставленные значения меньше совпадающих диапазонов, записываются только указанные значения, существующие значения в совпадающих диапазонах остаются неизменными. |
UpdateValuesByDataFilterResponse
Ответ при обновлении диапазона значений с помощью фильтра данных в электронной таблице.
JSON-представление |
---|
{ "updatedRange": string, "updatedRows": integer, "updatedColumns": integer, "updatedCells": integer, "dataFilter": { object ( |
Поля | |
---|---|
updatedRange | Диапазон (в нотации A1 ), к которому были применены обновления. |
updatedRows | Количество строк, в которых была обновлена хотя бы одна ячейка. |
updatedColumns | Количество столбцов, в которых была обновлена хотя бы одна ячейка. |
updatedCells | Количество обновленных ячеек. |
dataFilter | Фильтр данных, выбравший обновленный диапазон. |
updatedData | Значения ячеек в диапазоне, сопоставленном dataFilter после применения всех обновлений. Это включается только в том случае, если поле |
- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- Попробуйте!
Устанавливает значения в одном или нескольких диапазонах электронной таблицы. Вызывающая сторона должна указать идентификатор электронной таблицы, valueInputOption
и один или несколько DataFilterValueRanges
.
HTTP-запрос
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
spreadsheetId | Идентификатор таблицы, которую необходимо обновить. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "valueInputOption": enum ( |
Поля | |
---|---|
valueInputOption | Как следует интерпретировать входные данные. |
data[] | Новые значения, которые будут применены к электронной таблице. Если указанному |
includeValuesInResponse | Определяет, должен ли ответ на обновление включать значения обновленных ячеек. По умолчанию ответы не включают обновленные значения. Поле |
responseValueRenderOption | Определяет, как должны отображаться значения в ответе. Опция рендеринга по умолчанию — |
responseDateTimeRenderOption | Определяет, как должны отображаться даты, время и продолжительность в ответе. Это игнорируется, если |
Тело ответа
Ответ при обновлении диапазона значений в электронной таблице.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"spreadsheetId": string,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
Поля | |
---|---|
spreadsheetId | Таблица, к которой были применены обновления. |
totalUpdatedRows | Общее количество строк, в которых была обновлена хотя бы одна ячейка. |
totalUpdatedColumns | Общее количество столбцов, в которых была обновлена хотя бы одна ячейка. |
totalUpdatedCells | Общее количество обновленных ячеек. |
totalUpdatedSheets | Общее количество листов, на которых была обновлена хотя бы одна ячейка листа. |
responses[] | Ответ для каждого диапазона обновлен. |
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
-
https://www.googleapis.com/auth/spreadsheets
Дополнительную информацию см. в руководстве по авторизации .
DataFilterValueRange
Диапазон значений, расположение которых определяется DataFilter
.
JSON-представление |
---|
{ "dataFilter": { object ( |
Поля | |
---|---|
dataFilter | Фильтр данных, описывающий расположение значений в электронной таблице. |
majorDimension | Основное измерение ценностей. |
values[] | Данные, которые необходимо записать. Если предоставленные значения превышают любой из диапазонов, соответствующих фильтру данных, запрос не выполняется. Если предоставленные значения меньше совпадающих диапазонов, записываются только указанные значения, существующие значения в совпадающих диапазонах остаются неизменными. |
UpdateValuesByDataFilterResponse
Ответ при обновлении диапазона значений с помощью фильтра данных в электронной таблице.
JSON-представление |
---|
{ "updatedRange": string, "updatedRows": integer, "updatedColumns": integer, "updatedCells": integer, "dataFilter": { object ( |
Поля | |
---|---|
updatedRange | Диапазон (в нотации A1 ), к которому были применены обновления. |
updatedRows | Количество строк, в которых была обновлена хотя бы одна ячейка. |
updatedColumns | Количество столбцов, в которых была обновлена хотя бы одна ячейка. |
updatedCells | Количество обновленных ячеек. |
dataFilter | Фильтр данных, выбравший обновленный диапазон. |
updatedData | Значения ячеек в диапазоне, сопоставленном dataFilter после применения всех обновлений. Это включается только в том случае, если поле |