Google Sheet

Cet article vous explique comment connecter Iterop à Google Sheet.

Côté Google

1. Rendez-vous dans le module de gestion des API de Google : https://console.developers.google.com/apis/library
2. Autorisez l’utilisation de l’API Google Sheet.

Côté Iterop

1. Rendez-vous dans Iterop Deisgn dans l’onglet « Services ».
2. 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.

Liste des opérations utiles :