Ressource de fichier manifeste homeTrigger
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Configuration de la ressource utilisée pour définir les déclencheurs de page d'accueil des modules complémentaires Google Workspace .
HomepageTrigger
Configuration du fichier manifeste du module complémentaire Google Workspace pour les déclencheurs de page d'accueil.
Les déclencheurs de page d'accueil peuvent être définis dans la ressource addOns.common.homepageTrigger ou dans les ressources des applications hôtes individuelles.
Le déclencheur de page d'accueil d'une application hôte, s'il est défini et activé, remplace le déclencheur de page d'accueil défini dans addOns.common.homepageTrigger.
Pour en savoir plus, consultez Configuration de la page d'accueil.
| Représentation JSON |
{
"enabled": boolean,
"runFunction": string
} |
| Champs |
enabled |
boolean
Indique si les fiches de page d'accueil (non contextuelles) sont activées pour cette application hôte. La valeur par défaut est true.
|
runFunction |
string
Nom de la fonction à exécuter lorsque ce déclencheur est activé. Si elle est spécifiée, vous devez implémenter cette fonction pour créer et renvoyer un tableau d'un ou plusieurs objets Card à afficher comme page d'accueil de ce module complémentaire dans cette application hôte.
|
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/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eHomepage triggers define the configuration for Google Workspace Add-on homepages, letting you control card display and functionality.\u003c/p\u003e\n"],["\u003cp\u003eThese triggers can be set globally or for specific host applications, with host-specific settings taking precedence.\u003c/p\u003e\n"],["\u003cp\u003eHomepage triggers are configured using the \u003ccode\u003eenabled\u003c/code\u003e and \u003ccode\u003erunFunction\u003c/code\u003e fields within the add-on's manifest file.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003erunFunction\u003c/code\u003e field points to a function that constructs and returns \u003ccode\u003eCard\u003c/code\u003e objects to populate the add-on's homepage.\u003c/p\u003e\n"]]],[],null,["# HomepageTrigger manifest resource\n\nThe resource configuration that is used to define\n[Google Workspace add-on](/workspace/add-ons/concepts/types#g_suite_add-ons)\n[homepage triggers](/workspace/add-ons/concepts/homepages#homepage_configuration).\n\nHomepageTrigger\n---------------\n\nThe Google Workspace add-on manifest configuration for\n[homepage triggers](/workspace/add-ons/concepts/homepages#homepage_configuration).\n\nHomepage triggers can be defined in the\n[`addOns.common.homepageTrigger`](/apps-script/manifest/addons#Common.FIELDS.homepageTrigger)\nresource or the resources of the individual\n[host applications](/workspace/add-ons/guides/glossary#host_or_host_application).\nThe homepage trigger of a host application, if defined and enabled, overrides\nthe homepage trigger defined in\n[`addOns.common.homepageTrigger`](/apps-script/manifest/addons#Common.FIELDS.homepageTrigger).\n\nSee [Homepage configuration](/workspace/add-ons/concepts/homepages#homepage_configuration)\nfor more details.\n\n| JSON representation |\n|-----------------------------------------------------------|\n| ```text { \"enabled\": boolean, \"runFunction\": string } ``` |\n\n| Fields ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `enabled` | `boolean` Whether or not homepage (non-contextual) cards are enabled for this host application. Defaults to `true`. |\n| `runFunction` | `string` The name of the function to run this trigger fires. If specified, you must implement this function to build and return an array of one or more [`Card`](/apps-script/reference/card-service/card) objects for display as this add-on's homepage in this host application. |"]]
