Method: spreadsheets.values.batchClearByDataFilter

Limpa um ou mais intervalos de valores de uma planilha. O autor da chamada precisa especificar o ID da planilha e um ou mais DataFilters. Os intervalos correspondentes a qualquer um dos filtros de dados especificados serão apagados. Somente os valores são apagados. Todas as outras propriedades da célula (como formatação, validação de dados, etc.) são mantidas.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
spreadsheetId

string

O código da planilha a ser atualizada.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Campos
dataFilters[]

object (DataFilter)

O DataFilters usado para determinar quais intervalos precisam ser apagados.

Corpo da resposta

A resposta ao limpar um intervalo de valores selecionados com DataFilters em uma planilha.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "spreadsheetId": string,
  "clearedRanges": [
    string
  ]
}
Campos
spreadsheetId

string

A planilha à qual as atualizações foram aplicadas.
clearedRanges[]

string

Os intervalos que foram apagados, na notação A1. Se as solicitações forem para um intervalo ilimitado ou um intervalo maior que os limites da página, esses serão os intervalos reais que foram apagados e limitados aos limites da página.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

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

Para mais informações, consulte o Guia de autorização.