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 grâce à son moteur de collecte multicouche. Dès qu'une variation tarifaire dépasse votre seuil configuré, le code Apps Script récupère les données via l'API Rivalyse et les inscrit dans votre Google Sheet. L'intégration propose trois modes de synchronisation : déclencheur temporel programmé, webhook temps réel ou export CSV planifié.

Modes disponibles :

• Mode Apps Script + déclencheur temporel : la fonction fetchPrices s'exécute automatiquement à intervalle fixe (toutes les heures, toutes les 6 heures, etc.)
• Mode webhook : Rivalyse envoie une notification signée HMAC-SHA256 dès qu'un prix change, sans attendre le prochain cycle de collecte
• Export CSV planifié : disponible en plan Business+, pour les utilisateurs qui préfèrent un fichier CSV importé périodiquement
• Colonnes exportées : SKU, Produit, Votre prix, Prix concurrent, Écart, Alerte, Date de collecte
• 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 : menu Projet → Propriétés du projet → Variables de script, ajoutez :
5.     API_URL = URL de votre API Rivalyse
6.     API_TOKEN = votre token JWT (disponible dans Paramètres du compte)
7. Sauvegardez : le menu "Rivalyse" apparaît dans votre Google Sheet
8. Cliquez Rivalyse → Rafraîchir les prix pour effectuer un premier import manuel et vérifier que la connexion fonctionne

Les données s'inscrivent dans la feuille active à partir de la cellule A1. L'en-tête est créé automatiquement au premier import.

Deux modes d'automatisation sont disponibles. Le déclencheur temporel est le plus simple à mettre en place. Le webhook offre une réactivité maximale en déclenchant l'export à la seconde même où un changement de prix est détecté.

Déclencheur temporel (recommandé pour débuter) :

1. Dans Apps Script : icône Déclencheurs (horloge en barre latérale)
2. Cliquez + Ajouter un déclencheur
3. Fonction : fetchPrices
4. Source d'événement : Piloté par le temps
5. Type de déclencheur : Minuteur toutes les heures (ou autre intervalle)
6. Sauvegardez et autorisez les permissions OAuth demandées

URL webhook à déclarer dans le dashboard Rivalyse (plan Pro+) :

Rivalyse envoie une requête POST signée HMAC-SHA256 à cette URL dès qu'une variation de prix est détectée. Le script vérifie la signature avant d'écrire les données dans le tableur.

Le code Apps Script crée automatiquement une structure de colonnes normalisée. Vous pouvez ensuite ajouter des formules Google Sheets pour enrichir l'analyse sans toucher au script.

Conseil : appliquez une mise en forme conditionnelle sur la colonne E pour colorer en rouge les écarts supérieurs à votre seuil. Ajoutez un graphique courbe sur la colonne D pour visualiser l'évolution des prix de vos compétiteurs dans le temps.

Exemple concret : une boutique de prêt-à-porter qui surveille 15 marchands sur 3 marketplaces détecte une baisse de −5 % sur un article phare. La mise en forme conditionnelle colore automatiquement la ligne en rouge dans Google Sheets, le webhook Business+ déclenche la synchronisation inverse vers WooCommerce en moins de 30 secondes, et le graphique de tendance affiche l'historique complet des prix sur 90 jours pour piloter le repricing sans quitter le tableur.

Chaque communication entre Rivalyse et Google Sheets est authentifiée. Aucune donnée sensible ne transite en clair. Le token JWT et le secret webhook ne sont jamais exposés dans le code source visible.

• Le token JWT est stocké dans les Propriétés du script Apps Script, jamais dans le code source lui-même
• Les webhooks sont signés HMAC-SHA256 : le script vérifie la signature avant d'écrire les données
• Le token JWT expire après 7 jours : renouvelez-le depuis le dashboard Rivalyse → Paramètres → Tokens API
• Ne partagez jamais votre Google Sheet si les propriétés du script sont visibles par les collaborateurs
• 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'un token JWT expiré ou d'une autorisation OAuth manquante.