Configurer votre propre accès Google

Pour que rankion.ai puisse lire vos données de Google Search Console, de Google Analytics 4 et de votre fiche d'établissement Google, votre équipe a besoin de son propre accès Google : un client OAuth dans votre projet Google Cloud. Vous le créez une fois et saisissez deux valeurs dans rankion.ai, l'ID client et le code secret du client. Ensuite, chaque connexion de votre équipe passe par votre propre projet Google.

Seuls les propriétaires et administrateurs de votre équipe peuvent configurer l'accès. Les autres membres voient si un accès est enregistré.

Avant de commencer

Ouvrez dans rankion.ai la page Intégration Google (/integrations/google). En haut se trouve la section Accès Google de votre équipe avec deux URI de redirection autorisés :

Reprenez toujours les adresses depuis cette page, avec le bouton Copier. Google les compare caractère par caractère ; une barre oblique manquante ou en trop à la fin provoque « Erreur 400 : redirect_uri_mismatch ».

Étape 1 : créer un projet Google Cloud

1. Ouvrez la Google Cloud Console et connectez-vous avec le compte Google auquel appartiennent votre Search Console et votre Analytics.
2. Dans le sélecteur de projet en haut, choisissez Nouveau projet, donnez-lui un nom (par exemple « rankion ») et créez-le.
3. Vérifiez que le nouveau projet est bien sélectionné en haut avant de continuer.

Étape 2 : activer les API

Sous API et services → Bibliothèque, recherchez chacune des API suivantes et cliquez sur Activer :

• Google Search Console API
• Google Analytics Data API
• Google Analytics Admin API

Uniquement si vous souhaitez récupérer les avis de votre fiche d'établissement, en plus :

• My Business Account Management API
• My Business Business Information API
• Google My Business API

Google ne débloque les API de la fiche d'établissement qu'après une demande d'accès. Vous la soumettez via le formulaire que Google indique dans la documentation des Business Profile APIs.

Étape 3 : configurer l'écran de consentement

1. Ouvrez API et services → Écran de consentement OAuth (dans les consoles plus récentes, cette zone s'appelle Google Auth Platform).
2. Choisissez Externe comme audience. Si votre compte Google appartient à une organisation Google Workspace et que seules des personnes de celle-ci utilisent rankion.ai, Interne suffit.
3. Saisissez un nom d'application, votre adresse e-mail d'assistance et une adresse de contact.
4. Sous Accès aux données (ou Champs d'application), ajoutez ces champs : .../auth/webmasters.readonly, .../auth/analytics.readonly et, uniquement pour les avis, .../auth/business.manage.
5. Passez l'état de publication de l'application à En production. À l'état Test, seuls les utilisateurs test inscrits peuvent se connecter, et Google fait expirer l'autorisation au bout de sept jours. La connexion dans rankion.ai cesse alors de fonctionner.

Pour les champs de lecture, Google peut exiger une validation d'une application externe. Tant qu'elle n'est pas terminée, Google affiche lors de la connexion l'avis « Cette application n'a pas été validée » ; via Paramètres avancés, vous pouvez quand même continuer pour votre propre compte.

Étape 4 : créer le client OAuth

1. Ouvrez API et services → Identifiants (ou Google Auth Platform → Clients).
2. Choisissez Créer des identifiants → ID client OAuth.
3. Type d'application : Application Web. Le nom est libre.
4. Sous URI de redirection autorisés, saisissez les deux adresses de rankion.ai, chacune sur sa propre ligne.
5. Enregistrez. Google vous affiche maintenant l'ID client (se termine par .apps.googleusercontent.com) et le code secret du client (commence généralement par GOCSPX-).

Étape 5 : saisir les valeurs dans rankion.ai

1. De retour sur Intégration Google dans rankion.ai : saisissez l'ID client et le code secret du client dans la section Accès Google de votre équipe.
2. Cliquez sur Enregistrer l'accès. L'état passe à Accès propre actif.
3. Cliquez maintenant sur Se connecter avec Google. À partir de là, la connexion passe par votre projet Google.

Le code secret du client est enregistré chiffré et n'est plus jamais affiché, même partiellement. Pour conserver l'ID client et renouveler le code secret, saisissez le nouveau code secret. Si vous laissez le champ vide, le code secret enregistré est conservé.

Ce qu'il advient des connexions existantes

• Les connexions établies par votre équipe avant l'accès propre continuent de fonctionner sans changement.
• Si vous saisissez un nouvel ID client ou supprimez l'accès, les connexions qui passaient par l'ancien accès doivent être reconnectées. Google lie chaque autorisation exactement au client par lequel elle a été accordée. Ces connexions apparaissent ensuite comme « expirées » ; un clic sur Autre compte avec le même compte Google les rétablit.

Erreurs fréquentes

Voir aussi : Premiers pas · API : API des intégrations Google (GET /v1/google/oauth-client affiche l'état, sans le code secret).