Удаляет один или несколько диапазонов значений из электронной таблицы. Вызывающий должен указать идентификатор электронной таблицы и один или несколько диапазонов. Очищаются только значения — все остальные свойства ячейки (например, форматирование и проверка данных) сохраняются.
HTTP-запрос
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClear
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
spreadsheetId | Идентификатор электронной таблицы для обновления. |
Тело запроса
Тело запроса содержит данные со следующей структурой:
Представление JSON |
---|
{ "ranges": [ string ] } |
Поля | |
---|---|
ranges[] | Диапазоны для очистки в нотации A1 или R1C1 . |
Тело ответа
Ответ при очистке диапазона значений в электронной таблице.
В случае успеха тело ответа содержит данные со следующей структурой:
Представление JSON |
---|
{ "spreadsheetId": string, "clearedRanges": [ string ] } |
Поля | |
---|---|
spreadsheetId | Электронная таблица, к которой были применены обновления. |
clearedRanges[] | Диапазоны, которые были очищены, в нотации A1. Если запросы относятся к неограниченному диапазону или диапазону больше, чем границы листа, это фактические диапазоны, которые были очищены, ограничены пределами листа. |
Области авторизации
Требуется одна из следующих областей действия OAuth:
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
-
https://www.googleapis.com/auth/spreadsheets
Дополнительные сведения см. в руководстве по авторизации .