این صفحه ساختار اشیاء رویداد افزونههای Google Workspace را تشریح میکند.
اشیاء رویداد ساختارهای JSON هستند که بهطور خودکار ساخته میشوند و بهعنوان پارامترهایی برای راهاندازی یا بازگشت به تماس در هنگام تعامل کاربر با یک افزونه ارسال میشوند. اشیاء رویداد اطلاعات سمت سرویس گیرنده را در مورد برنامه میزبان و زمینه فعلی به عملکرد پاسخ به تماس سمت سرور افزونه منتقل می کنند.
افزونههای Google Workspace از اشیاء رویداد در مکانهای زیر استفاده میکنند:
محرک های صفحه اصلی هر تابع
homepageTrigger
که تعریف میکنید بهطور خودکار به یک شی رویداد ارسال میشود که تابع ماشه صفحه اصلی فعال شود. میتوانید از این شی در عملکرد راهاندازی صفحه اصلی خود برای شناسایی برنامه میزبان فعال، پلت فرم مشتری، منطقه کاربر و سایر اطلاعات استفاده کنید.اشیاء رویدادی که هنگام فعال کردن صفحه اصلی ایجاد میشوند، شامل تمام فیلدهای موجود در دو مورد دیگر نیستند. فیلدهای مربوط به ویجت ها و اطلاعات متنی حذف می شوند.
محرک های متنی هر برنامه میزبان مجموعه متفاوتی از محرک های متنی را ارائه می دهد که وقتی کاربر وارد یک زمینه خاص می شود، فعال می شود. به عنوان مثال:
- Gmail یک محرک متنی برای زمانی که کاربر پیامی را باز می کند و زمانی که کاربر پیامی را می نویسد، راه اندازی می کند.
- Google Calendar برای زمانی که کاربر یک رویداد را باز میکند، یک محرک متنی ارائه میکند.
- Google Drive یک محرک متنی برای زمانی که کاربر فایلهای Drive را انتخاب میکند فراهم میکند.
هنگامی که یک تریگر متنی فعال می شود، برنامه میزبان،
runFunction
مربوطه را که در مانیفست افزودنی فهرست شده است، فراخوانی می کند و آن را به عنوان یک شی رویداد به عنوان پارامتر ارسال می کند. اشیاء رویدادی که هنگام روشن شدن تریگرهای متنی ایجاد میشوند، شامل تمام فیلدهای موجود در اشیاء رویداد راهانداز صفحه اصلی، بهعلاوه فیلدهای حاوی اطلاعات متنی هستند.اقدامات ویجت اشیاء رویداد همچنین برای ارائه تعامل ویجت ، با استفاده از همان مدل عملکردی که افزونههای Gmail استفاده میکنند، استفاده میشوند. افزونههای Google Workspace از همه عملکردهای کنترلکننده ویجت، اشیاء
Action
و پاسخهای کنشی استفاده میکنند. با این حال، در افزونههای Google Workspace ، اشیاء رویداد اقدام حاوی اطلاعات بیشتری هستند که یک تابع پاسخ به تماس میتواند روی آنها عمل کند.اشیاء رویداد ایجاد شده در نتیجه اقدامات ویجت شامل تمام فیلدهای موجود در اشیاء رویداد محرک متنی، به علاوه فیلدهای حاوی اطلاعات ویجت هستند.
پیشنمایش محرکهای پیوند . در Google Docs، Sheets و Slides میتوانید پیشنمایش پیوندها را برای سرویسهای شخص ثالث بر اساس الگوهای URL خاص پیکربندی کنید. هنگامی که کاربران با پیوندی که با الگو مطابقت دارد تعامل میکنند،
linkPreviewTriggers
فعال میشود و یک شی رویداد که حاوی پیوند است به تابع پاسخ تماس ماشه ارسال میشود. افزونه شما میتواند از این شی رویداد برای ساخت یک تراشه و کارت هوشمند استفاده کند که اطلاعات پیوند را در برنامه میزبان نشان میدهد. همچنین میتوانید اقدامات ویجت را بسازید تا به کاربران اجازه دهید با کارت پیشنمایش و محتویات آن تعامل داشته باشند.
ساختار شی رویداد
جدول زیر ساختار سطح بالای اشیاء رویداد Google Workspace Add-ons را توضیح می دهد. ساختار شی رویداد شامل یک فیلد سطح بالای commonEventObject
برای اطلاعات مستقل از میزبان است. هر شی رویداد همچنین میتواند یکی از فیلدهای سطح بالای مخصوص میزبان زیر را داشته باشد که توسط برنامه میزبان فعال تعیین میشود: gmailEventObject
، calendarEventObject
، یا driveEventObject
.
برای سازگاری با گذشته، اشیاء رویداد افزونههای Google Workspace همچنین شامل تمام فیلدهای اصلی مورد استفاده در اشیاء رویداد رویداد افزودنی Gmail است. این فیلدها در جدول زیر در قسمت «فیلدهای افزودنی اصلی Gmail» فهرست شدهاند. اطلاعات در این زمینه ها در ساختار شی جدید تولید می شود.
شی رویداد | |
---|---|
eventObject.commonEventObject | Common fields object یک شی حاوی اطلاعات مشترک برای همه اشیاء رویداد، صرف نظر از برنامه میزبان. |
eventObject.calendar | Calendar event object فقط در صورتی ارائه شود که میزبان تماس گیرنده Google Calendar باشد . یک شی حاوی اطلاعات تقویم و رویداد. |
eventObject.drive | Drive event object فقط در صورتی ارائه شود که میزبان تماس گیرنده Google Drive باشد . یک شی حاوی اطلاعات Drive. |
eventObject.gmail | Gmail event object فقط در صورتی ارائه شود که میزبان تماس گیرنده Gmail باشد . یک شی حاوی اطلاعات Gmail. |
eventObject.docs | Docs event object فقط در صورتی ارائه شود که میزبان تماس گیرنده Google Docs باشد . یک شی حاوی اطلاعات Docs. |
eventObject.sheets | Sheets event object فقط در صورتی ارائه شود که میزبان تماس گیرنده Google Sheets باشد . یک شی حاوی اطلاعات Sheets. |
eventObject.slides | Slides event object فقط در صورتی ارائه شود که میزبان تماس گیرنده Google Slides باشد . یک شی حاوی اطلاعات اسلایدها. |
فیلدهای افزودنی اصلی Gmail | |
eventObject.messageMetadata.accessToken | string منسوخ شده است. یک نشانه دسترسی میتوانید از این برای روشن کردن دسترسی به دادههای کاربر با استفاده از دامنههای افزودنی موقت Gmail استفاده کنید. برای افزونههای Google Workspace، این اطلاعات را در قسمت |
eventObject.messageMetadata.messageId | string منسوخ شده است. شناسه پیام موضوع در رابط کاربری Gmail باز می شود. برای افزونههای Google Workspace، این اطلاعات را در قسمت |
eventObject.clientPlatform | string منسوخ شده است. نشان می دهد که رویداد از کجا شروع شده است (وب، iOS یا Android). برای افزونههای Google Workspace، این اطلاعات را در قسمت |
eventObject.formInput | object منسوخ شده است. نقشه ای از مقادیر فعلی همه ویجت های فرم در کارت، محدود به یک مقدار در هر ویجت. کلیدها شناسههای رشته مرتبط با ویجتها هستند و مقادیر رشتهها هستند. شی رویداد formInput برای زمانی که نیاز به خواندن دادهها از چندین ویجت با مقادیر تک مورد انتظار دارید، مانند ورودیهای متن و سوئیچها، آسان میکند. برای ویجتهای چند ارزشی مانند چک باکسها، میتوانید هر مقدار را از formInputs بخوانید. برای افزونههای Google Workspace، این اطلاعات را در قسمت |
eventObject.formInputs | object منسوخ شده است. نقشه ای از مقادیر فعلی ویجت ها در کارت که به صورت لیست رشته ها ارائه می شود. کلیدها شناسههای رشته مرتبط با ویجت هستند. برای ویجت های تک ارزشی، مقدار در یک آرایه تک عنصری ارائه می شود. برای ویجت های چند ارزشی مانند گروه های چک باکس، همه مقادیر در یک لیست ارائه می شوند. برای افزونههای Google Workspace، این اطلاعات را در قسمت |
eventObject.parameters | object منسوخ شده است. نقشه ای از هر پارامتر اضافی که با استفاده از Action.setParameters() به Action می دهید. کلیدها و مقادیر نقشه رشته هستند. برای افزونههای Google Workspace، این اطلاعات را در قسمت |
eventObject.userCountry | string به طور پیش فرض منسوخ و غیرفعال شده است . کد دو حرفی که کشور یا منطقه کاربر را نشان می دهد. همچنین می تواند یک کد کشوری UN M49 عددی باشد. برای افزونههای Google Workspace، این اطلاعات را در قسمت |
eventObject.userLocale | string به طور پیش فرض منسوخ و غیرفعال شده است . کد ISO 639 دو حرفی که زبان کاربر را نشان می دهد. برای جزئیات بیشتر به دسترسی به منطقه کاربری و منطقه زمانی مراجعه کنید. برای افزونههای Google Workspace، این اطلاعات را در قسمت |
eventObject.userTimezone.id | string به طور پیش فرض منسوخ و غیرفعال شده است . شناسه منطقه زمانی منطقه زمانی کاربر. مثالها عبارتند از: America/New_York ، Europe/Vienna ، و Asia/Seoul . برای جزئیات بیشتر به دسترسی به منطقه کاربری و منطقه زمانی مراجعه کنید. برای افزونههای Google Workspace، این اطلاعات را در قسمت |
eventObject.userTimezone.offset | string به طور پیش فرض منسوخ و غیرفعال شده است . تغییر زمان از زمان هماهنگ جهانی (UTC) منطقه زمانی کاربر، اندازهگیری شده در میلیثانیه. برای جزئیات بیشتر به دسترسی به منطقه کاربری و منطقه زمانی مراجعه کنید. برای افزونههای Google Workspace، این اطلاعات را در قسمت |
شی رویداد مشترک
شی رویداد مشترک بخشی از شی رویداد کلی است که اطلاعات کلی و مستقل از میزبان را از مشتری کاربر به افزونه حمل می کند. این اطلاعات شامل جزئیاتی مانند منطقه محلی کاربر، برنامه میزبان و پلت فرم است.
علاوه بر صفحه اصلی و محرکهای متنی، افزونهها هنگام تعامل کاربر با ویجتها، اشیاء رویداد را میسازند و به عملکردهای پاسخ به تماس منتقل میکنند. تابع تماس برافزای شما میتواند شی رویداد مشترک را برای تعیین محتوای ویجتهای باز در کلاینت کاربر جستجو کند. به عنوان مثال، افزونه شما می تواند متنی را که کاربر در ویجت TextInput
وارد کرده است در شی eventObject.commentEventObject.formInputs
بیابد.
فیلدهای شی رویداد رایج | |
---|---|
commonEventObject.platform | string نشان میدهد که رویداد از کجا شروع میشود («WEB»، «IOS» یا «ANDROID»). |
commonEventObject.formInputs | object نقشه ای حاوی مقادیر فعلی ویجت ها در کارت نمایش داده شده. کلیدهای نقشه، شناسههای رشتهای هستند که به هر ویجت اختصاص داده میشوند. ساختار شی ارزش نقشه به نوع ویجت بستگی دارد: برای مثال، به جای برای کسب اطلاعات بیشتر در مورد زمان اجرا در Apps Script، به نمای کلی زمان اجرا V8 مراجعه کنید.
|
commonEventObject.hostApp | string نشاندهنده برنامه میزبانی است که افزونه در هنگام ایجاد شی رویداد در آن فعال است. مقادیر ممکن شامل موارد زیر است:
|
commonEventObject.parameters | object هر پارامتر اضافی که با استفاده از Action.setParameters() به Action ارائه می کنید. |
commonEventObject.userLocale | string به طور پیش فرض غیرفعال است . زبان کاربر و شناسه کشور/منطقه در قالب کد زبان ISO 639- کد کشور/منطقه ISO 3166 . به عنوان مثال، en-US . برای روشن کردن این فیلد، باید |
commonEventObject.timeZone | string به طور پیش فرض غیرفعال است . شناسه منطقه زمانی و افست. برای روشن کردن این فیلد، باید addOns.common.useLocaleFromApp روی true در مانیفست افزونه خود تنظیم کنید. فهرست دامنه افزونه شما باید شامل https://www.googleapis.com/auth/script.locale نیز باشد. برای جزئیات بیشتر به دسترسی به منطقه کاربری و منطقه زمانی مراجعه کنید. |
commonEventObject.timeZone.id | string شناسه منطقه زمانی منطقه زمانی کاربر. مثالها عبارتند از: America/New_York ، Europe/Vienna ، و Asia/Seoul . برای روشن کردن این فیلد، باید addOns.common.useLocaleFromApp روی true در مانیفست افزونه خود تنظیم کنید. فهرست دامنه افزونه شما باید شامل https://www.googleapis.com/auth/script.locale نیز باشد. برای جزئیات بیشتر به دسترسی به منطقه کاربری و منطقه زمانی مراجعه کنید. |
commonEventObject.timeZone.offset | string تغییر زمان از زمان هماهنگ جهانی (UTC) منطقه زمانی کاربر، اندازهگیری شده در میلیثانیه. برای جزئیات بیشتر به دسترسی به منطقه کاربری و منطقه زمانی مراجعه کنید. |
ورودیهای فرم انتخابگر تاریخ
توابع پاسخ به تماس اقدام می توانند مقادیر فعلی ویجت را در قسمت commonEventObject.formInputs
دریافت کنند. این شامل مقادیر تاریخ یا زمان انتخابی کاربر در ویجتهای انتخابگر تاریخ یا زمان است. با این حال، ساختار اطلاعات بسته به اینکه ویجت به عنوان یک انتخابگر تاریخ، یک انتخاب کننده فقط تاریخ، یا یک انتخاب کننده فقط زمان پیکربندی شده باشد، متفاوت است. تفاوت های ساختاری در جدول زیر شرح داده شده است:
شی رویداد تقویم
شی رویداد Calendar بخشی از شی رویداد کلی است که اطلاعات مربوط به تقویم و رویدادهای تقویم کاربر را حمل می کند. تنها در صورتی در یک شی رویداد وجود دارد که برنامه میزبان Google Calendar باشد.
جدول زیر فیلدهای موجود در فیلد calendarEventObject
یک شی رویداد را فهرست می کند. فیلدهایی که بهعنوان دادههای تولید شده توسط کاربر علامتگذاری شدهاند در شی رویداد وجود دارند، اگر و تنها در صورتی که دادهها در رویداد Calendar وجود داشته باشد و افزونه فیلد مانیفست addOns.calendar.currentEventAccess
را روی READ
یا READ_WRITE
تنظیم کند.
شی رویداد تقویم | |
---|---|
calendar.attendees[] | list of attendee objects داده های تولید شده توسط کاربر لیستی از شرکت کنندگان در رویداد تقویم. |
calendar.calendarId | string شناسه تقویم |
calendar.capabilities | object داده های تولید شده توسط کاربر شیئی که قابلیت های افزونه را برای مشاهده یا به روز رسانی اطلاعات رویداد توصیف می کند. |
calendar.capabilities.canAddAttendees | boolean داده های تولید شده توسط کاربر true اگر افزونه بتواند شرکت کنندگان جدیدی را به لیست شرکت کنندگان رویداد اضافه کند. false در غیر این صورت |
calendar.capabilities.canSeeAttendees | boolean داده های تولید شده توسط کاربر true اگر افزونه بتواند لیست شرکت کنندگان رویداد را بخواند. false در غیر این صورت |
calendar.capabilities.canSeeConferenceData | boolean داده های تولید شده توسط کاربر true اگر افزونه بتواند داده های کنفرانس رویداد را بخواند. false در غیر این صورت |
calendar.capabilities.canSetConferenceData | boolean داده های تولید شده توسط کاربر true اگر افزونه بتواند داده های کنفرانس رویداد را به روز کند. false در غیر این صورت |
calendar.capabilities.canAddAttachments | boolean داده های تولید شده توسط کاربر true اگر افزونه بتواند پیوست های جدیدی را به رویداد اضافه کند. false در غیر این صورت |
calendar.conferenceData | Conference data object داده های تولید شده توسط کاربر شیئی که هر داده کنفرانس مرتبط با این رویداد را نشان می دهد، مانند جزئیات کنفرانس Google Meet. |
calendar.id | string شناسه رویداد |
calendar.organizer | object شیئی که نماینده سازمان دهنده رویداد است. |
calendar.organizer.email | string آدرس ایمیل برگزارکننده رویداد. |
calendar.recurringEventId | string شناسه یک رویداد تکراری |
شرکت کننده
اشیاء شرکتکننده اطلاعات مربوط به شرکتکنندگان را به رویدادهای Google Calendar حمل میکنند. این اطلاعات در شی رویداد وجود دارد اگر و تنها در صورتی که دادهها در رویداد Calendar وجود داشته باشد و افزونه فیلد مانیفست addOns.calendar.currentEventAccess
را روی READ
یا READ_WRITE
تنظیم کند.
شرکت کننده شی | |
---|---|
attendee.additionalGuests | number تعداد مهمانهای دیگری که شرکتکننده نشان داده بود که میآورند. به طور پیش فرض به صفر می رسد. |
attendee.comment | string نظر پاسخ شرکت کننده، در صورت وجود. |
attendee.displayName | string شرکت کننده نام نمایش داده شد. |
attendee.email | string آدرس ایمیل شرکت کننده |
attendee.optional | boolean true اگر حضور برای این شرکت کننده به عنوان اختیاری علامت گذاری شود. false در غیر این صورت |
attendee.organizer | boolean true اگر شرکت کننده سازمان دهنده این رویداد باشد. |
attendee.resource | boolean true اگر شرکت کننده منبعی مانند اتاق یا قطعه ای از تجهیزات را نشان دهد. false در غیر این صورت |
attendee.responseStatus | string وضعیت پاسخ شرکت کنندگان مقادیر ممکن شامل موارد زیر است:
|
attendee.self | boolean true اگر این شرکت کننده تقویمی را که این رویداد در آن ظاهر می شود را نشان دهد. false در غیر این صورت |
داده های کنفرانس
اشیاء داده کنفرانس حاوی اطلاعات کنفرانس هایی هستند که به رویدادهای تقویم Google پیوست شده اند. اینها می توانند راه حل های کنفرانس Google، مانند Google Meet، یا کنفرانس های شخص ثالث باشند. این اطلاعات در شی رویداد وجود دارد اگر و تنها در صورتی که دادهها در رویداد Calendar وجود داشته باشد و افزونه فیلد مانیفست addOns.calendar.currentEventAccess
را روی READ
یا READ_WRITE
تنظیم کند.
شی داده کنفرانس | |
---|---|
conferenceData.conferenceId | string شناسه کنفرانس این شناسه به برنامهها اجازه میدهد تا کنفرانسها را پیگیری کنند. شما نباید این شناسه را به کاربران نمایش دهید. |
conferenceData.conferenceSolution | object شیئی که راه حل کنفرانس را نشان می دهد، مانند Hangouts یا Google Meet. |
conferenceData.conferenceSolution.iconUri | string URI برای نماد قابل مشاهده توسط کاربر که این راه حل کنفرانس را نشان می دهد. |
conferenceData.conferenceSolution.key | object کلیدی که به طور منحصر به فرد راه حل کنفرانس را برای این رویداد مشخص می کند. |
conferenceData.conferenceSolution.key.type | string نوع راه حل کنفرانس مقادیر ممکن شامل موارد زیر است:
|
conferenceData.conferenceSolution.name | string نام قابل مشاهده برای کاربر این راه حل کنفرانس (بومی سازی نشده). |
conferenceData.entryPoints[] | list of entry point objects فهرست نقاط ورودی کنفرانس، مانند URL ها یا شماره تلفن. |
conferenceData.notes | string یادداشتهای اضافی (مانند دستورالعملهای مدیر دامنه یا اعلامیههای قانونی) درباره کنفرانس برای نمایش به کاربر. می تواند حاوی HTML باشد. حداکثر طول 2048 کاراکتر است. |
conferenceData.parameters | object یک شی حاوی نقشه ای از داده های پارامتر تعریف شده برای استفاده توسط افزونه. |
conferenceData.parameters.addOnParameters | object نقشه ای از کلیدهای رشته پارامتر و مقادیر. این کلیدها و مقادیر توسط توسعه دهنده افزونه برای پیوست کردن اطلاعات به یک کنفرانس خاص برای استفاده افزونه تعریف شده است. |
نقطه ورود
اشیاء نقطه ورودی حاوی اطلاعاتی در مورد ابزارهای تعیین شده برای دسترسی به یک کنفرانس معین، مانند تلفن یا ویدیو هستند. این اطلاعات در شی رویداد وجود دارد اگر و تنها در صورتی که دادهها در رویداد Calendar وجود داشته باشد و افزونه فیلد مانیفست addOns.calendar.currentEventAccess
را روی READ
یا READ_WRITE
تنظیم کند.
شی نقطه ورودی | |
---|---|
entryPoint.accessCode | string کد دسترسی مورد استفاده برای دسترسی به کنفرانس. حداکثر طول 128 کاراکتر است. ارائه دهندگان کنفرانس معمولاً فقط از زیر مجموعه ای از { accessCode , meetingCode , passcode , password , pin } برای دسترسی به کنفرانس ها استفاده می کنند. فیلدهایی را که ارائه دهنده کنفرانس استفاده می کند مطابقت دهید و فقط نمایش دهید. |
entryPoint.entryPointFeatures | list ویژگی های نقطه ورود در حال حاضر این ویژگی ها فقط برای نقاط ورودی phone اعمال می شود:
|
entryPoint.entryPointType | string نوع نقطه ورود مقادیر ممکن به شرح زیر است:
|
entryPoint.label | string برچسب قابل مشاهده توسط کاربر برای URI نقطه ورودی (بومی سازی نشده). |
entryPoint.meetingCode | string کد جلسه مورد استفاده برای دسترسی به کنفرانس. حداکثر طول 128 کاراکتر است. ارائه دهندگان کنفرانس معمولاً فقط از زیر مجموعه ای از { accessCode , meetingCode , passcode , password , pin } برای دسترسی به کنفرانس ها استفاده می کنند. فیلدهایی را که ارائه دهنده کنفرانس استفاده می کند مطابقت دهید و فقط نمایش دهید. |
entryPoint.passcode | string رمز عبور استفاده شده برای دسترسی به کنفرانس. حداکثر طول 128 کاراکتر است. ارائه دهندگان کنفرانس معمولاً فقط از زیر مجموعه ای از { accessCode , meetingCode , passcode , password , pin } برای دسترسی به کنفرانس ها استفاده می کنند. فیلدهایی را که ارائه دهنده کنفرانس استفاده می کند مطابقت دهید و فقط نمایش دهید. |
entryPoint.password | string رمز عبور استفاده شده برای دسترسی به کنفرانس. حداکثر طول 128 کاراکتر است. ارائه دهندگان کنفرانس معمولاً فقط از زیر مجموعه ای از { accessCode , meetingCode , passcode , password , pin } برای دسترسی به کنفرانس ها استفاده می کنند. فیلدهایی را که ارائه دهنده کنفرانس استفاده می کند مطابقت دهید و فقط نمایش دهید. |
entryPoint.pin | string پین مورد استفاده برای دسترسی به کنفرانس. حداکثر طول 128 کاراکتر است. ارائه دهندگان کنفرانس معمولاً فقط از زیر مجموعه ای از { accessCode , meetingCode , passcode , password , pin } برای دسترسی به کنفرانس ها استفاده می کنند. فیلدهایی را که ارائه دهنده کنفرانس استفاده می کند مطابقت دهید و فقط نمایش دهید. |
entryPoint.regionCode | string کد منطقه شماره تلفن. اگر URI شامل کد کشور نباشد، برای کاربران مورد نیاز است. مقادیر بر اساس لیست عمومی CLDR کدهای منطقه است. |
entryPoint.uri | string URI نقطه ورود. حداکثر طول 1300 کاراکتر است. قالب بندی به نوع نقطه ورودی بستگی دارد:
|
درایو شی رویداد
شی رویداد Drive بخشی از شی رویداد کلی است که اطلاعات مربوط به Google Drive کاربر و محتویات آن را حمل می کند. فقط در صورتی در یک شی رویداد وجود دارد که برنامه میزبان Google Drive باشد.
درایو شی رویداد | |
---|---|
drive.activeCursorItem | Drive item object مورد Drive در حال حاضر فعال است. |
drive.selectedItems[] | list of Drive item objects فهرستی از موارد (فایل ها یا پوشه ها) انتخاب شده در Drive. |
مورد Drive
اشیاء مورد درایو اطلاعات مربوط به موارد خاص Drive، مانند فایلها یا پوشهها را حمل میکنند.
شی مورد درایو | |
---|---|
item.addonHasFileScopePermission | boolean اگر true ، افزونه مجوز دامنه https://www.googleapis.com/auth/drive.file را برای این مورد درخواست کرده و دریافت کرده است. در غیر این صورت این فیلد false است. |
item.id | string شناسه مورد انتخاب شده |
item.iconUrl | string URL نمادی که نشان دهنده مورد انتخاب شده است. |
item.mimeType | string نوع MIME مورد انتخاب شده. |
item.title | string عنوان مورد انتخاب شده |
شی رویداد Gmail
شی رویداد Gmail بخشی از شی رویداد کلی است که اطلاعات پیام های Gmail کاربر را حمل می کند. فقط در صورتی در یک شی رویداد وجود دارد که برنامه میزبان Gmail باشد.
شی رویداد Gmail | |
---|---|
gmail.accessToken | string نشانه دسترسی خاص Gmail. میتوانید از این نشانه با روش GmailApp.setCurrentMessageAccessToken(accessToken) برای اعطای دسترسی موقت به پیام Gmail کاربر که در حال حاضر باز است یا به افزونهتان اجازه دهید پیشنویسهای جدیدی بنویسد، استفاده کنید. |
gmail.bccRecipients[] | list of strings به طور پیش فرض غیرفعال است . فهرست آدرسهای ایمیل گیرنده "BCC:" که در حال حاضر در پیشنویسی که افزونه در حال نوشتن است، گنجانده شده است. برای روشن کردن این فیلد، باید فیلد addOns.gmail.composeTrigger.draftAccess را در مانیفست خود روی METADATA تنظیم کنید. |
gmail.ccRecipients[] | list of strings به طور پیش فرض غیرفعال است . فهرست آدرسهای ایمیل گیرنده "CC:" که در حال حاضر در پیشنویسی که افزونه در حال نوشتن است، گنجانده شده است. برای روشن کردن این فیلد، باید فیلد addOns.gmail.composeTrigger.draftAccess را در مانیفست خود روی METADATA تنظیم کنید. |
gmail.messageId | string شناسه پیام جیمیل که در حال حاضر باز است. |
gmail.threadId | string شناسه رشته Gmail که در حال حاضر باز است. |
gmail.toRecipients[] | list of strings به طور پیش فرض غیرفعال است . فهرست آدرسهای ایمیل گیرنده «به:» که در حال حاضر در پیشنویسی که افزونه در حال نوشتن است، گنجانده شده است. برای روشن کردن این فیلد، باید فیلد addOns.gmail.composeTrigger.draftAccess را در مانیفست خود روی METADATA تنظیم کنید. |
شی رویداد Docs
شی رویداد Docs بخشی از شی رویداد کلی است که اطلاعات مربوط به سند کاربر و محتوای آن را حمل می کند. تنها در صورتی در یک شی رویداد وجود دارد که برنامه میزبان Google Docs باشد.
شی رویداد Docs | |
---|---|
docs.id | string فقط در صورتی ارائه شود که دامنه https://www.googleapis.com/auth/drive.file توسط کاربر مجاز باشد .شناسه سند در رابط کاربری Docs باز می شود. |
docs.title | string فقط در صورتی ارائه شود که دامنه https://www.googleapis.com/auth/drive.file توسط کاربر مجاز باشد .عنوان سند در رابط کاربری Docs باز می شود. |
docs.addonHasFileScopePermission | boolean اگر true ، افزونه مجوز دامنه https://www.googleapis.com/auth/drive.file را برای سند باز شده در Docs UI درخواست کرده و دریافت کرده است. در غیر این صورت این فیلد false است. |
docs.matchedUrl.url | string فقط در صورت رعایت شرایط زیر ارائه می شود:
نشانی اینترنتی پیوندی که یک پیشنمایش در Google Docs ایجاد میکند. برای استفاده از این فیلد، باید LinkPreviewTriggers در مانیفست افزونه خود پیکربندی کنید. برای جزئیات بیشتر به پیوندهای پیش نمایش با تراشه های هوشمند مراجعه کنید. بار نمونه برای زمانی که کاربر پیوند را پیشنمایش میکند "docs" : { "matchedUrl" : { "url" : "https://www.example.com/12345" } } |
شی رویداد Sheets
شی رویداد Sheets بخشی از شی رویداد کلی است که اطلاعات مربوط به سند کاربر و محتوای آن را حمل می کند. تنها در صورتی در یک شی رویداد وجود دارد که برنامه میزبان Google Sheets باشد.
شی رویداد Sheets | |
---|---|
sheets.id | string فقط در صورتی ارائه شود که دامنه https://www.googleapis.com/auth/drive.file توسط کاربر مجاز باشد . شناسه صفحهگسترده در رابط کاربر کاربرگنگار باز میشود. |
sheets.title | string فقط در صورتی ارائه شود که دامنه https://www.googleapis.com/auth/drive.file توسط کاربر مجاز باشد . عنوان صفحهگسترده در رابط کاربر کاربرگنگار باز میشود. |
sheets.addonHasFileScopePermission | boolean اگر true ، افزونه مجوز دامنه https://www.googleapis.com/auth/drive.file را برای صفحه گسترده باز شده در کاربرگنگار درخواست کرده و دریافت کرده است. در غیر این صورت این فیلد false است. |
sheets.matchedUrl.url | string فقط در صورت رعایت شرایط زیر ارائه می شود:
نشانی وب پیوندی که یک پیشنمایش در کاربرگنگار Google ایجاد میکند. برای استفاده از این فیلد، باید LinkPreviewTriggers در مانیفست افزونه خود پیکربندی کنید. برای جزئیات بیشتر به پیوندهای پیش نمایش با تراشه های هوشمند مراجعه کنید. بار نمونه برای زمانی که کاربر پیوند را پیشنمایش میکند "sheets" : { "matchedUrl" : { "url" : "https://www.example.com/12345" } } |
شی رویداد اسلاید
شی رویداد Slides بخشی از شی رویداد کلی است که اطلاعات مربوط به سند کاربر و محتوای آن را حمل می کند. فقط در صورتی در یک شی رویداد وجود دارد که برنامه میزبان Google Slides باشد.
شی رویداد اسلاید | |
---|---|
slides.id | string فقط در صورتی ارائه شود که دامنه https://www.googleapis.com/auth/drive.file توسط کاربر مجاز باشد . شناسه ارائه در رابط کاربری اسلایدها باز می شود. |
slides.title | string فقط در صورتی ارائه شود که دامنه https://www.googleapis.com/auth/drive.file توسط کاربر مجاز باشد . عنوان ارائه در رابط کاربری اسلایدها باز می شود. |
slides.addonHasFileScopePermission | boolean در صورت true ، افزونه مجوز دامنه https://www.googleapis.com/auth/drive.file را برای ارائه باز در رابط کاربری اسلایدها درخواست کرده و دریافت کرده است. در غیر این صورت این فیلد false است. |
slides.matchedUrl.url | string فقط در صورت رعایت شرایط زیر ارائه می شود:
نشانی اینترنتی پیوندی که یک پیشنمایش در اسلایدهای Google ایجاد میکند. برای استفاده از این فیلد، باید LinkPreviewTriggers در مانیفست افزونه خود پیکربندی کنید. برای جزئیات بیشتر به پیوندهای پیش نمایش با تراشه های هوشمند مراجعه کنید. بار نمونه برای زمانی که کاربر پیوند را پیشنمایش میکند "slides" : { "matchedUrl" : { "url" : "https://www.example.com/12345" } } |