Que fait gws-events-subscribe ?
Google Workspace Events : Abonnez-vous aux événements Workspace et diffusez-les au format NDJSON.
Description
Cette compétence permet de s'abonner à des événements Google Workspace (tels que les modifications de fichiers sur Drive, les changements de statut de calendrier, ou les mises à jour de documents dans Docs) et de les diffuser en continu en tant que flux NDJSON. Chaque événement est émis sous forme d'une ligne JSON distincte, facilitant l'intégration dans des pipelines de données ou des applications en temps réel.
Prérequis
- Un projet Google Cloud avec l'API Google Workspace Events activée.
- Des identifiants OAuth 2.0 (ID client et secret client) configurés dans votre projet.
- Une authentification correcte avec un compte disposant des autorisations nécessaires pour recevoir les événements.
Installation
- Clonez le dépôt ou incluez cette compétence dans votre configuration d'agent IA.
- Configurez vos identifiants Google Workspace en tant que variables d'environnement :
GOOGLE_CLIENT_ID: votre ID client OAuth 2.0GOOGLE_CLIENT_SECRET: votre secret client OAuth 2.0GOOGLE_REFRESH_TOKEN: (facultatif) un token de rafraîchissement pour une authentification persistante.
Utilisation
Exécutez la commande suivante pour démarrer l'abonnement :
python main.py --channel-id "votre-id-de-canal" --resource-id "votre-id-de-ressource"
Les événements seront affichés dans la console au format NDJSON, par exemple :
{"kind": "drive#change", "id": "12345", "time": "2023-10-05T14:48:00.000Z", "type": "file", "fileId": "abc123"}
Configuration
Vous pouvez personnaliser le comportement de l'abonnement avec les options suivantes :
--channel-id: Identifiant unique pour le canal d'abonnement (obligatoire).--resource-id: Identifiant de la ressource Google Workspace à surveiller (obligatoire).--expiration: Durée de validité de l'abonnement en secondes (optionnel, par défaut : 86400).--address: URL de rappel pour recevoir les notifications (optionnel, par défaut : diffuser en continu dans la console).
Dépannage
- Erreur 401 : Assurez-vous que vos identifiants OAuth 2.0 sont valides et que le token de rafraîchissement est à jour.
- Aucun événement reçu : Vérifiez que la ressource surveillée (fichier, dossier, etc.) existe et que les modifications sont en cours.
- Dépassement du quota : Réduisez la fréquence des abonnements ou augmentez les limites de quota dans votre projet Google Cloud.
Plateformes prises en charge
- Claude Code
- Cursor
- Codex
Licence
Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.