این سند رویدادهای Meet را که برنامه‌تان می‌تواند بااستفاده از Google Workspace Events API در آن‌ها مشترک شود شرح می‌دهد. پس‌از اینکه تصمیم گرفتید به چه نوع رویدادهایی نیاز دارید، اشتراکی ایجاد کنید تا دریافت رویدادها از Meet را شروع کنید.
علاوه‌بر مشترک شدن در رویدادها، می‌توانید با فراخوانی Google Meet REST API، رویدادها را جستجو کنید. برای بازیابی رویدادها به‌صورت دوره‌ای، یا برای اطلاع از رویدادهایی که ممکن است به‌دلیل قطعی از اشتراک ازدست داده باشید، با Meet REST API تماس بگیرید. برای آشنایی با روش‌های دریافت و پاسخ دادن به رویدادهای Meet، به پاسخ دادن به رویدادها از Google Meet در اسناد Meet مراجعه کنید.
برای کسب اطلاعات بیشتر درباره توسعه برنامه‌ها برای Meet، به نمای کلی Meet REST API مراجعه کنید.
رویدادهای Meet پشتیبانی‌شده
اشتراک‌های Google Workspace به شما امکان می‌دهد رویدادهای مربوط به انواع تغییرات زیر را در Meet دریافت کنید:
- کنفرانس در فضای جلسه شروع یا تمام می‌شود.
- شرکت‌کننده‌ای به کنفرانس می‌پیوندد یا آن را ترک می‌کند.
- ضبط شروع یا تمام می‌شود، یا فایلی برای کنفرانس تولید می‌شود.
- یادداشت هوشمند شروع یا تمام می‌شود، یا فایلی برای کنفرانس تولید می‌شود.
- ترانویسی شروع می‌شود، پایان می‌یابد، یا فایلی برای کنفرانس تولید می‌شود.
منابعی که می‌توانید برای رویدادها پایش کنید
برای دریافت رویدادها، منبع Meet را برای نظارت مشخص کنید که منبع هدف اشتراک نامیده می‌شود.
Google Workspace Events API از منابع هدف زیر برای Meet پشتیبانی می‌کند:
| منبع هدف | قالب | محدودیت‌ها (درصورت وجود) |
|---|---|---|
| فضای جلسه | //meet.googleapis.com/spaces/SPACE
که در آن SPACE شناسه در
نام منبع منبع Meet REST API |
|
| کاربر | //cloudidentity.googleapis.com/users/USER
که در آن USER شناسه در فیلد
|
اشتراک رویدادهای مربوط به همه فضاهای جلسه‌ای را که کاربر مالک آن فضای جلسه است دریافت می‌کند. معمولاً مالک فضای جلسه همان سازمان‌دهنده رویداد «تقویم Google» مرتبط با فضای جلسه است. |
انواع رویداد برای ایجاد اشتراک
وقتی اشتراکی برای منبع Meet ایجاد می‌کنید، از فیلد
eventTypes[]
برای مشخص کردن انواع رویدادهایی که می‌خواهید دریافت کنید استفاده کنید. انواع رویداد
مطابق با مشخصات CloudEvents قالب‌بندی می‌شوند،
مانند
google.workspace.APPLICATION.RESOURCE.VERSION.ACTION.
برای مثال، برای دریافت رویدادهای مربوط به شرکت‌کنندگان جدید در کنفرانس برای
فضای Meet، نوع رویداد را به‌عنوان
google.workspace.meet.participant.v2.joined مشخص کنید. برای کسب اطلاعات بیشتر درباره نحوه عملکرد رویدادها، به ساختار رویدادهای Google Workspace مراجعه کنید.
جدول زیر نشان می‌دهد که کدام نوع رویداد برای اشتراک در منابع Meet پشتیبانی می‌شود:
| نوع رویداد | قالب | داده‌های منبع |
|---|---|---|
| کنفرانسی در فضای جلسه شروع می‌شود. | google.workspace.meet.conference.v2.started |
conferenceRecord |
| کنفرانس در فضای جلسه به‌پایان می‌رسد. | google.workspace.meet.conference.v2.ended |
conferenceRecord |
| شرکت‌کننده‌ای به کنفرانس فعالی در فضای جلسه می‌پیوندد. | google.workspace.meet.participant.v2.joined |
conferenceRecord.participantSession |
| شرکت‌کننده‌ای کنفرانس فعالی را در فضای جلسه ترک می‌کند. | google.workspace.meet.participant.v2.left |
conferenceRecord.participantSession |
| ضبط برای کنفرانسی در فضای جلسه شروع می‌شود. | google.workspace.meet.recording.v2.started |
conferenceRecord.recording |
| ضبط کنفرانس در فضای جلسه به‌پایان می‌رسد. | google.workspace.meet.recording.v2.ended |
conferenceRecord.recording |
| فایل ضبط‌شده‌ای برای کنفرانس در فضای جلسه ایجاد می‌شود. | google.workspace.meet.recording.v2.fileGenerated |
conferenceRecord.recording |
| یادداشت هوشمند برای کنفرانس در فضای جلسه شروع می‌شود. | google.workspace.meet.smartNote.v2.started |
conferenceRecord.smartNote |
| یادداشت هوشمند برای کنفرانس در فضای جلسه به‌پایان می‌رسد. | google.workspace.meet.smartNote.v2.ended |
conferenceRecord.smartNote |
| فایل یادداشت هوشمندی برای کنفرانس در فضای جلسه ایجاد می‌شود. | google.workspace.meet.smartNote.v2.fileGenerated |
conferenceRecord.smartNote |
| ترانویسی برای کنفرانسی در فضای جلسه شروع می‌شود. | google.workspace.meet.transcript.v2.started |
conferenceRecord.transcript |
| ترانویسی برای کنفرانس در فضای جلسه به‌پایان می‌رسد. | google.workspace.meet.transcript.v2.ended |
conferenceRecord.transcript |
| فایل ترانویسی برای کنفرانس در فضای جلسه تولید می‌شود. | google.workspace.meet.transcript.v2.fileGenerated |
conferenceRecord.transcript |
داده‌های رویداد
این بخش داده‌های رویداد و نمونه محموله‌های رویدادها را در فضاهای جلسه Meet شرح می‌دهد.
وقتی اشتراک Google Workspace شما رویدادی را از Meet دریافت می‌کند، فیلد data حاوی بار مفید رویداد است. این بار داده حاوی اطلاعاتی درباره
منبع Google Workspace است که تغییر کرده است. برای مثال، اگر
در رویدادهای مربوط به ترانویسی‌های جدید در فضایی مشترک شده باشید، بار مفید این
رویدادها حاوی اطلاعاتی درباره منبع transcripts
تغییریافته است.
داده‌های منبع در بار داده رویداد
جدول زیر نمونه‌هایی از محموله‌های JSON را برای اشتراک در فضای جلسه Meet ارائه می‌دهد. نمونه‌ها از شناسه سابقه کنفرانس (برای مثال، conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) برای شناسایی فضای جلسه استفاده می‌کنند. برای اطلاعات بیشتر، به نحوه شناسایی فضای جلسه توسط Meet مراجعه کنید.
برای هر رویدادی که اشتراک دریافت می‌کند، بار داده در فیلد data
رویداد نشان داده می‌شود:
| انواع رویداد | پایه‌بار JSON |
|---|---|
کنفرانسی برای فضای جلسه Meet شروع یا تمام می‌شود.
|
داده‌های منبع را مستثنی می‌کند:
{
"conferenceRecord":
{
"name": "conferenceRecords/ |
شرکت‌کننده‌ای به کنفرانس در فضای جلسه Meet می‌پیوندد یا آن را ترک می‌کند.
|
داده‌های منبع را مستثنی می‌کند:
{
"participantSession":
{
"name": "conferenceRecords/ |
ضبط شروع می‌شود، پایان می‌یابد، یا فایلی برای کنفرانس در فضای جلسه Meet تولید می‌شود.
|
داده‌های منبع را مستثنی می‌کند:
{
"recording":
{
"name": "conferenceRecords/ |
یادداشت هوشمند شروع یا تمام می‌شود، یا فایلی برای کنفرانس در فضای جلسه Meet تولید می‌شود.
|
داده‌های منبع را مستثنی می‌کند:
{
"smartNote":
{
"name": "conferenceRecords/ |
ترانویسی شروع می‌شود، پایان می‌یابد، یا فایلی برای کنفرانس در فضای جلسه Meet تولید می‌شود.
|
داده‌های منبع را مستثنی می‌کند:
{
"transcript":
{
"name": "conferenceRecords/ |
محدودیت‌ها
- دعوت‌شدگان تقویم و دیگر شرکت‌کنندگان دعوت‌شده به کنفرانس فقط می‌توانند رویدادهای زیر را دریافت کنند:
google.workspace.meet.conference.v2.startedوgoogle.workspace.meet.transcript.v2.fileGenerated.