Method: spreadsheets.values.batchClearByDataFilter

Очищает один или несколько диапазонов значений в электронной таблице. Дополнительную информацию см. в разделе «Чтение, запись и поиск метаданных» .

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

HTTP-запрос

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

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

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

Параметры
spreadsheetId

string

Идентификатор электронной таблицы, которую необходимо обновить.

Текст запроса

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

JSON-представление 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Поля
dataFilters[]

object ( DataFilter )

Фильтры DataFilters используются для определения того, какие диапазоны следует очистить.

Ответный текст

Результат очистки диапазона значений, выбранных с помощью DataFilters в электронной таблице.

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

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

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