اشیاء رویداد

این صفحه ساختار اشیاء رویداد افزونه‌های Google Workspace را نشان می‌دهد.

اشیاء رویداد ساختارهای JSON هستند که به‌طور خودکار ساخته می‌شوند و به‌عنوان پارامترهایی برای راه‌اندازی یا بازگشت به تماس در هنگام تعامل کاربر با یک افزونه ارسال می‌شوند. اشیاء رویداد اطلاعات سمت سرویس گیرنده را در مورد برنامه میزبان و زمینه فعلی به عملکرد پاسخ به تماس سمت سرور افزونه منتقل می کنند.

افزونه‌های Google Workspace از اشیاء رویداد در مکان‌های زیر استفاده می‌کنند:

  • محرک های صفحه اصلی هر تابع homepageTrigger که تعریف می‌کنید به‌طور خودکار به یک شی رویداد ارسال می‌شود که تابع ماشه صفحه اصلی فعال شود. می‌توانید از این شی در عملکرد راه‌اندازی صفحه اصلی خود برای شناسایی برنامه میزبان فعال، پلت فرم مشتری، منطقه کاربر و سایر اطلاعات استفاده کنید.

    اشیاء رویدادی که هنگام فعال کردن صفحه اصلی ایجاد می‌شوند، شامل تمام فیلدهای موجود در دو مورد دیگر نیستند. فیلدهای مربوط به ویجت ها و اطلاعات متنی حذف می شوند.

  • محرک های متنی هر برنامه میزبان مجموعه متفاوتی از محرک های متنی را ارائه می دهد که وقتی کاربر وارد یک زمینه خاص می شود، فعال می شود. به عنوان مثال:

    هنگامی که یک تریگر متنی فعال می شود، برنامه میزبان، runFunction مربوطه را که در مانیفست افزودنی فهرست شده است، فراخوانی می کند و آن را به عنوان یک شی رویداد به عنوان پارامتر ارسال می کند. اشیاء رویدادی که هنگام روشن شدن تریگرهای متنی ایجاد می‌شوند، شامل تمام فیلدهای موجود در اشیاء رویداد راه‌انداز صفحه اصلی، به‌علاوه فیلدهای حاوی اطلاعات متنی هستند.

  • اقدامات ویجت اشیاء رویداد همچنین برای ارائه تعامل ویجت ، با استفاده از همان مدل عملکردی که افزونه‌های Gmail استفاده می‌کنند، استفاده می‌شوند. افزونه‌های Google Workspace از همه عملکردهای کنترل‌کننده ویجت، اشیاء Action و پاسخ‌های کنش استفاده می‌کنند. با این حال، در افزونه‌های Google Workspace، اشیاء رویداد اقدام حاوی اطلاعات بیشتری هستند که یک تابع پاسخ به تماس می‌تواند روی آنها عمل کند.

    اشیاء رویداد ایجاد شده در نتیجه اقدامات ویجت شامل تمام فیلدهای موجود در اشیاء رویداد محرک متنی، به علاوه فیلدهای حاوی اطلاعات ویجت هستند.

  • پیش‌نمایش محرک‌های پیوند . در Google Docs، Sheets و Slides می‌توانید پیش‌نمایش پیوندها را برای سرویس‌های شخص ثالث بر اساس الگوهای URL خاص پیکربندی کنید. هنگامی که کاربران با پیوندی که با الگو مطابقت دارد تعامل می‌کنند، linkPreviewTriggers فعال می‌شود و یک شی رویداد که حاوی پیوند است به تابع پاسخ تماس ماشه ارسال می‌شود. افزونه شما می‌تواند از این شی رویداد برای ساخت یک تراشه و کارت هوشمند استفاده کند که اطلاعات پیوند را در برنامه میزبان نشان می‌دهد. همچنین می‌توانید اقدامات ویجت را بسازید تا به کاربران اجازه دهید با کارت پیش‌نمایش و محتویات آن تعامل داشته باشند.

  • راه‌اندازهای برنامه چت Google (پیش‌نمایش برنامه‌نویس) . در Google Chat، افزونه شما به عنوان یک برنامه چت برای کاربران ظاهر می‌شود و کاربران می‌توانند با افزودن آن به فضاها، ارسال پیام، استفاده از دستورات اسلش و غیره با آن تعامل داشته باشند. برای ایجاد ویژگی‌های تعاملی، راه‌اندازهای مختلف برنامه Chat را تنظیم و استفاده می‌کنید. هر تریگر یک بار بار شی رویداد متفاوت را ارسال می کند که به شما کمک می کند هر نوع تعامل را پردازش کنید یا به آن پاسخ دهید.

ساختار شی رویداد

جدول زیر ساختار سطح بالای اشیاء رویداد افزودنی Google Workspace را توضیح می دهد. ساختار شی رویداد شامل یک فیلد سطح بالای commonEventObject برای اطلاعات مستقل از میزبان است. هر شی رویداد همچنین می‌تواند یکی از فیلدهای سطح بالای مخصوص میزبان زیر را داشته باشد که توسط برنامه میزبان فعال تعیین می‌شود: gmailEventObject ، calendarEventObject ، یا driveEventObject .

برای سازگاری با گذشته، اشیاء رویداد افزودنی Google Workspace همچنین شامل تمام فیلدهای اصلی مورد استفاده در اشیاء رویداد اقدام افزودنی Gmail است. این فیلدها در جدول زیر در قسمت «فیلدهای افزودنی اصلی Gmail» فهرست شده‌اند. اطلاعات در این زمینه ها در ساختار شی جدید تولید می شود.

شی رویداد
eventObject.commonEventObject Common fields object
یک شی حاوی اطلاعات مشترک برای همه اشیاء رویداد، صرف نظر از برنامه میزبان.
eventObject.calendar Calendar event object
فقط در صورتی ارائه شود که میزبان تماس گیرنده Google Calendar باشد . یک شی حاوی اطلاعات تقویم و رویداد.
eventObject.chat Chat event object
فقط در صورتی ارائه شود که میزبان تماس Google Chat باشد . یک شی حاوی اطلاعات چت.
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.gmail.accessToken بیابید.

eventObject.messageMetadata.messageId string
منسوخ شده است. شناسه پیام موضوع در رابط کاربری Gmail باز می شود.

برای افزونه‌های Google Workspace، این اطلاعات را در قسمت eventObject.gmail.messageId بیابید.

eventObject.clientPlatform string
منسوخ شده است. نشان می دهد که رویداد از کجا شروع شده است (وب، iOS یا Android).

برای افزونه‌های Google Workspace، این اطلاعات را در قسمت eventObject.commonEventObject.platform بیابید.

eventObject.formInput object
منسوخ شده است. نقشه ای از مقادیر فعلی همه ویجت های فرم در کارت، محدود به یک مقدار در هر ویجت. کلیدها شناسه‌های رشته مرتبط با ویجت‌ها هستند و مقادیر رشته‌ها هستند. شی رویداد formInput برای زمانی که نیاز به خواندن داده‌ها از چندین ویجت با مقادیر تک مورد انتظار دارید، مانند ورودی‌های متن و سوئیچ‌ها، آسان می‌کند. برای ویجت‌های چند ارزشی مانند چک باکس‌ها، می‌توانید هر مقدار را از formInputs بخوانید.

برای افزونه‌های Google Workspace، به جای آن، این اطلاعات را در قسمت eventObject.commonEventObject.formInputs بیابید. ویجت ها با مقادیر واحد به صورت آرایه هایی با یک عنصر نمایش داده می شوند.

eventObject.formInputs object
منسوخ شده است. نقشه ای از مقادیر فعلی ویجت ها در کارت که به صورت لیست رشته ها ارائه می شود. کلیدها شناسه‌های رشته مرتبط با ویجت هستند. برای ویجت های تک ارزشی، مقدار در یک آرایه تک عنصری ارائه می شود. برای ویجت های چند ارزشی مانند گروه های چک باکس، همه مقادیر در یک لیست ارائه می شوند.

برای افزونه‌های Google Workspace، این اطلاعات را در قسمت eventObject.commonEventObject.formInputs بیابید.

eventObject.parameters object
منسوخ شده است. نقشه ای از هر پارامتر اضافی که با استفاده از Action.setParameters() به Action می دهید. کلیدها و مقادیر نقشه رشته هستند.

برای افزونه‌های Google Workspace، این اطلاعات را در قسمت eventObject.commonEventObject.parameters بیابید.

eventObject.userCountry string
به طور پیش فرض منسوخ و غیرفعال شده است . کد دو حرفی که کشور یا منطقه کاربر را نشان می دهد. همچنین می تواند یک کد کشوری UN M49 عددی باشد.

برای افزونه‌های Google Workspace، این اطلاعات را در قسمت eventObject.commonEventObject.userLocale بیابید.

eventObject.userLocale string
به طور پیش فرض منسوخ و غیرفعال شده است . کد ISO 639 دو حرفی که زبان کاربر را نشان می دهد. برای جزئیات بیشتر به دسترسی به منطقه کاربری و منطقه زمانی مراجعه کنید.

برای افزونه‌های Google Workspace، این اطلاعات را در قسمت eventObject.commonEventObject.userLocale بیابید.

eventObject.userTimezone.id string
به طور پیش فرض منسوخ و غیرفعال شده است . شناسه منطقه زمانی منطقه زمانی کاربر. مثال‌ها عبارتند از: America/New_York ، Europe/Vienna ، و Asia/Seoul . برای جزئیات بیشتر به دسترسی به منطقه کاربری و منطقه زمانی مراجعه کنید.

برای افزونه‌های Google Workspace، این اطلاعات را در قسمت eventObject.commonEventObject.timeZone.id بیابید.

eventObject.userTimezone.offset string
به طور پیش فرض منسوخ و غیرفعال شده است . تغییر زمان از زمان هماهنگ جهانی (UTC) منطقه زمانی کاربر، اندازه‌گیری شده در میلی‌ثانیه. برای جزئیات بیشتر به دسترسی به منطقه کاربری و منطقه زمانی مراجعه کنید.

برای افزونه‌های Google Workspace، این اطلاعات را در قسمت eventObject.commonEventObject.timeZone.offset بیابید.

شی رویداد مشترک

شی رویداد مشترک بخشی از شی رویداد کلی است که اطلاعات کلی و مستقل از میزبان را از مشتری کاربر به افزونه حمل می کند. این اطلاعات شامل جزئیاتی مانند منطقه محلی کاربر، برنامه میزبان و پلت فرم است.

علاوه بر صفحه اصلی و محرک‌های متنی، افزونه‌ها هنگام تعامل کاربر با ویجت‌ها، اشیاء رویداد را می‌سازند و به عملکردهای پاسخ به تماس منتقل می‌کنند. تابع تماس برافزای شما می‌تواند شی رویداد مشترک را برای تعیین محتوای ویجت‌های باز در کلاینت کاربر جستجو کند. به عنوان مثال، افزونه شما می تواند متنی را که کاربر در ویجت TextInput وارد کرده است در شی eventObject.commentEventObject.formInputs بیابد.

فیلدهای شی رویداد رایج
commonEventObject.platform string
نشان می‌دهد که رویداد از کجا شروع می‌شود («WEB»، «IOS» یا «ANDROID»).
commonEventObject.formInputs object
نقشه ای حاوی مقادیر فعلی ویجت ها در کارت نمایش داده شده. کلیدهای نقشه، شناسه‌های رشته‌ای هستند که به هر ویجت اختصاص داده می‌شوند.

ساختار شی ارزش نقشه به نوع ویجت بستگی دارد:

  • ویجت های تک ارزشی (به عنوان مثال، یک جعبه متن): لیستی از رشته ها (فقط یک عنصر).

    مثال : برای ویجت ورودی متن با شناسه‌ی employeeName ، به مقدار ورودی متن با: e.commonEventObject.formInputs.employeeName.stringInputs.value[0] دسترسی پیدا کنید.

  • ویجت های چند ارزشی (به عنوان مثال، گروه های چک باکس): لیستی از رشته ها.

    مثال : برای یک ویجت چند ارزشی با participants به‌عنوان شناسه، به آرایه مقادیر با: e.commonEventObject.formInputs.participants.stringInputs.value دسترسی پیدا کنید.

  • A date-time picker : یک DateTimeInput object .

    مثال : برای انتخابگر با شناسه myDTPicker ، با استفاده از e.commonEventObject.formInputs.myDTPicker.dateTimeInput به شیء DateTimeInput دسترسی پیدا کنید.

  • A date-only picker : یک DateInput object .

    مثال : برای انتخابگر با شناسه myDatePicker ، با استفاده از e.commonEventObject.formInputs.myDatePicker.dateInput به شیء DateInput دسترسی پیدا کنید.

  • A time-only picker : یک TimeInput object .

    مثال : برای انتخابگر با شناسه myTimePicker ، با استفاده از e.commonEventObject.formInputs.myTimePicker.timeInput به شی TimeInput دسترسی پیدا کنید.

commonEventObject.hostApp string
نشان‌دهنده برنامه میزبانی است که افزونه در هنگام ایجاد شی رویداد در آن فعال است. مقادیر ممکن شامل موارد زیر است:
  • GMAIL
  • CALENDAR
  • DRIVE
  • DOCS
  • SHEETS
  • SLIDES
commonEventObject.parameters object
هر پارامتر اضافی که با استفاده از actionParameters یا Action.setParameters() به یک اقدام ارائه می کنید.

پیش‌نمایش برنامه‌نویس: برای افزونه‌هایی که گپ Google را گسترش می‌دهند ، برای پیشنهاد موارد بر اساس آنچه کاربران در منوهای چند انتخابی تایپ می‌کنند، از مقدار کلید "autocomplete_widget_query" ( event.commonEventObject.parameters["autocomplete_widget_query"] ] استفاده کنید. شما می توانید از این مقدار برای پرس و جو از یک پایگاه داده استفاده کنید و موارد قابل انتخاب را هنگام تایپ به کاربران پیشنهاد دهید. برای جزئیات، به جمع آوری و پردازش اطلاعات از کاربران گپ Google مراجعه کنید.

commonEventObject.userLocale string
به طور پیش فرض غیرفعال است . زبان کاربر و شناسه کشور/منطقه در قالب کد زبان ISO 639- کد کشور/منطقه ISO 3166 . به عنوان مثال، en-US .

برای روشن کردن این فیلد، باید addOns.common.useLocaleFromApp روی true در مانیفست افزونه خود تنظیم کنید. فهرست دامنه افزونه شما باید شامل https://www.googleapis.com/auth/script.locale نیز باشد. برای جزئیات بیشتر به دسترسی به منطقه کاربری و منطقه زمانی مراجعه کنید.

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 دریافت کنند. این شامل مقادیر تاریخ یا زمان انتخابی کاربر در ویجت‌های انتخابگر تاریخ یا زمان است. با این حال، ساختار اطلاعات بسته به اینکه ویجت به عنوان یک انتخابگر تاریخ، یک انتخاب کننده فقط تاریخ، یا یک انتخاب کننده فقط زمان پیکربندی شده باشد، متفاوت است. تفاوت های ساختاری در جدول زیر شرح داده شده است:

شیء DateTimeInput
dateTimeInput.hasDate boolean
true اگر زمان تاریخ ورودی شامل یک تاریخ باشد. اگر false فقط یک زمان گنجانده شده است.
dateTimeInput.hasTime boolean
true اگر زمان تاریخ ورودی شامل یک زمان باشد. اگر false فقط یک تاریخ گنجانده شده است.
dateTimeInput.msSinceEpoch string
زمان انتخاب شده توسط کاربر، بر حسب میلی ثانیه از زمان (00:00:00 UTC در 1 ژانویه 1970).
شیء DateInput
dateInput.msSinceEpoch string
زمان انتخاب شده توسط کاربر، بر حسب میلی ثانیه از زمان (00:00:00 UTC در 1 ژانویه 1970).
شیء TimeInput
timeInput.hours number
تعداد ساعت انتخاب شده توسط کاربر.
timeInput.minutes number
تعداد دقیقه انتخاب شده توسط کاربر.

شی رویداد تقویم

شی رویداد 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
وضعیت پاسخ شرکت کنندگان مقادیر ممکن شامل موارد زیر است:
  • accepted : شرکت کننده دعوت رویداد را پذیرفته است.
  • declined : شرکت کننده دعوت رویداد را رد کرده است.
  • needsAction : شرکت کننده به دعوت رویداد پاسخ نداده است.
  • tentative : شرکت کننده به طور آزمایشی دعوت رویداد را پذیرفته است.
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
نوع راه حل کنفرانس مقادیر ممکن شامل موارد زیر است:
  • eventHangout برای Hangouts برای مشتریان (http://hangouts.google.com).
  • eventNamedHangout برای Hangouts کلاسیک برای کاربران Google Workspace (http://hangouts.google.com).
  • hangoutsMeet برای Google Meet (http://meet.google.com).
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 اعمال می شود:
  • toll : نقطه ورودی یک تماس تلفنی است.
  • toll_free : نقطه ورودی یک تماس تلفنی رایگان است.
entryPoint.entryPointType string
نوع نقطه ورود مقادیر ممکن به شرح زیر است:
  • more : دستورالعمل های اضافی برای پیوستن به کنفرانس، مانند شماره تلفن های جایگزین. یک کنفرانس فقط می تواند یک نقطه ورودی more داشته باشد. در صورت وجود حداقل یک نوع دیگر از نقطه ورودی نیز مورد نیاز است.
  • phone : از طریق شماره تلفن به کنفرانس بپیوندید. یک کنفرانس می تواند صفر یا چند نقطه ورودی phone داشته باشد. Google Calendar تنها دو نقطه ورودی تلفن اول را پس از قالب بندی و مرتب سازی بر اساس حروف الفبا نمایش می دهد.
  • sip : به کنفرانس از طریق SIP بپیوندید. یک کنفرانس می تواند حداکثر یک sip نقطه ورود داشته باشد.
  • video : به کنفرانس از طریق HTTP بپیوندید. یک کنفرانس حداکثر می تواند یک نقطه ورود video داشته باشد.
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 کاراکتر است. قالب بندی به نوع نقطه ورودی بستگی دارد:
  • more : یک طرح http: یا https: لازم است.
  • phone : tel: طرح مورد نیاز است. URI باید شامل کل دنباله شماره گیری باشد (به عنوان مثال، "tel:+12345678900,,,12345678;1234").
  • sip : یک sip: یا sips: طرحواره مورد نیاز است. به عنوان مثال "sip:12345678@myprovider.com".
  • video : یک طرح http: یا https: لازم است.

درایو شی رویداد

شی رویداد 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
فقط در صورت رعایت شرایط زیر ارائه می شود:
  • https://www.googleapis.com/auth/workspace.linkpreview توسط کاربر مجاز شده است.
  • URL با الگوی میزبان مشخص شده در راه‌انداز LinkPreviewTriggers مطابقت دارد.

نشانی اینترنتی پیوندی که یک پیش‌نمایش در Google Docs ایجاد می‌کند. برای استفاده از این فیلد، باید LinkPreviewTriggers را در مانیفست افزونه خود پیکربندی کنید. برای جزئیات بیشتر به پیوندهای پیش نمایش با تراشه های هوشمند مراجعه کنید.

بار نمونه برای زمانی که کاربر پیوند را پیش‌نمایش می‌کند https://www.example.com/12345 : 

"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
فقط در صورت رعایت شرایط زیر ارائه می شود:
  • https://www.googleapis.com/auth/workspace.linkpreview توسط کاربر مجاز شده است.
  • URL با الگوی میزبان مشخص شده در راه‌انداز LinkPreviewTriggers مطابقت دارد.

نشانی وب پیوندی که یک پیش‌نمایش در کاربرگ‌نگار Google ایجاد می‌کند. برای استفاده از این فیلد، باید LinkPreviewTriggers را در مانیفست افزونه خود پیکربندی کنید. برای جزئیات بیشتر به پیوندهای پیش نمایش با تراشه های هوشمند مراجعه کنید.

بار نمونه برای زمانی که کاربر پیوند را پیش‌نمایش می‌کند https://www.example.com/12345 : 

"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
فقط در صورت رعایت شرایط زیر ارائه می شود:
  • https://www.googleapis.com/auth/workspace.linkpreview توسط کاربر مجاز شده است.
  • URL با الگوی میزبان مشخص شده در راه‌انداز LinkPreviewTriggers مطابقت دارد.

نشانی اینترنتی پیوندی که یک پیش‌نمایش در اسلایدهای Google ایجاد می‌کند. برای استفاده از این فیلد، باید LinkPreviewTriggers را در مانیفست افزونه خود پیکربندی کنید. برای جزئیات بیشتر به پیوندهای پیش نمایش با تراشه های هوشمند مراجعه کنید.

بار نمونه برای زمانی که کاربر پیوند را پیش‌نمایش می‌کند https://www.example.com/12345 :

"slides" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}
،

این صفحه ساختار اشیاء رویداد افزونه‌های Google Workspace را نشان می‌دهد.

اشیاء رویداد ساختارهای JSON هستند که به‌طور خودکار ساخته می‌شوند و به‌عنوان پارامترهایی برای راه‌اندازی یا بازگشت به تماس در هنگام تعامل کاربر با یک افزونه ارسال می‌شوند. اشیاء رویداد اطلاعات سمت سرویس گیرنده را در مورد برنامه میزبان و زمینه فعلی به عملکرد پاسخ به تماس سمت سرور افزونه منتقل می کنند.

افزونه‌های Google Workspace از اشیاء رویداد در مکان‌های زیر استفاده می‌کنند:

  • محرک های صفحه اصلی هر تابع homepageTrigger که تعریف می‌کنید به‌طور خودکار به یک شی رویداد ارسال می‌شود که تابع ماشه صفحه اصلی فعال شود. می‌توانید از این شی در عملکرد راه‌اندازی صفحه اصلی خود برای شناسایی برنامه میزبان فعال، پلت فرم مشتری، منطقه کاربر و سایر اطلاعات استفاده کنید.

    اشیاء رویدادی که هنگام فعال کردن صفحه اصلی ایجاد می‌شوند، شامل تمام فیلدهای موجود در دو مورد دیگر نیستند. فیلدهای مربوط به ویجت ها و اطلاعات متنی حذف می شوند.

  • محرک های متنی هر برنامه میزبان مجموعه متفاوتی از محرک های متنی را ارائه می دهد که وقتی کاربر وارد یک زمینه خاص می شود، فعال می شود. به عنوان مثال:

    هنگامی که یک تریگر متنی فعال می شود، برنامه میزبان، runFunction مربوطه را که در مانیفست افزودنی فهرست شده است، فراخوانی می کند و آن را به عنوان یک شی رویداد به عنوان پارامتر ارسال می کند. اشیاء رویدادی که هنگام روشن شدن تریگرهای متنی ایجاد می‌شوند، شامل تمام فیلدهای موجود در اشیاء رویداد راه‌انداز صفحه اصلی، به‌علاوه فیلدهای حاوی اطلاعات متنی هستند.

  • اقدامات ویجت اشیاء رویداد همچنین برای ارائه تعامل ویجت ، با استفاده از همان مدل عملکردی که افزونه‌های Gmail استفاده می‌کنند، استفاده می‌شوند. افزونه‌های Google Workspace از همه عملکردهای کنترل‌کننده ویجت، اشیاء Action و پاسخ‌های کنش استفاده می‌کنند. با این حال، در افزونه‌های Google Workspace، اشیاء رویداد اقدام حاوی اطلاعات بیشتری هستند که یک تابع پاسخ به تماس می‌تواند روی آنها عمل کند.

    اشیاء رویداد ایجاد شده در نتیجه اقدامات ویجت شامل تمام فیلدهای موجود در اشیاء رویداد محرک متنی، به علاوه فیلدهای حاوی اطلاعات ویجت هستند.

  • پیش‌نمایش محرک‌های پیوند . در Google Docs، Sheets و Slides می‌توانید پیش‌نمایش پیوندها را برای سرویس‌های شخص ثالث بر اساس الگوهای URL خاص پیکربندی کنید. هنگامی که کاربران با پیوندی که با الگو مطابقت دارد تعامل می‌کنند، linkPreviewTriggers فعال می‌شود و یک شی رویداد که حاوی پیوند است به تابع پاسخ تماس ماشه ارسال می‌شود. افزونه شما می‌تواند از این شی رویداد برای ساخت یک تراشه و کارت هوشمند استفاده کند که اطلاعات پیوند را در برنامه میزبان نشان می‌دهد. همچنین می‌توانید اقدامات ویجت را بسازید تا به کاربران اجازه دهید با کارت پیش‌نمایش و محتویات آن تعامل داشته باشند.

  • راه‌اندازهای برنامه چت Google (پیش‌نمایش برنامه‌نویس) . در Google Chat، افزونه شما به عنوان یک برنامه چت برای کاربران ظاهر می‌شود و کاربران می‌توانند با افزودن آن به فضاها، ارسال پیام، استفاده از دستورات اسلش و غیره با آن تعامل داشته باشند. برای ایجاد ویژگی‌های تعاملی، راه‌اندازهای مختلف برنامه Chat را تنظیم و استفاده می‌کنید. هر تریگر یک بار بار شی رویداد متفاوت را ارسال می کند که به شما کمک می کند هر نوع تعامل را پردازش کنید یا به آن پاسخ دهید.

ساختار شی رویداد

جدول زیر ساختار سطح بالای اشیاء رویداد افزودنی Google Workspace را توضیح می دهد. ساختار شی رویداد شامل یک فیلد سطح بالای commonEventObject برای اطلاعات مستقل از میزبان است. هر شی رویداد همچنین می‌تواند یکی از فیلدهای سطح بالای مخصوص میزبان زیر را داشته باشد که توسط برنامه میزبان فعال تعیین می‌شود: gmailEventObject ، calendarEventObject ، یا driveEventObject .

برای سازگاری با گذشته، اشیاء رویداد افزودنی Google Workspace همچنین شامل تمام فیلدهای اصلی مورد استفاده در اشیاء رویداد اقدام افزودنی Gmail است. این فیلدها در جدول زیر در قسمت «فیلدهای افزودنی اصلی Gmail» فهرست شده‌اند. اطلاعات در این زمینه ها در ساختار شی جدید تولید می شود.

شی رویداد
eventObject.commonEventObject Common fields object
یک شیء حاوی اطلاعات مشترک برای همه اشیاء رویداد ، صرف نظر از برنامه میزبان.
eventObject.calendar Calendar event object
فقط در صورتی که میزبان فراخوان تقویم Google باشد . یک شی حاوی تقویم و اطلاعات رویداد.
eventObject.chat Chat event object
فقط در صورتی که میزبان تماس Google CHAT باشد وجود دارد . یک شیء حاوی اطلاعات گپ.
eventObject.drive Drive event object
فقط در صورتی که میزبان تماس Google Drive باشد ، حضور دارد . یک شی حاوی اطلاعات درایو.
eventObject.gmail Gmail event object
فقط در صورتی که میزبان فراخوانی Gmail باشد . یک شیء حاوی اطلاعات Gmail.
eventObject.docs Docs event object
فقط در صورتی که میزبان فراخوان Google Docs باشد . یک شیء حاوی اطلاعات اسناد.
eventObject.sheets Sheets event object
فقط در صورتی که میزبان فراخوان Google Sheets باشد . یک شیء حاوی اطلاعات برگه.
eventObject.slides Slides event object
فقط در صورتی که میزبان فراخوان Google Slides باشد . یک شی حاوی اطلاعات اسلایدها.
زمینه های افزودنی اصلی Gmail
eventObject.messageMetadata.accessToken string
منسوخ شده است. یک نشانه دسترسی می توانید از این کار برای روشن کردن دسترسی به داده های کاربر با استفاده از دامنه های افزودنی موقت Gmail استفاده کنید.

برای افزودنیهای فضای کاری Google ، این اطلاعات را در قسمت eventObject.gmail.accessToken پیدا کنید.

eventObject.messageMetadata.messageId string
منسوخ شده است. شناسه پیام موضوع در UI Gmail باز است.

برای افزودنیهای فضای کاری Google ، این اطلاعات را در قسمت eventObject.gmail.messageId پیدا کنید.

eventObject.clientPlatform string
منسوخ شده است. نشان می دهد که این رویداد از کجا سرچشمه می گیرد (وب ، iOS یا Android).

برای افزودنیهای فضای کاری Google ، این اطلاعات را در قسمت eventObject.commonEventObject.platform پیدا کنید.

eventObject.formInput object
منسوخ شده است. نقشه ای از مقادیر فعلی همه ابزارک های فرم در کارت ، محدود به یک مقدار در هر ویجت. کلیدها شناسه های رشته مرتبط با ابزارک ها هستند و مقادیر رشته ها هستند. شیء رویداد formInput به عنوان راحتی برای زمانی که شما نیاز به خواندن داده ها از چندین ابزارک با مقادیر مفرد مورد انتظار مانند ورودی های متن و سوئیچ ها دارید ، فراهم می کند. برای ابزارک های چند ارزشی مانند جعبه های چک ، می توانید به جای آن ، هر مقدار را از formInputs بخوانید.

برای افزودنیهای فضای کاری Google ، این اطلاعات را در قسمت eventObject.commonEventObject.formInputs به جای آن پیدا کنید. ویجت ها با مقادیر منفرد به عنوان آرایه هایی با یک عنصر واحد نشان داده می شوند.

eventObject.formInputs object
منسوخ شده است. نقشه ای از مقادیر فعلی ابزارک ها در کارت ، که به عنوان لیست رشته ها ارائه شده است. کلیدها شناسه های رشته مرتبط با ویجت هستند. برای ابزارک های تک ارزش ، مقدار در یک آرایه تک عنصر ارائه می شود. برای ابزارک های چند ارزشی مانند گروه های کادر ، تمام مقادیر در یک لیست ارائه می شوند.

برای افزودنیهای فضای کاری Google ، این اطلاعات را در قسمت eventObject.commonEventObject.formInputs پیدا کنید.

eventObject.parameters object
منسوخ شده است. نقشه ای از پارامترهای اضافی که با استفاده از Action.setParameters() به Action ارائه می دهید. کلیدها و مقادیر نقشه رشته ها هستند.

برای افزودنیهای فضای کاری Google ، این اطلاعات را در قسمت eventObject.commonEventObject.parameters پیدا کنید.

eventObject.userCountry string
به طور پیش فرض مستهلک و غیرفعال شده است . کد دو حرفی که نشان دهنده کشور یا منطقه کاربر است. همچنین می تواند یک کد کشور عددی UN M49 باشد.

برای افزودنیهای فضای کاری Google ، این اطلاعات را در قسمت eventObject.commonEventObject.userLocale پیدا کنید.

eventObject.userLocale string
به طور پیش فرض مستهلک و غیرفعال شده است . کد ISO 639 دو حرف که نشان دهنده زبان کاربر است. برای اطلاعات بیشتر به دسترسی به محلی و منطقه زمانی کاربر مراجعه کنید.

برای افزودنیهای فضای کاری Google ، این اطلاعات را در قسمت eventObject.commonEventObject.userLocale پیدا کنید.

eventObject.userTimezone.id string
به طور پیش فرض مستهلک و غیرفعال شده است . شناسه منطقه زمانی منطقه زمانی کاربر. مثالها عبارتند از: America/New_York ، Europe/Vienna ، و Asia/Seoul . برای اطلاعات بیشتر به دسترسی به محلی و منطقه زمانی کاربر مراجعه کنید.

برای افزودنیهای فضای کاری Google ، این اطلاعات را در قسمت eventObject.commonEventObject.timeZone.id پیدا کنید.

eventObject.userTimezone.offset string
به طور پیش فرض مستهلک و غیرفعال شده است . جبران زمان از زمان جهانی هماهنگ (UTC) منطقه زمانی کاربر ، که در میلی ثانیه اندازه گیری می شود. برای اطلاعات بیشتر به دسترسی به محلی و منطقه زمانی کاربر مراجعه کنید.

برای افزودنیهای فضای کاری Google ، این اطلاعات را در قسمت eventObject.commonEventObject.timeZone.offset پیدا کنید.

شیء رویداد مشترک

شیء رویداد مشترک بخشی از شیء کلی رویداد است که اطلاعات عمومی و مستقل از میزبان را به افزودنی از مشتری کاربر منتقل می کند. این اطلاعات شامل جزئیاتی مانند محل کاربر ، برنامه میزبان و سیستم عامل کاربر است.

علاوه بر صفحه اصلی و محرک های متنی ، افزودنیها در هنگام تعامل کاربر با ویجت ها ، اشیاء رویداد را به توابع پاسخ به عمل می پردازند. عملکرد پاسخ به تماس افزودنی شما می تواند از شیء رویداد مشترک برای تعیین محتوای ویجت های باز در مشتری کاربر پرس و جو کند. به عنوان مثال ، افزودنی شما می تواند متنی را که یک کاربر در یک شیء TextInput وارد کرده است eventObject.commentEventObject.formInputs پیدا کند.

زمینه های شیء مشترک
commonEventObject.platform string
نشان می دهد که این رویداد از کجا سرچشمه می گیرد ("وب" ، `iOS` یا` Android`).
commonEventObject.formInputs object
نقشه حاوی مقادیر فعلی ابزارک ها در کارت نمایش داده شده. کلیدهای نقشه شناسه های رشته ای هستند که با هر ویجت اختصاص داده شده اند.

ساختار شیء مقدار MAP به نوع ویجت بستگی دارد:

  • ویجت های تک با ارزش (به عنوان مثال ، یک جعبه متن): لیستی از رشته ها (فقط یک عنصر).

    مثال : برای ویجت ورودی متن با employeeName به عنوان شناسه آن ، به مقدار ورودی متن با: e.commonEventObject.formInputs.employeeName.stringInputs.value[0] دسترسی پیدا کنید.

  • ابزارک های چند ارزشی (به عنوان مثال ، گروه های کادر): لیستی از رشته ها.

    مثال : برای یک ویجت چند ارزش با participants به عنوان شناسه آن ، به آرایه ارزش با: e.commonEventObject.formInputs.participants.stringInputs.value دسترسی پیدا کنید.

  • A date-time picker : یک DateTimeInput object .

    مثال : برای یک انتخاب کننده با شناسه myDTPicker ، با استفاده از e.commonEventObject.formInputs.myDTPicker.dateTimeInput به شیء DateTimeInput دسترسی پیدا کنید.

  • A date-only picker : یک DateInput object .

    مثال : برای یک انتخاب کننده با شناسه myDatePicker ، با استفاده از e.commonEventObject.formInputs.myDatePicker.dateInput به شیء DateInput دسترسی پیدا کنید.

  • A time-only picker : یک TimeInput object .

    مثال : برای یک انتخاب کننده با شناسه myTimePicker ، با استفاده از e.commonEventObject.formInputs.myTimePicker.timeInput به شیء TimeInput دسترسی پیدا کنید.

commonEventObject.hostApp string
برنامه میزبان را نشان می دهد که هنگام تولید شیء رویداد ، افزودنی فعال است. مقادیر احتمالی شامل موارد زیر است:
  • GMAIL
  • CALENDAR
  • DRIVE
  • DOCS
  • SHEETS
  • SLIDES
commonEventObject.parameters object
پارامترهای اضافی که شما با استفاده از actionParameters یا Action.setParameters() به یک عمل ارائه می دهید.

پیش نمایش توسعه دهنده: برای افزودنی هایی که Google Chat را گسترش می دهند ، برای پیشنهاد مواردی بر اساس آنچه کاربران در منوهای چند انتخابی تایپ می کنند ، از مقدار کلید "autocomplete_widget_query" استفاده کنید ( event.commonEventObject.parameters["autocomplete_widget_query"] ). می توانید از این مقدار برای پرس و جو یک پایگاه داده استفاده کنید و موارد قابل انتخاب را به عنوان تایپ به کاربران پیشنهاد دهید. برای جزئیات بیشتر ، به جمع آوری و پردازش اطلاعات از کاربران Google Chat مراجعه کنید.

commonEventObject.userLocale string
به طور پیش فرض غیرفعال است . شناسه زبان کاربر و کشور/منطقه در قالب کد زبانی ISO 639- ISO 3166 کد کشور/منطقه. به عنوان مثال، en-US .

برای روشن کردن این قسمت ، باید addOns.common.useLocaleFromApp در true افزودنی خود تنظیم کنید. لیست دامنه افزودنی شما همچنین باید شامل https://www.googleapis.com/auth/script.locale باشد. برای اطلاعات بیشتر به دسترسی به محلی و منطقه زمانی کاربر مراجعه کنید.

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 دریافت کنند. این شامل مقادیر یا مقادیر زمان انتخاب شده کاربر در ویجت های انتخاب شده تاریخ یا زمان است. با این حال ، ساختار اطلاعات بسته به اینکه آیا ویجت به عنوان انتخاب کننده تاریخ ، یک انتخاب کننده فقط تاریخ یا یک انتخاب کننده فقط زمان پیکربندی شده است ، متفاوت است. تفاوت های ساختاری در جدول زیر شرح داده شده است:

شیء DateTimeInput
dateTimeInput.hasDate boolean
true اگر زمان تاریخ ورودی شامل یک تاریخ باشد. اگر فقط یک زمان false باشد.
dateTimeInput.hasTime boolean
true اگر زمان تاریخ ورودی شامل یک زمان باشد. اگر فقط یک تاریخ false باشد.
dateTimeInput.msSinceEpoch string
زمان انتخاب شده توسط کاربر ، در میلی ثانیه از زمان Epoch (00:00:00 UTC در تاریخ 1 ژانویه 1970).
شیء DateInput
dateInput.msSinceEpoch string
زمان انتخاب شده توسط کاربر ، در میلی ثانیه از زمان Epoch (00:00:00 UTC در تاریخ 1 ژانویه 1970).
شیء زمانی
timeInput.hours number
شماره ساعت انتخاب شده توسط کاربر.
timeInput.minutes number
شماره دقیقه انتخاب شده توسط کاربر.

شیء رویداد تقویم

شیء رویداد تقویم بخشی از شیء کلی رویداد است که اطلاعات مربوط به وقایع تقویم و تقویم کاربر را حمل می کند. اگر برنامه میزبان تقویم Google باشد ، فقط در یک شیء رویداد وجود دارد.

در جدول زیر زمینه های موجود در قسمت calendarEventObject یک شیء رویداد ذکر شده است. زمینه هایی که به عنوان داده های تولید شده توسط کاربر مشخص شده اند در شیء رویداد وجود دارند اگر و فقط اگر داده ها در رویداد تقویم وجود داشته باشد و افزودنی 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 Convention Convention.
calendar.id string
شناسه رویداد
calendar.organizer object
یک شیء نماینده سازمان دهنده این رویداد.
calendar.organizer.email string
آدرس ایمیل سازمان دهنده رویداد.
calendar.recurringEventId string
شناسه یک رویداد مکرر.

شرکت کننده

اشیاء شرکت کننده اطلاعات مربوط به شرکت کنندگان در مورد رویدادهای تقویم Google را حمل می کنند. این اطلاعات در شیء رویداد وجود دارد اگر و فقط اگر داده ها در رویداد تقویم وجود داشته باشد و افزودنی آن را 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
وضعیت پاسخ شرکت کننده مقادیر احتمالی شامل موارد زیر است:
  • accepted : شرکت کننده دعوت رویداد را پذیرفته است.
  • declined : شرکت کننده دعوت رویداد را رد کرده است.
  • needsAction : شرکت کننده به دعوت رویداد پاسخ نداده است.
  • tentative : شرکت کننده به طور آزمایشی دعوت رویداد را پذیرفته است.
attendee.self boolean
true اگر این شرکت کننده تقویم این رویداد را نشان دهد. false در غیر این صورت

داده های کنفرانس

اشیاء داده های کنفرانس اطلاعات مربوط به کنفرانس هایی را که به رویدادهای تقویم Google پیوست شده اند ، حمل می کنند. اینها می توانند راه حل های کنفرانس Google ، مانند Google Meet یا کنفرانس های شخص ثالث باشند. این اطلاعات در شیء رویداد وجود دارد اگر و فقط اگر داده ها در رویداد تقویم وجود داشته باشد و افزودنی آن را 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
نوع راه حل کنفرانس. مقادیر احتمالی شامل موارد زیر است:
  • eventHangout برای پاتوق برای مصرف کنندگان (http://hangouts.google.com).
  • eventNamedHangout برای پاتوق های کلاسیک برای کاربران فضای کاری Google (http://hangouts.google.com).
  • hangoutsMeet برای ملاقات Google (http://meet.google.com).
conferenceData.conferenceSolution.name string
نام قابل مشاهده کاربر این راه حل کنفرانس (بومی سازی نشده).
conferenceData.entryPoints[] list of entry point objects
لیست نقاط ورود کنفرانس ، مانند URL یا شماره تلفن.
conferenceData.notes string
یادداشت های اضافی (مانند دستورالعمل های مدیر دامنه یا اعلامیه های حقوقی) در مورد کنفرانس برای نمایش به کاربر. می تواند حاوی HTML باشد. حداکثر طول 2048 کاراکتر است.
conferenceData.parameters object
یک شیء حاوی نقشه از داده های پارامتر تعریف شده برای استفاده توسط افزودنی.
conferenceData.parameters.addOnParameters object
نقشه کلیدها و مقادیر رشته پارامتر. این کلیدها و مقادیر توسط توسعه دهنده افزودنی تعریف شده اند تا اطلاعات را به یک کنفرانس خاص برای استفاده از افزودنی وصل کنید.

نقطه ورود

اشیاء نقطه ورود اطلاعاتی در مورد وسایل تعیین شده برای دسترسی به یک کنفرانس معین ، مانند تلفن یا فیلم دارند. این اطلاعات در شیء رویداد وجود دارد اگر و فقط اگر داده ها در رویداد تقویم وجود داشته باشد و افزودنی آن را addOns.calendar.currentEventAccess برای READ یا READ_WRITE تنظیم می کند.

نقطه ورودی
entryPoint.accessCode string
کد دسترسی برای دسترسی به کنفرانس استفاده می شود. حداکثر طول 128 نویسه است. ارائه دهندگان کنفرانس به طور معمول فقط از زیر مجموعه های accessCode ، meetingCode ، passcode ، password ، pin } برای دسترسی به کنفرانس ها استفاده می کنند. مطابقت داشته باشید و فقط زمینه هایی را که ارائه دهنده کنفرانس از آن استفاده می کند ، نمایش دهید.
entryPoint.entryPointFeatures list
ویژگی های نقطه ورود. در حال حاضر این ویژگی ها فقط در مورد نقاط ورود phone اعمال می شود:
  • toll : نقطه ورود یک تماس تلفنی است.
  • toll_free : نقطه ورود یک تماس تلفنی بدون تلفن است.
entryPoint.entryPointType string
نوع نقطه ورود. مقادیر احتمالی موارد زیر است:
  • more : دستورالعمل های پیوستن به کنفرانس اضافی ، مانند شماره تلفن های جایگزین. یک کنفرانس فقط می تواند یک نقطه ورود more داشته باشد. در صورت وجود حداقل یک نوع دیگر از نقطه ورود نیز لازم است.
  • phone : از طریق شماره تلفن به کنفرانس بپیوندید. یک کنفرانس می تواند نقاط ورود phone صفر یا بیشتر داشته باشد. Google Calendar فقط دو نقطه ورود تلفن اول را پس از قالب بندی و مرتب سازی با الفبایی نشان می دهد.
  • sip : به کنفرانس از طریق SIP بپیوندید. یک کنفرانس حداکثر می تواند یک نقطه ورود sip داشته باشد.
  • video : به کنفرانس از طریق HTTP بپیوندید. یک کنفرانس حداکثر می تواند یک نقطه ورود video داشته باشد.
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 نویسه است. قالب بندی به نوع نقطه ورود بستگی دارد:
  • more : a http: یا https: طرحواره مورد نیاز است.
  • phone : یک tel: طرحواره مورد نیاز است. URI باید کل دنباله شماره گیری را شامل شود (به عنوان مثال ، "تلفن: +12345678900 ، ، ، 12345678 ؛ 1234").
  • sip : A sip: یا sips: طرحواره مورد نیاز است. به عنوان مثال "SIP: 12345678@myprovider.com".
  • video : a http: یا https: طرحواره مورد نیاز است.

شیء رویداد رانندگی

شیء رویداد Drive بخشی از شیء کلی رویداد است که اطلاعات مربوط به Google Drive کاربر و محتوای آن را حمل می کند. اگر برنامه میزبان Google Drive باشد ، فقط در یک شیء رویداد وجود دارد.

شیء رویداد رانندگی
drive.activeCursorItem Drive item object
مورد درایو در حال حاضر فعال است.
drive.selectedItems[] list of Drive item objects
لیستی از موارد (پرونده ها یا پوشه ها) که در درایو انتخاب شده اند.

مورد محرک

اشیاء درایو اطلاعات مربوط به موارد درایو خاص مانند پرونده ها یا پوشه ها را حمل می کنند.

شیء مورد
item.addonHasFileScopePermission boolean
اگر true ، افزودنی درخواست کرده و https://www.googleapis.com/auth/drive.file مجوز دامنه برای این مورد را دریافت و دریافت کرده است. در غیر این صورت این زمینه false است.
item.id string
شناسه مورد انتخاب شده.
item.iconUrl string
URL نماد که نشان دهنده مورد انتخاب شده است.
item.mimeType string
نوع تقلید مورد انتخاب شده.
item.title string
عنوان مورد انتخاب شده.

شیء رویداد Gmail

شیء رویداد Gmail بخشی از شیء کلی رویداد است که اطلاعات مربوط به پیام های Gmail کاربر را حمل می کند. اگر برنامه میزبان Gmail باشد ، فقط در یک شیء رویداد وجود دارد.

شیء رویداد Gmail
gmail.accessToken string
نشانه دسترسی خاص Gmail. شما می توانید از این Token با روش 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 در حال حاضر باز.
gmail.threadId string
شناسه موضوع Gmail در حال حاضر باز است.
gmail.toRecipients[] list of strings
به طور پیش فرض غیرفعال است . لیست آدرس های ایمیل گیرنده "به:" که در حال حاضر در پیش نویس افزودنی گنجانده شده است ، در حال تهیه است. برای روشن کردن این قسمت ، باید قسمت addOns.gmail.composeTrigger.draftAccess را در مانیفست خود به METADATA تنظیم کنید.

Docs Event Object

شیء رویداد Docs بخشی از شیء کلی رویداد است که اطلاعات مربوط به سند کاربر و محتوای آن را حمل می کند. اگر برنامه میزبان Google Docs باشد ، فقط در یک موضوع رویداد وجود دارد.

Docs Event Object
docs.id string
فقط در صورتی که https://www.googleapis.com/auth/drive.file توسط کاربر مجاز باشد ، موجود است .
شناسه سند در UI Docs باز است.
docs.title string
فقط در صورتی که https://www.googleapis.com/auth/drive.file توسط کاربر مجاز باشد ، موجود است .
عنوان سند در UI Docs باز است.
docs.addonHasFileScopePermission boolean
اگر true ، افزودنی درخواست کرده و https://www.googleapis.com/auth/drive.file مجوز دامنه برای سند باز در Docs UI را درخواست کرده و دریافت کرده است. در غیر این صورت این زمینه false است.
docs.matchedUrl.url string
فقط اگر شرایط زیر برآورده شود:
  • https://www.googleapis.com/auth/workspace.linkpreview توسط کاربر مجاز است.
  • URL با الگوی میزبان مشخص شده در ماشه LinkPreviewTriggers مطابقت دارد.

URL پیوندی که پیش نمایش در Google Docs ایجاد می کند. برای استفاده از این قسمت ، باید LinkPreviewTriggers در مانیفست افزودنی خود پیکربندی کنید. برای اطلاعات بیشتر به پیوندهای پیش نمایش با تراشه های هوشمند مراجعه کنید.

نمونه بار مثال برای زمانی که کاربر از پیوند https://www.example.com/12345 پیش بینی می کند: 

"docs" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}

برگه رویداد

شیء رویداد Sheets بخشی از شیء کلی رویداد است که اطلاعات مربوط به سند کاربر و محتوای آن را حمل می کند. اگر برنامه میزبان برگه های Google باشد ، فقط در یک شیء رویداد وجود دارد.

برگه رویداد
sheets.id string
فقط در صورتی که https://www.googleapis.com/auth/drive.file توسط کاربر مجاز باشد ، موجود است . شناسه صفحه گسترده در UI ورق ها باز است.
sheets.title string
فقط در صورتی که https://www.googleapis.com/auth/drive.file توسط کاربر مجاز باشد ، موجود است . عنوان صفحه گسترده در UI برگه باز است.
sheets.addonHasFileScopePermission boolean
اگر true ، افزودنی درخواست کرده و https://www.googleapis.com/auth/drive.file مجوز دامنه برای صفحه گسترده باز در برگه های UI را درخواست کرده و دریافت کرده است. در غیر این صورت این زمینه false است.
sheets.matchedUrl.url string
فقط اگر شرایط زیر برآورده شود:
  • https://www.googleapis.com/auth/workspace.linkpreview توسط کاربر مجاز است.
  • URL با الگوی میزبان مشخص شده در ماشه LinkPreviewTriggers مطابقت دارد.

URL پیوندی که پیش نمایش در برگه های Google ایجاد می کند. برای استفاده از این قسمت ، باید LinkPreviewTriggers در مانیفست افزودنی خود پیکربندی کنید. برای اطلاعات بیشتر به پیوندهای پیش نمایش با تراشه های هوشمند مراجعه کنید.

نمونه بار مثال برای زمانی که کاربر از پیوند https://www.example.com/12345 پیش بینی می کند: 

"sheets" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}

Slides Event Object

شیء رویداد Slides بخشی از شیء کلی رویداد است که اطلاعات مربوط به سند کاربر و محتوای آن را حمل می کند. اگر برنامه میزبان Google Slides باشد ، فقط در یک شیء رویداد وجود دارد.

Slides Event Object
slides.id string
فقط در صورتی که https://www.googleapis.com/auth/drive.file توسط کاربر مجاز باشد ، موجود است . شناسه ارائه در UI اسلایدها باز است.
slides.title string
فقط در صورتی که https://www.googleapis.com/auth/drive.file توسط کاربر مجاز باشد ، موجود است . عنوان ارائه در UI اسلایدها باز است.
slides.addonHasFileScopePermission boolean
در صورت true ، افزودنی درخواست کرده و https://www.googleapis.com/auth/drive.file مجوز دامنه برای ارائه در اسلایدها را باز کرده و دریافت کرده است. در غیر این صورت این زمینه false است.
slides.matchedUrl.url string
فقط اگر شرایط زیر برآورده شود:
  • https://www.googleapis.com/auth/workspace.linkpreview توسط کاربر مجاز است.
  • URL با الگوی میزبان مشخص شده در ماشه LinkPreviewTriggers مطابقت دارد.

URL پیوندی که پیش نمایش در Google Slides ایجاد می کند. برای استفاده از این قسمت ، باید LinkPreviewTriggers در مانیفست افزودنی خود پیکربندی کنید. برای اطلاعات بیشتر به پیوندهای پیش نمایش با تراشه های هوشمند مراجعه کنید.

نمونه بار مثال برای زمانی که کاربر از پیوند https://www.example.com/12345 پیش بینی می کند:

"slides" : {
  "matchedUrl" : {
      "url" : "https://www.example.com/12345"
  }
}