Types de modules complémentaires
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page fournit un aperçu général des deux types de modules complémentaires que vous pouvez créer : les modules complémentaires Google Workspace et les modules complémentaires d'éditeur. Ces types de modules complémentaires diffèrent en fonction des applications qu'ils étendent, de la manière dont ils sont créés et des restrictions qui leur sont appliquées.
Modules complémentaires Google Workspace
Les modules complémentaires Google Workspace sont la dernière génération de modules complémentaires. Ils offrent de nombreuses fonctionnalités, y compris :
Créer un seul module complémentaire pour plusieurs applications Google Workspace : au lieu de créer des modules complémentaires distincts pour chaque application Google Workspace, vous pouvez créer et gérer un seul module complémentaire Google Workspace qui fonctionne dans l'ensemble de Google Workspace.
Un module complémentaire Google Workspace peut étendre les applications hôtes suivantes :
- Gmail
- Google Agenda
- Google Chat (version Preview développeur)
- Google Docs
- Google Drive
- Google Meet
- Google Sheets
- Google Slides
Améliorez la notoriété de votre marque : les icônes des modules complémentaires sont visibles par défaut dans le panneau de droite des applications hôtes du module complémentaire.
Créer des expériences sur la page d'accueil : vous pouvez créer des pages d'accueil individuelles pour chaque application Google Workspace que votre module complémentaire étend, ou utiliser la même page d'accueil pour plusieurs applications.
Reflétez le contexte de l'utilisateur dans votre module complémentaire : vous pouvez concevoir votre module complémentaire Google Workspace pour qu'il affiche des interfaces spécifiques à l'application hôte du module complémentaire. Par exemple, votre module complémentaire peut afficher des informations provenant d'un e-mail ou d'un événement d'agenda, ou suggérer une action en fonction de la page actuelle de l'application Google Workspace.
Utiliser des interfaces standardisées : créez des interfaces utilisateur à partir d'éléments de widget intégrés fournis par le service Card Apps Script. Vous n'avez pas besoin d'être un expert en HTML ou CSS pour définir ces interfaces.
Étendre les clients de bureau et mobiles pour Gmail : si un module complémentaire Google Workspace étend Gmail, vous pouvez l'utiliser dans les versions pour ordinateur et mobile de Gmail. Si vous créez un module complémentaire Google Workspace qui étend Gmail, vous n'avez pas besoin de concevoir une version mobile distincte du module complémentaire. La même interface est utilisée partout.
Utilisez l'environnement d'exécution de votre choix. Vous pouvez développer des modules complémentaires Google Workspace avec l'infrastructure d'hébergement, la chaîne d'outils de développement, le système de gestion de code source, le langage de programmation et les bibliothèques de code de votre choix.
Modules complémentaires de l'éditeur
Les modules complémentaires de l'éditeur étendent l'une des applications de l'éditeur Google, comme Docs, Sheets, Slides ou Forms. Chaque type de module complémentaire de l'éditeur (par exemple, les modules complémentaires Sheets) peut avoir son propre ensemble de capacités, de restrictions et de considérations spécifiques à un type. Lorsque vous créez des modules complémentaires pour les éditeurs, il est important de comprendre ces détails spécifiques aux éditeurs. Pour en savoir plus sur les modules complémentaires pour des éditeurs spécifiques, consultez les sections correspondantes :
Les modules complémentaires Editor peuvent automatiser les tâches courantes de l'éditeur, comme la création, la modification et la mise en forme de fichiers, ainsi que le transfert de données entre les applications.
Les interfaces de modules complémentaires d'éditeur sont hautement personnalisables pour les tâches à accomplir.
Les modules complémentaires de l'éditeur sont idéaux pour automatiser des tâches dans Google Docs, Sheets, Slides ou Forms pour un usage individuel ou interne. Pour les modules complémentaires nécessitant des capacités à grande échelle pouvant gérer de nombreux utilisateurs, nécessitant une faible latence ou exigeant un contrôle total sur votre infrastructure, envisagez de créer des modules complémentaires Google Workspace dans un environnement d'exécution différent pour mieux contrôler les processus d'infrastructure, de déploiement et de publication.
Les modules complémentaires des éditeurs se comportent différemment des modules complémentaires Google Workspace de la manière suivante :
- Les modules complémentaires d'éditeur peuvent créer des interfaces composées d'éléments de menu, de boîtes de dialogue et de barres latérales. Les boîtes de dialogue et les barres latérales des modules complémentaires sont définies à l'aide des normes HTML et CSS.
- Les modules complémentaires de l'éditeur sont soumis à des règles d'autorisation spéciales, car ils créent, modifient ou interagissent avec des fichiers dans Google Drive. Il est important de comprendre l'autorisation du module complémentaire de l'éditeur lorsque vous développez un module complémentaire de l'éditeur.
- Les fichiers créés et mis à jour dans chaque éditeur ont des structures spécifiques. Par exemple, les présentations Google Slides sont composées de pages qui peuvent être des diapositives, des masques ou des mises en page. Vous devez comprendre ces structures de fichiers, car les modules complémentaires interagissent souvent avec elles lorsqu'ils lisent ou modifient des fichiers.
- Les modules complémentaires de l'éditeur ne fonctionnent que dans les clients pour ordinateur, et non sur Android ni iOS.
- Les modules complémentaires de l'éditeur doivent être implémentés dans Apps Script.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/26 (UTC).
[null,null,["Dernière mise à jour le 2025/08/26 (UTC)."],[[["\u003cp\u003eGoogle Workspace add-ons offer a unified solution, extending functionalities across multiple Google Workspace applications like Gmail, Calendar, and Docs with a single add-on.\u003c/p\u003e\n"],["\u003cp\u003eEditor add-ons focus on enhancing specific Google Editors (Docs, Sheets, Slides, Forms) with custom interfaces and automation capabilities but are limited to desktop use.\u003c/p\u003e\n"],["\u003cp\u003eWhile Workspace add-ons utilize standardized interfaces and work seamlessly across platforms, Editor add-ons require HTML/CSS knowledge and adhere to specific authorization rules.\u003c/p\u003e\n"],["\u003cp\u003eBoth add-on types provide distinct advantages; Workspace add-ons enhance cross-application workflows, while Editor add-ons offer deep, editor-specific customization and task automation.\u003c/p\u003e\n"]]],["There are two add-on types: Google Workspace and Editor add-ons. Google Workspace add-ons offer a single build for multiple apps (Gmail, Calendar, Chat, Docs, Drive, Sheets, Slides), and they feature standardized interfaces, mobile and desktop compatibility, and customizable homepages. Editor add-ons extend Docs, Sheets, Slides, and Forms, allowing for highly customizable interfaces using HTML and CSS, but require specific authorization and only function on desktop. They are built to automate common editor tasks.\n"],null,["This page provides a general overview of the two types of add-ons\nyou can build:\n*Google Workspace add-ons* and *Editor add-ons*. These\nadd-on types differ in what applications they extend,\nhow they are created, and what restrictions they have.\n\nGoogle Workspace add-ons\n\n*Google Workspace add-ons* are the latest generation of add-ons, and\nprovide many capabilities, including:\n\n- **Build just one add-on for multiple\n Google Workspace apps**: Instead of creating separate\n add-ons for\n each Google Workspace application, you can build and manage a single\n Google Workspace add-on that works across Google Workspace.\n A Google Workspace add-on can extend the following host applications:\n\n - Gmail\n - Google Calendar\n - Google Chat (Developer Preview)\n - Google Docs\n - Google Drive\n - Google Meet\n - Google Sheets\n - Google Slides\n- **Increase your brand awareness**: Add-ons icons are by\n default visible in the right-side panel of the\n add-on's host apps.\n\n- **Build homepage experiences** : You can create individual [homepages](/workspace/add-ons/concepts/homepages)\n for each Google Workspace app your add-on\n extends, or use the same homepage for multiple apps.\n\n- **Reflect the user's context in your add-on**: You\n can design your Google Workspace add-on to show interfaces specific to the\n add-on's host app. For example, your\n add-on can display info from an email or calendar\n event, or suggest an action based on the current Google Workspace app\n page.\n\n- **Use standardized interfaces** : Construct user interfaces from built-in\n widget elements provided by the Apps Script\n [`Card`](/apps-script/reference/card-service/card) service. You don't need\n any expertise with HTML or CSS to define these interfaces.\n\n- **Extend desktop and mobile clients for Gmail**: If a\n Google Workspace add-on extends Gmail, you can use it in both the\n desktop and mobile versions of Gmail. If you build a\n Google Workspace add-on that extends Gmail, you don't need to\n design a separate mobile version of the add-on. The\n same interface is used everywhere.\n\n- **Use your preferred runtime.** You can develop Google Workspace add-ons with your\n preferred hosting infrastructure, development tool chain, source control\n system, coding language, and code libraries.\n\nEditor add-ons\n\n*Editor add-ons* extend one of the Google Editor applications,\nsuch as Docs, Sheets, Slides, or\nForms. Each Editor add-on type (for\nexample, Sheets add-ons) can have its own set of\ntype-specific capabilities, restrictions, and special considerations. When\nbuilding Editor add-ons, it's important to understand these\nEditor-specific details. For more details on add-ons for specific\nEditors, see the corresponding sections:\n\n- [Google Docs](/workspace/add-ons/editors/docs)\n- [Google Forms](/workspace/add-ons/editors/forms)\n- [Google Sheets](/workspace/add-ons/editors/sheets)\n- [Google Slides](/workspace/add-ons/editors/slides)\n\nEditor add-ons can automate common editor tasks such as file\ncreation, editing, formatting, and moving data between applications.\nEditor add-on interfaces are highly-customizable for\nthe tasks at hand.\n\nEditor add-ons are ideal for automating tasks within Google\nDocs, Sheets, Slides, or\nForms for individual or internal use. For add-ons\nrequiring large-scale capabilities that need to handle many users, require low\nlatency, or demands full control over your infrastructure, consider building a\nGoogle Workspace add-ons on a [different runtime](/workspace/add-ons/guides/alternate-runtimes)\nenvironment for better control over infrastructure, deployment and release\nprocesses.\n\nEditor add-ons behave differently from Google Workspace add-ons in the\nfollowing ways:\n\n- Editor add-ons can create interfaces consisting of menu items, dialogs, and sidebars. Add-ons dialogs and sidebars are defined using standard [HTML and\n CSS](/workspace/add-ons/concepts/html-interfaces).\n- Editor add-ons have special authorization rules because they create, modify, or otherwise interact with files within Google Drive. It is important to understand the [Editor add-on\n authorization](/workspace/add-ons/concepts/editor-auth-lifecycle) while developing an Editor add-on.\n- Files created and updated in each editor have specific structures. For example, Google Slides presentations are composed of pages which can be slides, masters, or layouts. You should understand these file structures, as add-ons often interact with them when reading or editing files.\n- Editor add-ons only function in desktop clients, not Android or iOS.\n- Editor add-ons must be implemented in Apps Script."]]
