- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Renvoie une ou plusieurs plages de valeurs à partir d'une feuille de calcul. L'appelant doit spécifier l'ID de la feuille de calcul et une ou plusieurs plages.
Requête HTTP
GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet
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 récupérer les données. |
Paramètres de requête
Paramètres | |
---|---|
ranges[] |
Notation A1 ou R1C1 de la plage à partir de laquelle récupérer les valeurs. |
majorDimension |
Dimension principale que les résultats doivent utiliser. Par exemple, si les données de la feuille de calcul sont: |
valueRenderOption |
Mode de représentation des valeurs dans le résultat. L'option de rendu par défaut est |
dateTimeRenderOption |
Manière dont les dates, les heures et les durées doivent être représentées dans le résultat. Cette valeur est ignorée si |
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Réponse lors de la récupération de plusieurs plages 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,
"valueRanges": [
{
object ( |
Champs | |
---|---|
spreadsheetId |
ID de la feuille de calcul à partir de laquelle les données ont été extraites. |
valueRanges[] |
Valeurs demandées. L'ordre des valeurs ValueRanges est le même que celui des plages demandées. |
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.readonly
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/spreadsheets.readonly
Pour en savoir plus, consultez le Guide relatif aux autorisations.