Method: spreadsheets.values.clear

Limpa os valores de uma planilha. O autor da chamada deve 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 ID da planilha a ser atualizada.

range

string

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

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 em que as atualizações foram aplicadas.

clearedRange

string

O intervalo (na notação A1) que foi apagado. Se a solicitação foi para um intervalo ilimitado ou um intervalo maior do que os limites da página, esse será o intervalo real que foi apagado, limitado aos limites da página.

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.