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 (comme la mise en forme et la validation des données) 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

Les plages à effacer, au format A1 ou R1C1.

Corps de la réponse

Réponse lorsque vous effacez 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 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.