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 (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/{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

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

string

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

string

Plage (au format A1) effacée. (Si la requête concernait une plage illimitée ou une plage plus large que les limites de la feuille, il s'agit de la plage ayant été effacée, 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.