Method: spreadsheets.values.clear

Cancella i valori da un foglio di lavoro. L'utente che chiama deve specificare l'ID e l'intervallo del foglio di lavoro. Vengono cancellati solo i valori, mentre tutte le altre proprietà della cella (ad esempio formattazione, convalida dei dati e così via) vengono conservate.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
spreadsheetId

string

L'ID del foglio di lavoro da aggiornare.
range

string

La notazione A1 o R1C1 dei valori da cancellare.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

La risposta quando viene cancellato un intervallo di valori in un foglio di lavoro.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "spreadsheetId": string,
  "clearedRange": string
}
Campi
spreadsheetId

string

Il foglio di lavoro a cui sono stati applicati gli aggiornamenti.
clearedRange

string

L'intervallo (in notazione A1) che è stato cancellato. Se la richiesta riguardava un intervallo illimitato o un intervallo più grande dei limiti del foglio, questo sarà l'intervallo effettivo che è stato cancellato, limitato ai limiti del foglio.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.