منبع مانیفست AddOns
پیکربندی منبعی که برای تعریف محتوا و رفتار افزونه Google Workspace استفاده میشود. مانیفستهای افزودنی Google Workspace باید دارای تمام اجزای علامتگذاری شده بهعنوان مورد نیاز باشند.
افزونه ها
سطح بالای پیکربندی مانیفست افزونه Google Workspace.
نمایندگی JSON |
---|
{ "common": { object (Common) }, "calendar": { object (Calendar) }, "drive": { object (Drive) }, "gmail": { object (Gmail) }, "docs": { object (Docs) }, "sheets": { object (Sheets) }, "slides": { object (Slides) } } |
فیلدها |
---|
common | object ( Common ) مورد نیاز. مقادیری را برای افزونه Google Workspace تعریف می کند که برای هر برنامه میزبان مشترک است. برخی از مقادیر تعریف شده در اینجا زمانی که مقادیر خاصی برای یک میزبان خاص حذف می شوند به عنوان پیش فرض استفاده می شوند. |
calendar | object ( Calendar ) اگر افزونه Google Workspace تقویم را گسترش دهد، الزامی است . پیکربندی ظاهر و رفتار افزونه Google Workspace در برنامه میزبان تقویم Google. اگر این قسمت حذف شود، افزونه در Google Calendar غیرفعال می شود. |
drive | object ( Drive ) اگر افزونه Google Workspace Google Drive را گسترش دهد، الزامی است . پیکربندی ظاهر و رفتار افزونه Google Workspace در برنامه میزبان Google Drive. اگر این قسمت حذف شود، افزونه در Google Drive غیرفعال می شود. |
gmail | object ( Gmail ) اگر افزونه Google Workspace Gmail را گسترش دهد، لازم است . پیکربندی ظاهر و رفتار افزونه Google Workspace در برنامه میزبان Gmail. اگر این قسمت حذف شود، افزونه در جیمیل غیرفعال می شود. |
docs | object ( Docs ) اگر افزونه Google Workspace Docs را گسترش دهد، لازم است . تنظیمات ظاهر و رفتار افزونه Google Workspace در برنامه میزبان Docs. اگر این قسمت حذف شود، افزونه در Docs غیرفعال می شود. |
sheets | object ( Sheets ) اگر افزونه Google Workspace Sheets را گسترش دهد، الزامی است . تنظیمات ظاهر و رفتار افزونه Google Workspace در برنامه میزبان Sheets. اگر این قسمت حذف شود، افزونه در کاربرگنگار غیرفعال میشود. |
slides | object ( Slides ) اگر افزونه Google Workspace Slides را گسترش دهد، لازم است . تنظیمات ظاهر و رفتار افزونه Google Workspace در برنامه میزبان اسلایدها. اگر این قسمت حذف شود، افزونه در اسلایدها غیرفعال می شود. |
مشترک
پیکربندی مانیفست برای پارامترهایی که برای هر برنامه میزبان مشترک هستند. برخی از مقادیر تعریف شده در اینجا زمانی که مقادیر خاصی برای یک میزبان خاص حذف می شوند به عنوان پیش فرض استفاده می شوند.
نمایندگی JSON |
---|
{ "homepageTrigger": { object (HomepageTrigger) }, "layoutProperties": { object (LayoutProperties) }, "logoUrl": string, "name": string, "openLinkUrlPrefixes": [ string ], "universalActions": [ { object (UniversalAction) } ], "useLocaleFromApp": boolean } |
فیلدها |
---|
homepageTrigger | object ( HomepageTrigger ) مشخصات عملکرد ماشه پیشفرض برای ایجاد صفحه اصلی افزونه. این مشخصات در صورتی استفاده میشود که یک راهانداز صفحه اصلی مخصوص میزبان تعریف نشده باشد. اگر این مورد نیز حذف شود، یک کارت صفحه اصلی عمومی ساخته شده و در صورت نیاز استفاده می شود. |
layoutProperties | object ( LayoutProperties ) پیکربندی برای رنگ های مورد استفاده در نوار ابزار و دکمه های افزودنی. |
logoUrl | string مورد نیاز. URL تصویر نشان داده شده در نوار ابزار. URL باید عمومی باشد. |
name | string مورد نیاز. نام افزونه نشان داده شده در نوار ابزار. |
openLinkUrlPrefixes[] | string اگر افزونه پیوندهای خروجی را نمایش میدهد، چه در ویجتها با استفاده از OpenLink یا ویجت متنی با استفاده از تگهای لنگر HTML، مورد نیاز است. فهرستی از پیشوندهای URL HTTPS. برای محافظت از داده های کاربر، هر پیوندی که توسط افزونه ارائه می شود باید با یکی از پیشوندهای این لیست مطابقت داشته باشد. برای جزئیات بیشتر به URL های لیست مجاز مراجعه کنید. |
universalActions[] | object ( UniversalAction ) فهرست اقدامات جهانی که همیشه در رابط کاربری افزونه در دسترس هستند. |
useLocaleFromApp | boolean اگر true ، اشیاء رویداد افزودنی که به توابع پاسخ به تماس اقدام یا توابع راهانداز ارسال میشوند، شامل اطلاعات منطقه و منطقه زمانی کاربر میشوند. پیش فرض ها به false . برای جزئیات بیشتر به دسترسی به منطقه محلی کاربر و مناطق زمانی مراجعه کنید. |
LayoutProperties
پیکربندی که کنترل می کند رنگ ها و ظاهر دکمه ها و نوار ابزار افزودنی.
نمایندگی JSON |
---|
{ "primaryColor": string, "secondaryColor": string } |
فیلدها |
---|
primaryColor | string رنگ نوار ابزار پیشفرض خاکستری (#424242). |
secondaryColor | string رنگ پیش فرض دکمه ها رنگ اصلی را پیشفرض میکند (اگر تنظیم شده باشد). در غیر این صورت پیش فرض آبی (#2196F3) است. |
یونیورسال اکشن
پیکربندی برای یک عمل جهانی . وقتی انتخاب شد، یک کنش جهانی یا پیوند URL مشخص شده را باز میکند، یا عملکرد Apps Script مشخص شده را اجرا میکند.
نمایندگی JSON |
---|
{ "label": string,
// Union field rule can be only one of the following: "openLink": string, "runFunction": string, // End of list of possible types for union field rule.
} |
فیلدها |
---|
label | string برای هر عمل جهانی لازم است. متنی که در منوی UI برای این عمل نشان داده شده است. |
openLink | string اگر runFunction وجود نداشته باشد، برای هر اقدام جهانی لازم است. در صورت ارائه، نشانی اینترنتی که هنگام انتخاب این عملکرد توسط کاربر در یک برگه باز می شود. |
runFunction | string اگر openLink وجود نداشته باشد برای هر اقدام جهانی لازم است. در صورت ارائه، نام تابع Apps Script که هنگام انتخاب کاربر اجرا می شود. برای جزئیات به راهنمای اقدامات جهانی مراجعه کنید. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-01-06 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-06 بهوقت ساعت هماهنگ جهانی."],[[["Google Workspace Add-on manifests define add-on content and behavior, requiring specific configurations for each supported host application (Calendar, Drive, Gmail, Docs, Sheets, Slides)."],["A common configuration section sets defaults for all host applications, including homepage triggers, layout properties, logo URL, add-on name, allowed outbound link prefixes, and universal actions."],["Each host application configuration controls the add-on's appearance and behavior within that specific application; omitting a host's configuration disables the add-on for that application."],["Universal actions, configurable in the common section, enable consistent add-on functionality across hosts, allowing either opening a URL or running an Apps Script function."],["Add-on developers must define allowed outbound link prefixes to ensure user data protection, restricting links rendered by the add-on to the specified prefixes."]]],[]]