Method: spreadsheets.values.batchClear

Limpa um ou mais intervalos de valores de uma planilha. O usuário precisa especificar o ID da planilha e um ou mais intervalos. Somente os valores são limpos. Todas as outras propriedades da célula, como formatação e validação de dados, são mantidas.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
spreadsheetId

string

O ID da planilha a ser atualizada.

Corpo da solicitação

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

Representação JSON 
{
  "ranges": [
    string
  ]
}
Campos
ranges[]

string

Os intervalos a serem limpos, na notação A1 ou R1C1.

Corpo da resposta

A resposta ao limpar um intervalo de valores 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 em que as atualizações foram aplicadas.
clearedRanges[]

string

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

Escopos de autorização

Requer um dos seguintes escopos do 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.