Glossaire

Les termes suivants sont utilisés tout au long de cette documentation.

Module complémentaire de conférence Agenda

Type spécial de module complémentaire permettant aux fournisseurs de services de conférence de présenter des options de conférence dans des événements Google Agenda. Ces modules complémentaires nécessitent une solution de conférence bien développée à laquelle se connecter. De ce fait, la plupart des développeurs n'ont jamais besoin de créer de module complémentaire de conférence Agenda.

Pour en savoir plus, consultez Modules complémentaires de conférence Agenda. Consultez également Mettre à niveau vos modules complémentaires publiés pour savoir comment convertir un module complémentaire de visioconférence Agenda en module complémentaire Google Workspace.

Fiche

Une "page" unique de l'interface utilisateur d'un module complémentaire. Les fiches sont composées de différents objets de widget (boutons, champs de texte, en-têtes, etc.).

Pour en savoir plus, consultez l'article Fiches.

Par carte

Module complémentaire dont l'interface utilisateur apparaît sous la forme d'un volet dans la barre latérale (ou, sur mobile, sous la forme d'une autre fenêtre d'activité accessible via le menu). Le module complémentaire comporte une barre d'outils supérieure qui l'identifie et affiche une carte, essentiellement une "page" de l'interface utilisateur du module complémentaire.

Les modules complémentaires Google Workspace se font par carte.

Données de conférence

Ensemble des informations dont Google Agenda a besoin pour permettre aux utilisateurs de créer et de rejoindre des conférences tierces activées par un module complémentaire Google Workspace ou Agenda.

Pour plus d'informations, consultez la page Données de conférence.

Solution de conférence

Représentation d'une conférence tierce pouvant être créée à partir de Google Agenda à l'aide du module complémentaire Google Workspace ou de conférence Agenda.

Pour plus d'informations, consultez la page Solutions de conférence.

Contexte

État actuel de l'application hôte. Par exemple, les messages qui s'ouvrent actuellement dans Gmail, les événements Agenda que vous modifiez ou les fichiers Drive que vous avez sélectionnés font partie du contexte actuel de l'application hôte. Le contexte, ainsi que d'autres informations, est collecté dans un objet d'événement transmis à la fonction du déclencheur en tant que paramètre.

Déclenchement contextuel

Pratique qui consiste à définir des déclencheurs qui se déclenchent lorsque l'utilisateur entre dans un contexte spécifique, par exemple lorsqu'il ouvre un fil de discussion de messagerie dans Gmail. Le déclenchement contextuel permet à votre module complémentaire de fournir une UI adaptée à ce contexte. Les déclencheurs contextuels sont configurés dans le fichier manifeste du projet de script de module complémentaire et constituent un type de déclencheur de fichier manifeste.

Modules complémentaires de l'éditeur

Ensemble d'origine des types de modules complémentaires qui n'autorisaient que les extensions de Google Docs, Sheets, Forms ou Slides. Les modules complémentaires de l'éditeur ne sont pas basés sur des fiches. Ils nécessitent que le développeur crée une interface utilisateur à partir de code HTML et CSS brut. Chaque module complémentaire d'éditeur ne peut étendre qu'une seule application hôte.

Pour en savoir plus, consultez Modules complémentaires de l'éditeur.

Objet événement

Objet JSON créé automatiquement lorsque des pages d'accueil sont demandées, lorsque le module complémentaire saisit les contextes auxquels il doit répondre, ou à la suite d'interactions de l'utilisateur avec les widgets de l'interface du module complémentaire. Une fois créés, les objets d'événement sont transmis à une fonction de déclencheur ou à une fonction de rappel spécifiée. L'objectif des objets d'événement est de transmettre des informations de l'environnement côté client de l'utilisateur (telles que les informations qu'il a saisies dans les widgets d'interface du module complémentaire) au code côté serveur du module complémentaire, qui peut ensuite agir sur ces informations et renvoyer la réponse appropriée.

Pour en savoir plus, consultez Objets "Événement".

Modules complémentaires Gmail

Module complémentaire qui étend uniquement Gmail. Les modules complémentaires Gmail se font par carte. Une grande partie des fonctionnalités, du comportement et des détails de développement utilisés pour créer des modules complémentaires Gmail sont identiques à ceux utilisés pour créer des modules complémentaires Google Workspace.

Pour en savoir plus, consultez Modules complémentaires Gmail. Consultez également Mettre à niveau vos modules complémentaires publiés pour savoir comment convertir un module complémentaire Gmail en module complémentaire Google Workspace.

Page d'accueil

Carte d'interface utilisateur racine d'un module complémentaire. Les pages d'accueil s'affichent lorsque les utilisateurs ouvrent le module complémentaire. Elles permettent à ce module d'afficher du contenu en dehors d'un contexte spécifique (par exemple, lorsque l'utilisateur consulte ses fils de discussion dans Gmail, mais qu'il ne les a pas ouverts). Vous définissez l'apparence et le comportement de la page d'accueil du module complémentaire comme pour toute autre fiche.

Pour en savoir plus, consultez l'article Pages d'accueil.

Hôte ou application hôte

L'application Google Workspace est complétée par un module complémentaire Google Workspace, par exemple Gmail ou Google Agenda.

Basée sur le HTML

Module complémentaire dont l'interface utilisateur est définie à l'aide de code HTML et CSS au lieu du service Card intégré à Apps Script. Seuls les modules complémentaires de l'éditeur plus anciens sont basés sur HTML.

Les déclencheurs d'aperçu du lien se déclenchent lorsque les utilisateurs interagissent avec une URL tierce ou autre que Google dans une application hôte Google, telle que Google Docs. Le déclenchement de l'aperçu du lien vous permet de définir des formats d'URL à prévisualiser à partir de votre service ou de votre API, et de configurer le contenu de l'aperçu, y compris le chip intelligent et la fiche d'aperçu. Les déclencheurs d'aperçu des liens sont configurés dans le fichier manifeste du projet de script de module complémentaire et constituent un type de déclencheur de fichier manifeste.

Pour en savoir plus, consultez Prévisualiser les liens avec des chips intelligents.

Manifest

Fichier JSON joint à un projet Apps Script. Le fichier manifeste permet de définir les informations sur le projet dont le script a besoin pour s'exécuter correctement. Pour les modules complémentaires Google Workspace, le fichier manifeste permet de spécifier les hôtes que le module complémentaire peut étendre et fournir certains paramètres de contrôle de l'interface utilisateur.

Déclencheur du fichier manifeste

Déclencheur défini dans le fichier manifeste d'un projet, tel qu'un déclencheur de page d'accueil ou un déclencheur contextuel. Les déclencheurs du fichier manifeste sont utilisés exclusivement pour créer et afficher des fiches lorsqu'une page d'accueil de module complémentaire est demandée ou que le module complémentaire saisit un contexte nécessitant une mise à jour de l'affichage.

Les déclencheurs de fichier manifeste sont différents des autres déclencheurs dans Apps Script, car ils ne sont pas intégrés (comme les déclencheurs simples) et ne peuvent pas être créés de manière automatisée avec le service Script d'Apps Script (comme les déclencheurs installables).

Fiches non contextuelles

Cartes qui affichent du contenu lorsque l'utilisateur se trouve en dehors d'un contexte spécifique (par exemple, lorsqu'il consulte ses fils de discussion dans Gmail, mais qu'il n'en a pas ouvert un). Les pages d'accueil sont une sorte de carte sans contexte.

Section située à droite de l'interface utilisateur de l'hôte, dans laquelle l'interface utilisateur d'un module complémentaire Google Workspace apparaît. Les modules complémentaires Gmail et des éditeurs peuvent également définir des barres latérales.

Chip intelligent

Un chip intelligent est une mention d'une personne, d'un fichier, d'un événement d'agenda ou d'une autre entité dans une application Google Workspace. En pointant sur un chip, les utilisateurs peuvent prévisualiser d'autres contenus sur le fichier ou le lien. Par exemple, lorsque les utilisateurs passent la souris sur un chip dans une présentation Google Slides, une capture d'écran de la diapositive, le propriétaire de la présentation et s'ils l'ont déjà vue s'affichent.

Vous pouvez configurer votre module complémentaire pour qu'il utilise des chips intelligents pour prévisualiser les liens d'un service tiers ou autre que Google. Consultez Prévisualiser les liens dans Google Docs.

Déclencheur

Une condition et une réponse à un événement automatique définies par un projet ou un module complémentaire Apps Script. Les déclencheurs se déclenchent lorsque l'événement qui leur est associé se produit (par exemple, lorsqu'un module complémentaire est ouvert) et entraînent l'exécution automatique d'une fonction Apps Script spécifiée (la fonction du déclencheur). Pour les modules complémentaires Google Workspace, les fonctions de déclenchement créent souvent de nouvelles fiches afin de contrôler la partie de l'interface utilisateur du module complémentaire qui s'affiche. Seuls certains types d'événements peuvent avoir des déclencheurs.

Pour en savoir plus, consultez la section Déclencheurs de modules complémentaires.

Déclencher une fonction

Une fonction Apps Script dans un projet qui s'exécute en réponse à l'exécution d'un déclencheur.

Widget

Un élément d'interface utilisateur tel qu'un bouton, un champ de texte ou une case à cocher. Les fiches sont créées à partir d'une séquence d'objets widget, définie par le service Card intégré à Apps Script.

Pour en savoir plus, consultez la section Widgets.

Fonction de gestionnaire de widgets

Fonction qui associe un widget particulier à un objet d'action particulier. Chaque type de widget dispose d'un ensemble de fonctions de gestionnaire de widgets définies qu'il peut utiliser pour se connecter à des actions. Les fonctions de commande de widget définissent le type d'interaction utilisateur qui déclenche l'action qui en résulte et constituent un composant essentiel de l'interactivité des widgets.

Pour en savoir plus, consultez la section Fonctions de gestionnaire de widgets.