Method: spreadsheets.values.batchClear

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 une ou plusieurs plages. 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:batchClear

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 
{
  "ranges": [
    string
  ]
}
Champs
ranges[]

string

Plages à effacer, au format A1 ou R1C1.

Corps de la réponse

Réponse lors de l'effacement d'une plage de valeurs 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.