Method: spreadsheets.values.batchClearByDataFilter

Efface une ou plusieurs plages de valeurs d'une feuille de calcul. L'appelant doit spécifier l'ID de la feuille de calcul et un ou plusieurs DataFilters. Les plages correspondant à l'un des filtres de données spécifiés seront effacées. Seules les valeurs sont effacées : toutes les autres propriétés de la cellule (mise en forme, validation des données, etc.) sont conservées.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
spreadsheetId

string

ID de la feuille de calcul à mettre à jour.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "dataFilters": [
    {
      object (DataFilter)
    }
  ]
}
Champs
dataFilters[]

object (DataFilter)

DataFilters utilisé pour déterminer les plages à effacer.

Corps de la réponse

Réponse lors de l'effacement d'une plage de valeurs sélectionnées avec DataFilters dans une feuille de calcul.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "spreadsheetId": string,
  "clearedRanges": [
    string
  ]
}
Champs
spreadsheetId

string

Feuille de calcul à laquelle les mises à jour ont été appliquées.

clearedRanges[]

string

Plages effacées, au format A1 Si les requêtes concernent une plage illimitée ou un ranger dont les limites sont supérieures aux limites de la feuille, il s'agit des plages réelles qui ont été effacées, limitées aux limites de la feuille.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez le Guide relatif aux autorisations.