Déclencheurs pour les modules complémentaires Google Workspace

Les déclencheurs Apps Script provoquent un script spécifié. (la fonction du déclencheur) à exécuter chaque fois qu'un événement spécifié se produit. Seuls certains événements peuvent déclencher des déclencheurs, et chaque L'application Google Workspace est compatible avec un autre ensemble d'événements.

Lorsqu'un déclencheur est exécuté, un objet événement est créé. Cette structure JSON contient des détails sur l'événement qui s'est produit. Les informations contenues dans l'événement la structure d'un objet est organisée différemment en fonction du type de déclencheur.

Une fois l'objet événement créé, Apps Script le transmet en tant que paramètre à la méthode la fonction de déclenchement. La fonction de déclenchement est une fonction de rappel que vous devez vous mettre en œuvre, de prendre les mesures appropriées pour répondre . Par exemple, dans un Google Workspace, qui étend les fonctionnalités de Gmail, vous permet définir un déclencheur qui crée une nouvelle interface de carte lorsque l'utilisateur ouvre un message ; thread. Dans ce cas, vous implémentez une fonction de rappel contextuel pour créer les cartes qui composent la nouvelle interface utilisateur à l'aide des données transmises dans le objet event.

Vous trouverez sur cette page des consignes sur l'utilisation de déclencheurs Google Workspace des projets complémentaires.

Déclencheurs du fichier manifeste

Contrairement aux modules complémentaires des éditeurs, les modules complémentaires Google Workspace ne peuvent actuellement pas utiliser les déclencheurs simples Apps Script ; mais des déclencheurs conçus spécifiquement pour Modules complémentaires Google Workspace: déclencheurs du fichier manifeste

Les déclencheurs du fichier manifeste sont définis de manière exhaustive dans Modules complémentaires Google Workspace manifest. Exemples de déclencheurs de fichier manifeste : suivantes:

• Les déclencheurs de page d'accueil qui créent et affichent la page d'accueil du module complémentaire.
• Déclencheurs "eventOpen" qui affichent une nouvelle carte ou une nouvelle prise d'autres actions lors de l'ouverture d'un événement d'agenda.
• Déclencheurs eventUpdate d'agenda qui affichent une nouvelle carte ou prennent d'autres actions lorsqu'un utilisateur modifie et enregistre un événement d'agenda.
• Déclencheurs onItemsSelected, qui affichent une nouvelle fiche ou autres actions lorsqu'un utilisateur sélectionne un ou plusieurs fichiers ou dossiers dans Drive.
• Déclencheurs de rédaction Gmail qui affichent une fiche de module complémentaire lorsque le ouvre le module complémentaire dans la fenêtre de rédaction de Gmail.
• des déclencheurs contextuels Gmail qui affichent une nouvelle fiche ou effectuent d'autres lorsque l'utilisateur ouvre un message Gmail.
• Déclencheurs onFileScopeGranted de l'éditeur qui affichent une nouvelle fiche lorsque les utilisateurs accorder une autorisation pour le champ d'application OAuth de drive.file dans l'éditeur actuel document.

Dans la liste ci-dessus, seuls les déclencheurs liés à la page d'accueil sont non contextuels. les autres sont des déclencheurs contextuels. Voir le fichier manifeste pour en savoir plus sur les définitions des déclencheurs du fichier manifeste.

En plus des déclencheurs de fichiers manifestes, Google Workspace les modules complémentaires peuvent aussi utiliser Apps Script déclencheurs installables.

Restrictions

Les déclencheurs du fichier manifeste sont soumis à certaines restrictions d'utilisation.

• Ces déclencheurs ne sont utilisés que dans les projets de modules complémentaires Google Workspace. ils n'ont aucun but dans une autre application.
• Étant donné qu'ils sont définis dans le fichier manifeste du module complémentaire et non dans son code, vous ne pouvez pas utilisez Apps Script Script pour créer ou modifier ces déclencheurs.
• Les déclencheurs contextuels Gmail ne peuvent actuellement comporter qu'un critère unconditional. Cela signifie que les déclencheurs contextuels se déclenchent pour chaque e-mail, contenus.
• Chaque module complémentaire ne peut avoir qu'un seul déclencheur de chaque type, par utilisateur et par document.