Connectez Google Sheets à votre agent IA

Méthodes d’authentification

• OAuth 2.0

Ouvrez la console locale, sélectionnez un fournisseur et configurez ses identifiants. Les fournisseurs OAuth nécessitent une application OAuth que vous enregistrez auprès du service.

Points à vérifier pour ce connecteur

Cet exemple recherche les feuilles de calcul accessibles à la connexion Google. Vérifiez les scopes de lecture déclarés et les droits du compte sur les fichiers. Une liste vide ne prouve pas un échec du runtime.

Vérifier l’Action avant de l’appeler

Objectif de l’exemple

Rechercher les feuilles de calcul accessibles au compte Google connecté.

Autorisations requises par l’Action

• https://www.googleapis.com/auth/spreadsheets.readonly
• https://www.googleapis.com/auth/drive.readonly

Lisez le schéma de votre instance en cours d’exécution. Vérifiez les paramètres requis, les autorisations et le compte connecté avant l’appel.

curl -s http://localhost:3000/v1/actions/googlesheets.search_spreadsheets

Une fois le compte connecté, adaptez les paramètres à vos ressources. Ajoutez un Bearer Token du runtime si son authentification est activée.

curl -s -X POST \
  http://localhost:3000/v1/actions/googlesheets.search_spreadsheets \
  -H 'content-type: application/json' \
  -d '{"input":{"maxResults":5}}'

Lire le résultat

Les réponses HTTP du runtime contiennent success, message, data et meta. Vérifiez success et le schéma de sortie de l’Action, pas seulement le statut HTTP. Si les métadonnées contiennent executionId, utilisez-le pour retrouver le journal expurgé correspondant. L’exemple ci-dessous illustre le format ; ce n’est pas un résultat d’appel réel.

{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

En cas d’échec

• Pour une erreur d’authentification, vérifiez l’endpoint et le type d’identifiant : l’accès administrateur protège /api, le jeton Bearer runtime autorise /v1 et /mcp. Une clé API fournisseur ne remplace pas le jeton runtime.
• Pour un refus d’accès, vérifiez les scopes requis, les règles d’Actions et les autorisations de connexion. Un jeton valide peut ne pas être autorisé à utiliser le compte choisi.
• Si le résultat est vide ou incomplet, vérifiez le compte connecté et ses droits sur la ressource. Une autorisation réussie ne donne pas accès à tous les espaces, canaux ou documents.
• Consultez l’erreur et le journal avant de réessayer. Si l’Action modifie les données du fournisseur, vérifiez d’abord si elle a déjà abouti ; ne répétez pas la requête aveuglément.

Étapes suivantes

Pour les fournisseurs compatibles, OOMOL gère la configuration des applications OAuth et l’hébergement. Vous choisissez toujours le compte et approuvez ses autorisations.