Synchronisez Google Sheets avec votre veille tarifaire en quelques minutes

Rivalyse collecte les prix de vos principaux vendeurs de référence sur 50+ marketplaces jusqu'à 4 fois par jour. Le code Apps Script installé dans votre Google Sheet interroge ensuite l'API Rivalyse et inscrit les résultats dans le tableur. C'est un mécanisme de type pull : le script va chercher les données lui-même, Rivalyse n'envoie jamais rien directement vers votre Sheet.

Modes disponibles :

• Import manuel : menu Rivalyse → Rafraîchir les prix ou Rafraîchir les alertes, la fonction pullPrices (ou pullAlerts) s'exécute immédiatement
• Import automatique : menu Rivalyse → Configurer le trigger (6h), la fonction pullPrices s'exécute ensuite toutes les 6 heures sans intervention
• Colonnes exportées dans l'onglet Prices : URL ID, SKU, Produit, Categorie, Concurrent, URL Client, URL Concurrent, Prix Client, Prix Concurrent, Diff (EUR), Moins cher ?, Stock, Dernier scrape
• Colonnes exportées dans l'onglet Alerts : ID, Type alerte, Date envoi, SKU, Produit, Concurrent
• Mise en forme automatique : couleurs conditionnelles, formats monétaires, lignes gelées

L'intégration ne nécessite aucune installation serveur : un compte Google avec accès à Google Sheets suffit. Vérifiez que votre environnement répond aux exigences minimales avant de démarrer la configuration.

La configuration complète prend moins de 10 minutes. Aucune dépendance externe ni librairie tierce n'est requise : le code Apps Script fourni est autonome et s'appuie uniquement sur l'API Rivalyse.

1. Créez un nouveau Google Sheet ou ouvrez un existant
2. Menu Extensions → Apps Script
3. Supprimez le code existant et collez le contenu du fichier code.gs disponible dans votre dashboard Rivalyse
4. Dans l'éditeur Apps Script : icône engrenage (Paramètres du projet) en barre latérale → section Propriétés du script, ajoutez :
5.     API_URL = URL de votre API Rivalyse
6.     API_KEY = votre clé API (créée depuis Dashboard → Intégrations → Clés API)
7. Sauvegardez, puis rechargez la page de votre Google Sheet (ou rouvrez-la) : le menu "Rivalyse" apparaît alors
8. Cliquez Rivalyse → Rafraîchir les prix pour effectuer un premier import manuel et vérifier que la connexion fonctionne

Les prix s'inscrivent automatiquement dans un onglet dédié nommé « Prices » (créé s'il n'existe pas encore) et les alertes dans un onglet « Alerts » séparé. L'en-tête est créé automatiquement au premier import.

L'automatisation repose sur un seul mécanisme : un déclencheur temporel créé par le script lui-même, fixé à 6 heures. C'est le script qui va chercher les données à intervalle régulier : il n'existe pas de webhook entrant, Rivalyse n'envoie jamais de requête vers votre Google Sheet.

Configurer le déclencheur automatique :

1. Dans votre Google Sheet, ouvrez le menu Rivalyse → Configurer le trigger (6h)
2. Autorisez les permissions OAuth demandées si c'est la première exécution
3. Un déclencheur temporel est créé automatiquement : il appelle pullPrices toutes les 6 heures

Ce cadencement de 6 heures est fixe et n'est pas modifiable depuis l'interface Google Sheets. Pour le changer, il faut éditer directement la ligne .everyHours(6) du script code.gs dans l'éditeur Apps Script. Relancer le menu Configurer le trigger (6h) supprime l'ancien déclencheur avant d'en recréer un identique.

Seul l'onglet Prices est concerné par ce déclencheur automatique. Les alertes de l'onglet Alerts restent à récupérer manuellement, via Rivalyse → Rafraîchir les alertes ; le menu Rivalyse → Rafraîchir les prix permet lui aussi de lancer un import de prix à tout moment sans attendre le déclencheur.

Le code Apps Script crée automatiquement une structure de colonnes normalisée. Chaque import remplaçant entièrement le contenu de l'onglet Prices, placez vos formules d'analyse dans un onglet séparé qui référence Prices (par exemple =Prices!I2) plutôt que directement dans Prices, où elles seraient effacées au prochain import.

L'onglet Prices contient 13 colonnes :

Les alertes ne figurent pas dans cet onglet : elles s'inscrivent dans un onglet Alerts séparé, à 6 colonnes (ID, Type alerte, Date envoi, SKU, Produit, Concurrent).

Conseil : la mise en forme conditionnelle sur la colonne J (Diff) est déjà appliquée automatiquement par le script, fond rouge si le concurrent est plus cher que vous, fond vert si le concurrent est moins cher que vous. Chaque import remplace entièrement le contenu de l'onglet Prices (aucun historique n'est conservé dans Google Sheets) : pour suivre une tendance dans le temps, consultez l'historique des prix directement dans votre dashboard Rivalyse.

Exemple : une boutique de prêt-à-porter surveille 15 marchands sur 3 marketplaces et repère immédiatement, grâce au fond vert automatique de la colonne Diff, qu'un concurrent est passé sous son propre prix sur un article phare. Elle ajuste son prix en conséquence avant le prochain import.

Chaque appel entre votre Google Sheet et l'API Rivalyse est authentifié par clé API, transmise en HTTPS dans l'en-tête Authorization. Aucune donnée sensible ne transite en clair. La clé API n'est jamais exposée dans le code source visible.

• La clé API est stockée dans les Propriétés du script Apps Script, jamais dans le code source lui-même
• Toutes les requêtes vers l'API Rivalyse transitent en HTTPS
• La clé API n'expire jamais : révoquez-la à tout moment depuis Dashboard → Intégrations → Clés API
• N'accordez un accès en modification à votre Google Sheet ou à son projet Apps Script qu'à des personnes de confiance : elles peuvent consulter la clé dans les Propriétés du script
• Apps Script s'exécute dans le bac à sable Google : aucun accès à votre système de fichiers local

En cas de dysfonctionnement, consultez en priorité le journal d'exécution d'Apps Script (menu Exécutions en barre latérale). La majorité des erreurs provient d'une clé API invalide ou révoquée, ou d'une autorisation OAuth manquante.