این سند نحوه دریافت و پاسخ به رویدادهای Google Meet از Google Cloud Pub/Sub را توضیح می‌دهد.
یک رویداد Meet نشان‌دهنده یک فعالیت یا تغییر در یک منبع Meet است، مانند ایجاد یک جلسه جدید. می‌توانید از رویدادها برای درک آنچه اتفاق افتاده و سپس انجام اقدام یا برای پاسخ دادن به کاربران خود به شیوه‌ای معنادار استفاده کنید.
در اینجا چند مثال از نحوه استفاده از رویدادها آورده شده است:
مشاهده و پاسخ به تغییرات در یک جلسه، مانند زمان شروع یا پایان جلسه.
پیگیری کنید که چه کسانی برای اهداف نظارتی یا آموزشی در جلسه شرکت کرده‌اند.
به متن جلسه گوش دهید تا محتوای فایل تجزیه و تحلیل شده و در CRM یا پایگاه داده ثبت شود.
نحوه عملکرد رویدادها
هر زمان که اتفاقی در Google Meet رخ می‌دهد، یک منبع API REST در Google Meet ایجاد یا به‌روزرسانی می‌شود. Meet از رویدادها برای ارائه اطلاعات به برنامه شما در مورد نوع فعالیت رخ داده و منبع API REST 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 در مستندات مرجع مراجعه کنید. |
محدودیت‌ها
- دعوت‌شدگان به تقویم و سایر شرکت‌کنندگان دعوت‌شده به کنفرانس فقط می‌توانند رویدادهای زیر را دریافت کنند:
google.workspace.meet.conference.v2.startedوgoogle.workspace.meet.transcript.v2.fileGenerated.
مباحث مرتبط
- مرور کلی API رویدادهای Google Workspace
- ایجاد اشتراک Google Workspace
- در رویدادهای گوگل میت مشترک شوید