Documentation du fonctionnement et de l’utilisation de Google My Business

Introduction

Cette documentation a pour objectif de fournir une vue d’ensemble de l’intégration de Google My Business (GMB) dans IntuityVO, ainsi que des détails techniques sur son fonctionnement. Cette intégration permet aux utilisateurs de gérer leurs annonces GMB directement depuis l’interface de votre logiciel, simplifiant ainsi leur quotidien.

Fonctionnalités

• Connexion à Google: L’utilisateur se connecte à IntuityVO à l’aide de son compte Google.
• Sélection de la fiche d’établissement: Une fois connecté, l’utilisateur choisit parmi la liste des fiches GMB associées à son compte.
• Gestion des annonces:
  • Création et modification: L’utilisateur peut créer, modifier et publier de nouvelles annonces.
  • Publication et dépublication: L’utilisateur peut activer ou désactiver la publication d’une annonce à tout moment.
  • Consultation des statistiques: L’utilisateur peut consulter les statistiques de performance de ses annonces directement dans le logiciel.
• Paramètres:
  • Déconnexion: L’utilisateur peut se déconnecter de son compte Google à tout moment.
  • Préférences: L’utilisateur peut personnaliser certains paramètres liés à l’intégration de GMB (par exemple, le fuseau horaire).

Fonctionnement technique

• Utilisation de la librairie PHP de Google: IntuityVO utilise la librairie PHP officielle de Google pour interagir avec l’API GMB. Cette librairie offre un ensemble de fonctions et de classes permettant de simplifier les opérations telles que l’authentification, la construction des requêtes et le traitement des réponses.
• Flux de travail simplifié:
  1. Authentification: L’utilisateur se connecte via OAuth 2.0.
  2. Récupération des fiches: Le logiciel récupère la liste des fiches GMB associées au compte de l’utilisateur.
  3. Sélection de la fiche: L’utilisateur choisit la fiche à gérer.
  4. Opérations sur les annonces: Le logiciel envoie les requêtes appropriées à l’API GMB pour créer, modifier ou supprimer des annonces.
  5. Affichage des résultats: Les résultats des opérations sont affichés à l’utilisateur et mis à jour dans l’interface.

Gestion des erreurs

IntuityVO met en œuvre une gestion robuste des erreurs afin d’assurer une expérience utilisateur optimale. En cas d’erreur, les mécanismes suivants sont mis en place :

• Capture des exceptions: Les exceptions levées par la librairie PHP sont interceptées.
• Affichage de messages clairs: L’utilisateur reçoit un message d’erreur expliquant la cause du problème (par exemple, « Erreur d’authentification », « Quota d’API dépassé »).
• Journalisation: Les erreurs sont enregistrées dans des journaux pour faciliter le débogage et l’analyse.
• Suggestions de résolution: Dans certains cas, des suggestions sont proposées à l’utilisateur pour résoudre le problème (par exemple, vérifier les informations saisies, contacter le support).

Aspects RGPD

IntuityVO traite les données personnelles de l’utilisateur avec le plus grand soin et dans le respect du RGPD. Les données collectées sont limitées au strict nécessaire pour assurer le fonctionnement de l’intégration GMB. L’utilisateur dispose à tout moment de ses droits d’accès, de rectification et d’effacement de ses données.

Informations complémentaires

• Politique de confidentialité: [Lien vers votre politique de confidentialité]
• Conditions générales d’utilisation: [Lien vers vos conditions générales d’utilisation]
• Documentation de l’API GMB: [Lien vers la documentation officielle de l’API Google My Business]