Dépanner le connecteur Google Search Console
Bêta
Cette fonctionnalité est en version bêta. Les administrateurs de Workspace peuvent contrôler l’accès à cette fonctionnalité depuis la page Aperçus . Consultez Gérer les aperçus Databricks.
Cette page décrit les erreurs courantes que vous pourriez rencontrer avec le connecteur géré Google Search Console et comment les résoudre.
Pour obtenir des conseils de dépannage généraux applicables à tous les pipelines d’ingestion gérés, consultez Dépanner les pipelines d’ingestion gérés.
Quota de QPS pour Search analytique dépassé
Message d'erreur :
Google Search Console Search Analytics QPS quota exceeded. Retrying with backoff.
Cause : le pipeline a envoyé trop de requêtes à l'API Google Search Console Search analytique dans un court laps de temps et a atteint la limite de quota par utilisateur et par seconde de Google.
Solutions:
Le connecteur effectue automatiquement des tentatives avec interruption lorsque cette erreur se produit. Si le pipeline continue d’échouer, réduisez le nombre d’URL de site ou de tables ingérées dans un seul pipeline, ou ajoutez un intervalle de planification plus long entre les exécutions du pipeline pour réduire le volume global de requêtes API.
Autorisation refusée (403)
Message d'erreur :
Le pipeline échoue avec une réponse HTTP 403 et l’erreur est classée comme une erreur de configuration.
Cause : l’identité authentifiée (compte de service ou utilisateur OAuth) ne dispose pas des autorisations suffisantes sur une ou plusieurs propriétés Google Search Console. Cela se produit lorsque l’identité n’est pas un propriétaire vérifié ou un utilisateur disposant de toutes les autorisations sur la propriété, ou lorsque la délégation à l’échelle du domaine est mal configurée.
Solutions:
Vérifiez que l’e-mail du compte de service ou l’utilisateur OAuth dispose de l’autorisation Full sur chaque URL de site spécifiée dans site_urls. Consultez Configurer l’authentification à Google Search Console pour connaître les étapes permettant d’accorder l’accès dans Google Search Console.
Si vous utilisez un compte de service avec une délégation à l'échelle du domaine, confirmez que :
- Le champ User Email to Impersonate dans la connexion utilise un compte qui possède ou dispose d'un accès complet aux propriétés.
- La portée
https://www.googleapis.com/auth/webmasters.readonlyest autorisée dans la console d'administration Google Workspace pour l'ID client du compte de service.
Pour mettre à jour les identifiants, modifiez la connexion dans l'Explorateur de catalogue. Voir Créer une connexion Google Search Console.
Jeton d'accès expiré (401)
Message d'erreur :
Le pipeline échoue avec une réponse HTTP 401.
Cause : le jeton d'accès utilisé par la connexion a expiré ou a été révoqué.
Solutions:
Le connecteur automatiquement refresh les jetons OAuth lorsqu'il reçoit une réponse 401. Si l'erreur persiste, le jeton refresh a peut-être été révoqué. Réauthentifiez-vous en modifiant la connexion dans l'Explorateur de catalogue et en terminant à nouveau le flux de connexion. Voir Créer une connexion Google Search Console.
Pour les connexions par compte de service, vérifiez que la clé de compte de service JSON dans la connexion est valide et n’a pas été supprimée dans la console Google Cloud. Download une nouvelle clé si nécessaire et mettez à jour la connexion.
Erreurs de serveur transitoires (500, 502, 503, 504)
Message d'erreur :
Le pipeline échoue avec une réponse HTTP 500, 502, 503 ou 504.
Cause : L’API Google Search Console a renvoyé une erreur de serveur temporaire. Ces erreurs sont temporaires et ne sont pas liées à vos identifiants ou à la configuration de votre pipeline.
Solutions:
Le connecteur réessaie automatiquement les erreurs temporaires avec un intervalle exponentiel. Si le pipeline continue d'échouer après plusieurs tentatives, consultez le Google Workspace Status Dashboard pour vérifier s'il existe des incidents Google Search Console en cours. Si aucun incident n'est signalé, relancez le pipeline manuellement.