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

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