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 (comme la mise en forme, la 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 affichée lorsque vous effacez 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 garde plus large que les limites de la feuille, il s'agit des plages réelles qui ont été effacées, dans les 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 sur les autorisations.