> ## Documentation Index > Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt > Use this file to discover all available pages before exploring further. # Gmail > Gestion des e-mails avec l'API Gmail et OAuth 2.0 ## Authentification et configuration L'intégration Gmail nécessite une authentification OAuth 2.0 via Google Cloud Platform. Les organisations doivent créer un projet dans Google Cloud Console, activer l'API Gmail et configurer l'écran de consentement OAuth. L'intégration prend en charge les comptes Gmail personnels et les comptes Google Workspace (anciennement G Suite) d'entreprise. Les jetons d'authentification sont stockés de manière sécurisée et actualisés automatiquement pour maintenir un accès continu. ## Portées API requises * **gmail.readonly** : Accès en lecture seule aux e-mails et paramètres. * **gmail.send** : Envoyer des e-mails au nom de l'utilisateur. * **gmail.compose** : Créer et gérer les brouillons d'e-mails. * **gmail.modify** : Accès complet pour lire, composer, envoyer et modifier les e-mails. * **gmail.labels** : Gérer les étiquettes et les catégories d'e-mails. ## Opérations disponibles Avec toutes les autorisations requises configurées, la boîte à outils active les opérations suivantes : ### Gestion des e-mails * **Rechercher des e-mails** : Recherche avancée utilisant la syntaxe de requête Gmail (from:, to:, subject:, has:attachment, is:unread, etc.). * **Obtenir le contenu d'un e-mail** : Récupérer l'e-mail complet avec les en-têtes, le corps (texte brut/HTML) et la liste des pièces jointes. * **Envoyer un e-mail** : Composer et envoyer de nouveaux e-mails avec plusieurs destinataires, CC/BCC, pièces jointes et contenu HTML. * **Répondre à un e-mail** : Répondre aux fils de discussion existants en conservant l'historique des conversations et le threading. * **Transférer un e-mail** : Transférer des messages à d'autres destinataires avec des commentaires supplémentaires optionnels. * **Obtenir les pièces jointes** : Télécharger les pièces jointes des e-mails pour traitement ou stockage. * **Supprimer un e-mail** : Déplacer les e-mails vers la corbeille ou les supprimer définitivement. * **Archiver un e-mail** : Supprimer de la boîte de réception tout en conservant dans Tous les messages. * **Marquer comme indésirable** : Signaler et déplacer les e-mails non désirés vers le dossier spam. * **Marquer comme important/Étoilé** : Signaler les e-mails importants pour une récupération facile. ### Gestion des brouillons * **Créer un brouillon** : Enregistrer les compositions d'e-mails en tant que brouillons sans envoyer. * **Mettre à jour le brouillon** : Modifier le contenu existant du brouillon, les destinataires ou les pièces jointes. * **Envoyer un brouillon** : Envoyer un e-mail brouillon créé précédemment. * **Lister les brouillons** : Afficher tous les e-mails brouillons enregistrés. * **Supprimer un brouillon** : Supprimer les e-mails brouillons du dossier brouillons. ### Opérations d'étiquetage * **Lister les étiquettes** : Obtenir toutes les étiquettes disponibles, y compris les étiquettes système et personnalisées. * **Créer une étiquette** : Créer des étiquettes personnalisées pour l'organisation des e-mails. * **Appliquer une étiquette** : Ajouter une ou plusieurs étiquettes aux e-mails. * **Supprimer une étiquette** : Supprimer les étiquettes des e-mails. * **Renommer une étiquette** : Changer les noms d'étiquettes pour une meilleure organisation. * **Supprimer une étiquette** : Supprimer les étiquettes personnalisées (les e-mails restent intacts). ### Opérations de fil de discussion * **Obtenir un fil** : Récupérer le fil de conversation entier avec tous les messages. * **Lister les fils** : Interroger les fils de conversation selon les critères de recherche. * **Modifier le fil** : Appliquer des opérations en masse à tous les e-mails d'un fil. ### Gestion des statuts * **Marquer comme lu** : Mettre à jour le statut de lecture pour un ou plusieurs e-mails. * **Marquer comme non lu** : Signaler les e-mails comme non lus pour attention ultérieure. * **Mettre l'e-mail à la corbeille** : Déplacer les e-mails vers le dossier corbeille. * **Restaurer l'e-mail** : Restaurer les e-mails de la corbeille vers la boîte de réception. ## Options de configuration Configuration de la boîte à outils Gmail avec sélection des outils * **Filtres de requête** : Définir les filtres par défaut pour les recherches (par exemple, rechercher uniquement les 30 derniers jours). * **Résultats max** : Configurer le nombre maximum d'e-mails à récupérer par requête (par défaut 50, max 500). * **Inclure le spam/la corbeille** : Si vous souhaitez inclure les dossiers spam et corbeille dans les recherches. * **Traitement des pièces jointes** : Définir les limites de taille et l'analyse antivirus pour les pièces jointes téléchargées. * **Étiquettes par défaut** : Appliquer automatiquement les étiquettes aux e-mails envoyés par l'agent. * **Mode fil** : Activer/désactiver le regroupement automatique des fils pour les réponses. ## Cas d'usage * **Gestion intelligente de la boîte de réception** : Catégoriser, étiqueter et prioriser automatiquement les e-mails entrants selon l'analyse du contenu. * **Extraction de leads** : Analyser les e-mails à la recherche d'informations de contact, extraire les leads et remplir les systèmes CRM. * **Réponses automatisées** : Générer des réponses contextuelles aux demandes courantes en utilisant les connaissances de la base de connaissances. * **Surveillance des e-mails** : Surveiller les mots-clés ou les expéditeurs spécifiques et déclencher des workflows ou des notifications. * **Gestion des bulletins d'information** : Archiver, résumer ou se désabonner automatiquement des e-mails promotionnels. * **Support client** : Acheminer les e-mails d'assistance vers les équipes appropriées en fonction de la classification du contenu. * **Suivi des dépenses** : Extraire les reçus des e-mails, traiter les pièces jointes et enregistrer dans les systèmes comptables. * **Coordination des réunions** : Analyser les e-mails d'invitation aux réunions et synchroniser avec les systèmes de calendrier. ## Bonnes pratiques * **Utiliser la syntaxe de requête Gmail** : Exploiter les opérateurs de recherche avancés pour un filtrage précis des e-mails. * **Opérations par lot** : Traiter plusieurs e-mails dans une seule opération pour réduire les appels API. * **Respecter les quotas API** : L'API Gmail a des limites de quota quotidien (1 milliard d'unités de quota/jour pour Google Workspace). * **Implémenter le backoff exponentiel** : Gérer l'étranglement des tarifs gracieusement avec la logique de relance. * **Réponses thread-safe** : Toujours utiliser les ID de fil lors de la réponse pour maintenir le contexte de la conversation. * **Organisation des étiquettes** : Créer une hiérarchie d'étiquettes claire pour la classification automatisée. ## Considérations relatives au quota API L'API Gmail utilise un système de quota où différentes opérations coûtent différentes quantités. Coûts typiques : Envoyer un e-mail (100 unités), Obtenir un message (5 unités), Lister les messages (1 unité). Surveiller l'utilisation dans Google Cloud Console pour éviter de dépasser les limites. Pour les applications à grand volume, demander une augmentation de quota via Google. ## Problèmes courants et solutions * **Quota dépassé** : Implémenter la mise en cache et les opérations par lot pour réduire les appels API. Demander une augmentation de quota si nécessaire. * **Erreur de subvention invalide** : Le jeton a expiré ou a été révoqué. Réauthentifier l'utilisateur via le flux OAuth. * **Autorisations manquantes** : S'assurer que toutes les portées requises sont demandées lors du consentement OAuth. * **Échecs de téléchargement de pièces jointes** : Les pièces jointes volumineuses peuvent expirer. Utiliser le téléchargement en flux pour les fichiers >5 Mo.