Cet article vous explique comment connecter Iterop à Google Sheet.
Côté Google
- Rendez-vous dans le module de gestion des API de Google : https://console.developers.google.com/apis/library
- Autorisez l’utilisation de l’API Google Sheet.
Côté Iterop
- Rendez-vous dans Iterop Deisgn dans l’onglet « Services ».
- Créez un nouveau service avec la base de l’URL : https://sheets.googleapis.com/

Remplissez les champs comme suit :
- Redirect URL : http://localhost
- Authorize token URL : https://accounts.google.com/o/oauth2/auth?access_type=offline&approval_prompt=force
- Access token URL : https://accounts.google.com/o/oauth2/token
- Scope désiré : https://www.googleapis.com/auth/spreadsheets
Cliquez sur valider pour avoir le state et le code dans l’URL de la page.
Ecrire une (ou plusieurs) valeur dans votre sheet
Aide Google : https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/append
Configuration

- Méthode : POST
- Path : v4/spreadsheets/${spreadsheetId}/values/${range}:append
Variable dans le path
Variable |
Possibilité |
Fonction |
includeValuesInResponse |
True |
Inclus les valeurs dans la réponse |
False |
N’inclus pas les valeurs dans la réponse |
|
valueInputOption |
RAW |
Les valeurs seront stockées telles quelles |
USER_ENTERED |
Les valeurs seront interprétées |
|
insertDataOption |
OVERWRITE |
N’insère pas de ligne |
INSERT_ROWS |
Insère une ligne |
|
responseValueRenderOption |
FORMATTED_VALUE |
Valeur formatée dans la réponse (calcul effectué) |
UNFORMATTED_VALUE |
Valeur non formatée dans la réponse (calcul non effectué) |
|
FORMULA |
Retourne les formules |
|
responseDateTimeRenderOption |
SERIAL_NUMBER |
Date sous format nombre (utilisé pour Lotus) |
FORMATTED_STRING |
Date sous format string |
Body
{ « range »: « ${range} »,
« majorDimension »: « DIMENSION_UNSPECIFIED »,
« values »: [
« ${value} »
]
}
Données d’exécutions

- SpreadsheetId est la partie de l’URL du google sheet entre /d/ et /edit
- Exemple : si l’URL est : https://docs.google.com/spreadsheets/d/11vp8HYKDm865236fRZpwIAdgdkiJx9EcXDOsMHSQ/edit#gid=387179624 alors SpreadsheetId : 11vp8HYKDm865236fRZpwIAdgdkiJx9EcXDOsMHSQ
- Range : le nom de la feuille n’est pas obligatoire si il n’y en a qu’une.
- Value : soit valeur seul sous la forme [« A »] ( possibilité de mettre A mais dans le body mettre [« ${value} »]) soit de la forme [« A », « B », »C »],[« X », »Y », »Z »] qui donnera
A | B | C |
X | Y | Z |
Réponse
Il est possible de récupérer la réponse dans un JSON.

Modifier une (ou plusieurs) valeur dans sheet
Aide Google : https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/update
Configuration

- Méthode : PUT
- Path : v4/spreadsheets/${spreadsheetId}/values/${range}
Variable dans le path
Variable |
Possibilité |
Fonction |
includeValuesInResponse |
True |
Inclus les valeurs dans la réponse |
False |
N’inclus pas les valeurs dans la réponse |
|
valueInputOption |
RAW |
Les valeurs seront stockées telles quelles |
USER_ENTERED |
Les valeurs seront interprétées |
|
responseValueRenderOption |
FORMATTED_VALUE |
Valeur formatée dans la réponse (calcul effectué) |
UNFORMATTED_VALUE |
Valeur non formatée dans la réponse (calcul non effectué) |
|
FORMULA |
Retourne les formules |
|
responseDateTimeRenderOption |
SERIAL_NUMBER |
Date sous format nombre (utilisé pour Lotus) |
FORMATTED_STRING |
Date sous format string |
Body
{ « range »: « ${range} »,
« majorDimension »: « DIMENSION_UNSPECIFIED »,
« values »: [
« ${value} »
]
}
Données d’exécutions

- SpreadsheetId est la partie de l’URL du google sheet entre /d/ et /edit
- Exemple : si l’URL est : https://docs.google.com/spreadsheets/d/11vp8HYKDm865236fRZpwIAdgdkiJx9EcXDOsMHSQ/edit#gid=387179624 alors SpreadsheetId : 11vp8HYKDm865236fRZpwIAdgdkiJx9EcXDOsMHSQ
- Range : le nom de la feuille n’est pas obligatoire si il n’y en a qu’une.
- Value : soit valeur seul sous la forme [« A »] ( possibilité de mettre A mais dans le body mettre [« ${value} »] ) soit de la forme [« A », « B », »C »],[« X », »Y », »Z »] qui donnera
A | B | C |
X | Y | Z |
Réponse
Il est possible de récupérer la réponse dans un JSON.

Lire une (ou plusieurs) valeur dans sheet
Aideo Google : https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/get

- Méthode : GET
- Path : v4/spreadsheets/${spreadsheetId}/values/${range}
Variable dans le path
Variable |
Possibilité |
Fonction |
majorDimension |
ROWS |
Opère en ligne |
COLUMNS |
Opère en colonne |
|
DIMENSION_UNSPECIFIED |
Pas spécifié |
|
ValueRenderOption |
FORMATTED_VALUE |
Valeur formatée dans la réponse (calcul effectué) |
UNFORMATTED_VALUE |
Valeur non formatée dans la réponse (calcul non effectué) |
|
FORMULA |
Retourne les formules |
|
DateTimeRenderOption |
SERIAL_NUMBER |
Date sous format nombre (utilisé pour Lotus) |
FORMATTED_STRING |
Date sous format string |
Body
Pas de body.
Données d’exécutions

- SpreadsheetId est la partie de l’URL du google sheet entre /d/ et /edit
- Exemple : si l’URL est : https://docs.google.com/spreadsheets/d/11vp8HYKDm865236fRZpwIAdgdkiJx9EcXDOsMHSQ/edit#gid=387179624 alors SpreadsheetId : 11vp8HYKDm865236fRZpwIAdgdkiJx9EcXDOsMHSQ
- Range : le nom de la feuille n’est pas obligatoire si il n’y en a qu’une.
Réponse
Il est possible de récupérer la réponse dans un JSON. (c’est le but)

Supprimer une (ou plusieurs) valeur dans sheet
Aide Google : https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/clear
Configuration

- null
- Méthode : POST
- Path : v4/spreadsheets/${spreadsheetId}/values/${range}:clear
Body
Pas de body
Données d’exécutions

- SpreadsheetId est la partie de l’URL du google sheet entre /d/ et /edit
- Exemple : si l’URL est : https://docs.google.com/spreadsheets/d/11vp8HYKDm865236fRZpwIAdgdkiJx9EcXDOsMHSQ/edit#gid=387179624 alors SpreadsheetId : 11vp8HYKDm865236fRZpwIAdgdkiJx9EcXDOsMHSQ
- Range : le nom de la feuille n’est pas obligatoire si il n’y en a qu’une.
Réponse
Il est possible de récupérer la réponse dans un JSON.
