تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إعدادات المورد المستخدَمة لتحديد محتوى إضافة Google Workspace وسلوكها في Google Drive.
يجب أن تتضمّن بيانات Google Workspace الإضافية جميع المكوّنات التي تم وضع علامة مطلوب عليها إذا كانت توسّع Drive.
مطلوب لتوفير سلوك الإضافة الذي يتم تنشيطه من خلال اختيار المستخدم لعناصر في Drive. تصف هذه السمة وظيفة العامل المشغِّل السياقي لاختيارات العناصر في Google Drive.
OnItemsSelectedTrigger
إعداد لمشغّل سياقي يتم تنشيطه عندما يختار المستخدم ملفًا واحدًا أو أكثر أو مجلدات في Google Drive. يمكنك الاطّلاع على واجهة Drive السياقية للعناصر المحدّدة للحصول على مزيد من المعلومات.
تمثيل JSON
{
"runFunction": string
}
الحقول
runFunction
string
اسم الدالة التي سيتم تنفيذها عند اختيار ملفات أو مجلدات في Google Drive. في حال تحديدها، يجب تنفيذ هذه الدالة لإنشاء
وعرض مصفوفة من عناصر
Card
في واجهة مستخدم الإضافة.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Workspace Add-on manifests extending Drive must include all required components.\u003c/p\u003e\n"],["\u003cp\u003eDrive extensions utilize a manifest configuration for defining add-on content and behavior within Google Drive.\u003c/p\u003e\n"],["\u003cp\u003eAn \u003ccode\u003eonItemsSelectedTrigger\u003c/code\u003e is required in the manifest to enable add-on functionality when users select Drive items.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eonItemsSelectedTrigger\u003c/code\u003e specifies a function that builds and returns Card objects for the add-on UI.\u003c/p\u003e\n"]]],[],null,["# Drive 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)\ncontent and behavior within Google Drive.\nGoogle Workspace add-on manifests must have\nall the components marked as **Required** if they extend Drive.\n\nDrive\n-----\n\nThe Google Workspace add-on manifest configuration for\nGoogle Drive extensions. See\n[Extending Drive with Google Workspace add-ons](/workspace/add-ons/drive)\nfor more information.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------|\n| ```text { \"homepageTrigger\": { object (HomepageTrigger) }, \"onItemsSelectedTrigger\": { object (OnItemsSelectedTrigger) } } ``` |\n\n| Fields ||\n|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `homepageTrigger` | `object (`[HomepageTrigger](/apps-script/manifest/homepage-trigger)`)` The trigger function specification for creating the add-on [homepage](/workspace/add-ons/concepts/homepages) in the Drive host. This overrides [`addOns.common.homepageTrigger`](/apps-script/manifest/addons#Common.FIELDS.homepageTrigger). |\n| `onItemsSelectedTrigger` | `object (`[OnItemsSelectedTrigger](#onitemsselectedtrigger)`)` **Required to provide add-on behavior triggered by user selection of items in Drive.** The contextual trigger function specification for item selections in Google Drive. |\n\n### OnItemsSelectedTrigger\n\nA configuration for a contextual trigger that fires when a user selects\none or more files or folders in Google Drive. See\n[Drive contextual interface for items selected](/workspace/add-ons/drive/building-drive-interfaces#drive_contextual_interface_for_items_selected)\nfor more information.\n\n| JSON representation |\n|---------------------------------------|\n| ```text { \"runFunction\": string } ``` |\n\n| Fields ||\n|---------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `runFunction` | `string` The name of the function to run when files or folders are selected in Google Drive. If specified, you must implement this function to build and return an array of [`Card`](/apps-script/reference/card-service/card) objects for display in the add-on UI. |"]]
