این سند نحوه دریافت و پاسخ به رویدادهای Google Meet از Google Cloud Pub/Sub را توضیح می‌دهد.
یک رویداد Meet نشان‌دهنده یک فعالیت یا تغییر در یک منبع Meet است، مانند ایجاد یک جلسه جدید. می‌توانید از رویدادها برای درک آنچه اتفاق افتاده و سپس انجام اقدام یا برای پاسخ دادن به کاربران خود به شیوه‌ای معنادار استفاده کنید.
در اینجا چند مثال از نحوه استفاده از رویدادها آورده شده است:
مشاهده و پاسخ به تغییرات در یک جلسه، مانند زمان شروع یا پایان جلسه.
پیگیری کنید که چه کسانی برای اهداف نظارتی یا آموزشی در جلسه شرکت کرده‌اند.
به متن جلسه گوش دهید تا محتوای فایل تجزیه و تحلیل شده و در CRM یا پایگاه داده ثبت شود.
نحوه عملکرد رویدادها
هر زمان که اتفاقی در Google Meet رخ می‌دهد، یک منبع API REST در Google Meet ایجاد یا به‌روزرسانی می‌شود. Meet از رویدادها برای ارائه اطلاعات به برنامه شما در مورد نوع فعالیت رخ داده و منبع API REST Meet که تحت تأثیر قرار گرفته است، استفاده می‌کند.
Space ایجاد می‌کند. سپس Meet رویدادی ایجاد می‌کند که حاوی داده‌هایی درباره فضای جلسه جدید است.Meet رویدادها را بر اساس نوع دسته‌بندی می‌کند. انواع رویدادها به شما کمک می‌کنند تا فقط نوع اطلاعات مورد نیاز خود را فیلتر و دریافت کنید و به شما امکان می‌دهد فعالیت‌های مشابه را به یک روش انجام دهید.
مثال زیر نشان می‌دهد که چگونه یک فعالیت در Meet بر یک منبع Meet REST API مرتبط و نوع رویدادی که برنامه Meet شما دریافت می‌کند، تأثیر می‌گذارد:
| فعالیت | با منبع REST API آشنا شوید | نوع رویداد |
|---|---|---|
| یک کاربر به فضای جلسه می‌پیوندد. | یک منبع ConferenceRecord ایجاد می‌شود. | رکورد جدید کنفرانس |
دریافت داده‌های رویداد از گوگل میت
برای دریافت داده‌های رویداد، برنامه شما می‌تواند یکی از موارد زیر را انجام دهد:
با استفاده از رابط برنامه‌نویسی کاربردی رویدادهای فضای کاری گوگل (Google Workspace Events API) در رویدادها مشترک شوید تا رویدادها را به محض وقوع دریافت کنید. برای اطلاعات بیشتر، به «مشترک شدن در رویدادهای Google Meet» مراجعه کنید.
با فراخوانی Meet REST API، داده‌های اخیر را جستجو کنید.
جدول زیر تفاوت و دلایل اشتراک در رویدادها در مقابل پرس و جو برای آنها را توضیح می‌دهد:
| اشتراک در رویدادها | پرس و جو برای داده ها | |
|---|---|---|
| موارد استفاده |
|
|
| رابط برنامه‌نویسی کاربردی | رابط برنامه‌نویسی کاربردی رویدادهای فضای کاری گوگل (Google Workspace Events API) | با REST API آشنا شوید |
| منبع رویدادها | سوابق کنفرانس و کاربران | سابقه فضایی و کنفرانس |
| رویدادهای پشتیبانی شده | سابقه کنفرانس برای مشاهده فهرستی از انواع رویدادهای پشتیبانی‌شده، به بخش انواع رویدادها برای ایجاد اشتراک‌ها در مستندات Google Workspace Events API مراجعه کنید. | سابقه فضایی و کنفرانس برای مشاهده‌ی فهرستی از نقاط پایانی پشتیبانی‌شده، به منبع Space و منبع ConferenceRecord در مستندات Meet REST API مراجعه کنید. |
| قالب رویداد | یک پیام Google Cloud Pub/Sub، که طبق مشخصات CloudEvent قالب‌بندی شده است. برای جزئیات بیشتر، به ساختار رویدادهای Google Workspace مراجعه کنید. | یک منبع Meet REST API ( Space و ConferenceRecord ) |
| داده‌های رویداد | رشته کدگذاری شده با Base64 با یا بدون داده‌های منبع. برای مثال، payloadها، به Event data مراجعه کنید. | بار داده JSON که حاوی داده‌های منبع است. برای مثال، به منبع ConferenceRecord در مستندات مرجع مراجعه کنید. |
مثال: بازیابی رویدادهای مربوط به شرکت‌کنندگان در یک فضای جلسه
در این مثال، یک برنامه Meet می‌خواهد اطلاعاتی در مورد تغییرات شرکت‌کنندگان در یک فضای جلسه دریافت کند. در فضای جلسه، یک شرکت‌کننده به یک کنفرانس فعال می‌پیوندد که یک منبع ParticipantSession را پر می‌کند و یک رویداد جدید را آغاز می‌کند. سپس می‌توانید با استفاده از روش subscribe یا query اطلاعات مربوط به این رویدادها را دریافت کنید.
اشتراک در رویدادها
برای دریافت رویدادها به صورت بلادرنگ، برنامه Meet subscriptions.create از API رویدادهای فضای کاری گوگل را فراخوانی می‌کند تا برای انواع رویدادها در فضای جلسه مشترک شود. پس از ایجاد اشتراک، برنامه Meet می‌تواند شروع به دریافت رویدادها کند.
در شکل ۲، برنامه Meet اشتراک فعالی در فضای جلسه دارد، بنابراین هر زمان که جلسه یک شرکت‌کننده در فضای جلسه تغییر کند، برنامه یک رویداد دریافت می‌کند. سپس برنامه Meet می‌تواند به صورت بلادرنگ به هر یک از فعالیت‌ها پاسخ دهد، مانند اطلاع از زمان پیوستن یا ترک یک شرکت‌کننده در یک کنفرانس فعال.
برای کسب اطلاعات بیشتر در مورد ایجاد اشتراک با استفاده از Google Workspace Events API، به مستندات Google Workspace Events API مراجعه کنید.
پرس و جو برای رویدادهای اخیر
به جای دریافت رویدادها در هنگام وقوع، یک برنامه Meet می‌تواند Meet REST API را نیز فراخوانی کند تا رویدادهای اخیر فضای جلسه که مربوط به فعالیت شرکت‌کنندگان است را فهرست کند.
در شکل 3، یک برنامه Meet پس از وقوع تمام فعالیت‌های جلسه شرکت‌کنندگان، متد Meet REST API conferenceRecords.participants.participantSessions.list را فراخوانی می‌کند. Meet REST API لیستی از منابع ParticipantSession را برمی‌گرداند که نشان‌دهنده هر یک از تغییرات است. سپس برنامه Meet می‌تواند بر اساس فعالیت اخیر، مانند ایجاد لیستی از شرکت‌کنندگانی که به کنفرانس پیوسته و آن را ترک کرده‌اند، پردازش یا پاسخ دهد.
برای جستجوی رویدادها با استفاده از Meet REST API، به فهرست کردن همه جلسات شرکت‌کنندگان مراجعه کنید.
محدودیت‌ها
- دعوت‌شدگان به تقویم و سایر شرکت‌کنندگان دعوت‌شده به کنفرانس فقط می‌توانند رویدادهای زیر را دریافت کنند:
google.workspace.meet.conference.v2.startedوgoogle.workspace.meet.transcript.v2.fileGenerated.
مباحث مرتبط
- مرور کلی API رویدادهای Google Workspace
- ایجاد اشتراک Google Workspace
- در رویدادهای گوگل میت مشترک شوید