Method: spreadsheets.values.batchClear

Удаляет один или несколько диапазонов значений из электронной таблицы. Вызывающий должен указать идентификатор электронной таблицы и один или несколько диапазонов. Очищаются только значения — все остальные свойства ячейки (например, форматирование и проверка данных) сохраняются.

HTTP-запрос

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClear

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

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

Параметры
spreadsheetId

string

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

Тело запроса

Тело запроса содержит данные со следующей структурой:

Представление JSON
{
  "ranges": [
    string
  ]
}
Поля
ranges[]

string

Диапазоны для очистки в нотации A1 или R1C1 .

Тело ответа

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

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

Представление JSON
{
  "spreadsheetId": string,
  "clearedRanges": [
    string
  ]
}
Поля
spreadsheetId

string

Электронная таблица, к которой были применены обновления.

clearedRanges[]

string

Диапазоны, которые были очищены, в нотации A1. Если запросы относятся к неограниченному диапазону или диапазону больше, чем границы листа, это фактические диапазоны, которые были очищены, ограничены пределами листа.

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

Требуется одна из следующих областей действия OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

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