Method: spreadsheets.values.clear

Efface les valeurs d'une feuille de calcul. L'appelant doit spécifier l'ID et la plage de la feuille de calcul. 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/{range}:clear

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.

range

string

Notation A1 ou R1C1 des valeurs à effacer.

Corps de la requête

Le corps de la requête doit être vide.

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,
  "clearedRange": string
}
Champs
spreadsheetId

string

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

clearedRange

string

Plage (au format A1) qui a été effacée. (Si la requête portait sur une plage illimitée ou un ranger plus grand que les limites de la feuille, il s'agit de la plage réelle qui a été effacée, limitée 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.