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

Для получения более подробной информации см. руководство по авторизации .