- 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
- MatchedValueRange
- Essayer
Renvoie une ou plusieurs plages de valeurs correspondant aux filtres de données spécifiés. L'appelant doit spécifier l'ID de la feuille de calcul, ainsi qu'un ou plusieurs DataFilters
. Les plages qui correspondent à l'un des filtres de données de la requête sont renvoyées.
Requête HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
spreadsheetId |
ID de la feuille de calcul à partir de laquelle les données doivent être récupérées. |
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[] |
Filtres de données utilisés pour établir une correspondance avec les plages de valeurs à récupérer. Les plages qui correspondent à l'un des filtres de données spécifiés sont incluses dans la réponse. |
majorDimension |
La principale dimension que les résultats doivent utiliser. Par exemple, si les données de la feuille de calcul sont |
valueRenderOption |
Comment les valeurs doivent être représentées dans la sortie. L'option de rendu par défaut est |
dateTimeRenderOption |
Comment les dates, les heures et les durées doivent être représentées dans la sortie. Cette valeur est ignorée si |
Corps de la réponse
Réponse lors de la récupération de plusieurs plages de valeurs dans une feuille de calcul sélectionnée par DataFilters
.
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,
"valueRanges": [
{
object ( |
Champs | |
---|---|
spreadsheetId |
ID de la feuille de calcul à partir de laquelle les données ont été extraites. |
valueRanges[] |
Valeurs demandées avec la liste des filtres de données qui les correspondent. |
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.
MatchedValueRange
Une plage de valeurs qui a été mise en correspondance par un ou plusieurs serveurs de données.
Représentation JSON |
---|
{ "valueRange": { object ( |
Champs | |
---|---|
valueRange |
Valeurs correspondant à |
dataFilters[] |
|