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

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