Glossaire

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

Module complémentaire de conférence Agenda

Type de module complémentaire spécial 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. En raison de cette exigence, 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 des conférences Agenda. Consultez également Mettre à niveau les modules complémentaires que vous avez publiés pour découvrir comment convertir un module complémentaire de conférence Agenda en module complémentaire Google Workspace.

Carte

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

Pour en savoir plus, consultez la section Fiches.

Basé sur une carte

Module complémentaire dont l'interface utilisateur apparaît sous la forme d'un volet dans la barre latérale (ou, sur mobile, lorsqu'une autre fenêtre d'activité est atteinte via le menu). Celui-ci dispose d'une barre d'outils supérieure qui l'identifie et affiche une fiche, essentiellement une "page" de son interface utilisateur.

Les modules complémentaires Google Workspace se présentent sous forme de fiches.

Données de conférence

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

Pour en savoir plus, consultez la section 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 du module complémentaire de conférence Agenda.

Pour en savoir plus, consultez la page Solutions de conférence.

Contexte

État actuel de l'application hôte. Par exemple, le message actuellement ouvert dans Gmail, l'événement d'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, sont collectés dans un objet d'événement qui est transmis à la fonction du déclencheur en tant que paramètre.

Déclenchement contextuel

Pratique consistant à 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 dans Gmail. Le déclenchement contextuel permet au 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 donc un type de déclencheur de fichier manifeste.

Modules complémentaires de l'éditeur

Ensemble initial de types de modules complémentaires qui n'autorisaient que les extensions Google Docs, Sheets, Forms ou Slides. Les modules complémentaires de l'éditeur ne sont pas basés sur des fiches. Ils exigent que le développeur crée une UI à 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 la section Modules complémentaires des éditeurs.

Objet événement

Objet JSON créé automatiquement lorsque des pages d'accueil sont demandées, lorsque le module complémentaire saisit des 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 de rappel spécifiée. Les objets d'événement ont pour but 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) vers le 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 la section Objets d'événement.

Modules complémentaires Gmail

Module complémentaire qui étend uniquement Gmail. Les modules complémentaires Gmail se présentent sous forme de fiches. Une grande partie des fonctionnalités, du comportement et des détails de développement permettant de créer des modules complémentaires Gmail sont identiques à ceux de la création de modules complémentaires Google Workspace.

Pour en savoir plus, consultez la section Modules complémentaires Gmail. Consultez également Mettre à niveau les modules complémentaires que vous avez publiés pour découvrir 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. Ce dernier permet d'afficher du contenu en dehors d'un contexte spécifique (par exemple, lorsque l'utilisateur consulte ses fils de discussion dans Gmail, mais ne l'a pas ouvert). Vous définissez l'apparence et le comportement de la page d'accueil de votre module complémentaire, comme n'importe quelle autre fiche.

Pour en savoir plus, consultez la section Pages d'accueil.

Application hôte ou hôte

Un module complémentaire Google Workspace étend l'application Google Workspace, par exemple Gmail ou Google Agenda.

HTML

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

Les déclencheurs d'aperçu de lien se déclenchent lorsque des 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 depuis votre service ou 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 donc un type de déclencheur de fichier manifeste.

Pour en savoir plus, consultez la section Prévisualiser les liens dans Google Docs.

Manifest

Fichier JSON associé à un projet Apps Script. Le fichier manifeste permet de définir les informations concernant le projet dont le script a besoin pour s'exécuter correctement. Pour les modules complémentaires Google Workspace, le fichier manifeste permet d'indiquer les hôtes que le module complémentaire peut étendre et de fournir certains paramètres de commande d'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 d'un module complémentaire est demandée ou lorsqu'il entre dans un contexte nécessitant une mise à jour de l'affichage.

Les déclencheurs du fichier manifeste se distinguent 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 par programmation avec le service Script Apps Script (comme les déclencheurs installables).

Cartes non contextuelles

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

Section à droite de l'interface utilisateur hôte où s'affiche l'interface utilisateur d'un module complémentaire Google Workspace. Gmail et les modules complémentaires des éditeurs peuvent également définir des barres latérales.

Chip intelligent

Un chip intelligent fait référence à une personne, à un fichier, à un événement d'agenda ou à une autre entité dans une application Google Workspace. Lorsque les utilisateurs survolent un chip, ils peuvent également prévisualiser du contenu supplémentaire sur le fichier ou le lien. Par exemple, lorsque les utilisateurs passent la souris sur un chip pour accéder à une présentation Google Slides, ils voient la capture d'écran d'une diapositive, le propriétaire de la présentation et s'ils l'ont déjà consultée.

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

Déclencheur

Une condition et une réponse automatique à l'événement définies par un projet ou un module complémentaire Apps Script Les déclencheurs s'exécutent lorsque l'événement 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 de déclenchement). 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 des modules complémentaires à afficher. Seuls certains types d'événements peuvent comporter des déclencheurs.

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

Fonction de déclenchement

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

Widget

Élément d'interface utilisateur tel qu'un bouton, un champ de texte ou une case à cocher. Les cartes sont construites à partir d'une séquence d'objets widget, définie par le service de carte 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 possède un ensemble de fonctions de gestionnaire de widgets définies qui peuvent être utilisées pour se connecter à des actions. Les fonctions de gestionnaire de widgets définissent le type d'interaction utilisateur qui déclenche l'action qui en résulte. Elles sont un composant essentiel de l'interactivité des widgets.

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