Method: spreadsheets.values.batchClearByDataFilter

Cancella uno o più intervalli di valori da un foglio di lavoro. Per saperne di più, consulta Leggere, scrivere ed eseguire ricerche nei metadati.

Il chiamante deve specificare l'ID foglio di lavoro e uno o più DataFilters. Gli intervalli corrispondenti a uno qualsiasi dei filtri dei dati specificati verranno cancellati. Vengono cancellati solo i valori, mentre tutte le altre proprietà della cella (come formattazione, convalida dei dati e così via) vengono mantenute.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
spreadsheetId

string

L'ID del foglio di lavoro da aggiornare.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Campi
dataFilters[]

object (DataFilter)

Il DataFilters utilizzato per determinare gli intervalli da cancellare.

Corpo della risposta

La risposta quando si cancella un intervallo di valori selezionato con DataFilters 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

string

Il foglio di lavoro a cui sono stati applicati gli aggiornamenti.
clearedRanges[]

string

Gli intervalli cancellati, in notazione A1. Se le richieste riguardano un intervallo illimitato o un intervallo più grande dei limiti del foglio, questi sono gli 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.