Method: spreadsheets.values.clear

Limpa os valores de uma planilha. O autor da chamada precisa especificar o ID e o intervalo da planilha. 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/{range}:clear

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.
range

string

A notação A1 ou R1C1 dos valores a serem limpos.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

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,
  "clearedRange": string
}
Campos
spreadsheetId

string

A planilha à qual as atualizações foram aplicadas.
clearedRange

string

O intervalo (em notação A1) que foi apagado. Se a solicitação foi para um intervalo ilimitado ou um intervalo maior que os limites da página, esse será o intervalo real que foi desafixado, de acordo com os 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.