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.
Email de référence

Vous devez être connecté avec l’adresse qui sera utilisée dans votre espace ITEROP. Vérifiez également que vous avez les droits d’écriture.

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 :

Cliquez sur valider pour avoir le state et le code dans l’URL de la page.

Ecrire une (ou plusieurs) valeur dans votre sheet

Cette méthode n’écrase pas les données. (exemple : si vous écrivez dans la case A2 et qu’elle est déjà remplie, la donnée ira en A3 (si elle est vide)

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
  • 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

Cette méthode va écraser les valeurs déjà présentes.

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
  • 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

Possibilité de mettre une plage (exemple : ‘Feuille 1’!A1:B2 )

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

Possibilité de mettre une plage (exemple : ‘Feuille 1’!A1:B2

Réponse

Il est possible de récupérer la réponse dans un JSON.

Liste des opérations utiles :

Updated on 19 juin 2019

Was this article helpful?

Related Articles