مورد البيان الخاص بمشغّل الصفحة الرئيسية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إعدادات المورد المستخدَمة لتحديد
مشغّلات الصفحة الرئيسية لإضافة Google Workspace
HomepageTrigger
إعدادات بيان إضافة Google Workspace الخاصة
بمشغّلات الصفحة الرئيسية
يمكن تحديد مشغّلات الصفحة الرئيسية في مورد
addOns.common.homepageTrigger
أو موارد
تطبيقات المضيف الفردية.
إذا تم تحديد وتفعيل مشغّل الصفحة الرئيسية لتطبيق مضيف، سيحلّ محل مشغّل الصفحة الرئيسية المحدّد في addOns.common.homepageTrigger.
لمزيد من التفاصيل، يُرجى الاطّلاع على إعداد الصفحة الرئيسية.
| تمثيل JSON |
{
"enabled": boolean,
"runFunction": string
} |
| الحقول |
enabled |
boolean
تحدّد هذه السمة ما إذا كانت بطاقات الصفحة الرئيسية (غير السياقية) مفعّلة لهذا التطبيق المضيف. القيمة التلقائية هي true.
|
runFunction |
string
اسم الدالة التي سيتم تشغيلها عند تفعيل عامل التشغيل هذا في حال تحديدها، يجب تنفيذ هذه الدالة لإنشاء وعرض مصفوفة تتضمّن عنصرًا واحدًا أو أكثر من عناصر Card لعرضها كصفحة رئيسية للإضافة في التطبيق المضيف.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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. |"]]
