- Richiesta HTTP
- Parametri percorso
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Prova!
Cancella uno o più intervalli di valori da un foglio di lavoro. Il chiamante deve specificare l'ID del foglio di lavoro e uno o più intervalli. Vengono cancellati solo i valori: vengono mantenute tutte le altre proprietà della cella (come formattazione e convalida dei dati).
Richiesta HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchClear
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
spreadsheetId |
L'ID del foglio di lavoro da aggiornare. |
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "ranges": [ string ] } |
Campi | |
---|---|
ranges[] |
Gli intervalli da cancellare, in notazione A1 o notazione R1C1. |
Corpo della risposta
La risposta quando si cancella 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, "clearedRanges": [ string ] } |
Campi | |
---|---|
spreadsheetId |
Il foglio di lavoro a cui sono stati applicati gli aggiornamenti. |
clearedRanges[] |
Gli intervalli che sono stati cancellati, in notazione A1. Se le richieste riguardano un intervallo illimitato o un ranger più grande dei limiti del foglio, si tratta degli intervalli effettivi che sono stati cancellati, limitati 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.