- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
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 |
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 ( |
Champs | |
---|---|
dataFilters[] |
|
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 |
Feuille de calcul à laquelle les mises à jour ont été appliquées. |
clearedRanges[] |
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.