در رویدادهای Google Meet مشترک شوید

این سند رویدادهای Google Meet را شرح می‌دهد که برنامه شما می‌تواند با استفاده از API رویدادهای Google Workspace در آنها مشترک شود. پس از اینکه تصمیم گرفتید به چه نوع رویدادهایی نیاز دارید، برای شروع دریافت رویدادها از Meet، یک اشتراک ایجاد کنید .

علاوه بر اشتراک در رویدادها، می‌توانید با فراخوانی Google Meet REST API، رویدادها را جستجو کنید. Meet REST API را فراخوانی کنید تا رویدادها را به صورت دوره‌ای بازیابی کنید، یا رویدادهایی را که ممکن است به دلیل قطعی از اشتراک از دست داده باشید، دریافت کنید. برای کسب اطلاعات در مورد روش‌های دریافت و پاسخ به رویدادهای Meet، به بخش «پاسخ به رویدادها از Google Meet» در مستندات Meet مراجعه کنید.

برای کسب اطلاعات بیشتر در مورد توسعه برنامه‌ها برای Meet، به نمای کلی Google Meet REST API مراجعه کنید.

رویدادهای پشتیبانی‌شده‌ی Meet

اشتراک‌های Google Workspace به شما امکان می‌دهند رویدادهای مربوط به انواع تغییرات زیر را در Meet دریافت کنید:

  • یک کنفرانس در یک فضای جلسات شروع یا پایان می‌یابد.
  • یک شرکت‌کننده به کنفرانس می‌پیوندد یا آن را ترک می‌کند.
  • برای یک کنفرانس، ضبطی انجام می‌شود.
  • برای یک کنفرانس، رونوشت تهیه می‌شود.

منابعی که می‌توانید برای رویدادها رصد کنید

برای دریافت رویدادها، یک منبع Meet را برای نظارت مشخص می‌کنید که منبع هدف اشتراک نامیده می‌شود.

رابط برنامه‌نویسی کاربردی رویدادهای Google Workspace از منابع هدف زیر برای Meet پشتیبانی می‌کند:

منبع هدف قالب محدودیت‌ها (در صورت وجود)
فضای جلسات //meet.googleapis.com/spaces/ SPACE

که در آن SPACE شناسه در نام منبع مربوط به منبع spaces Meet REST API است. برای جزئیات بیشتر، به نحوه شناسایی فضای جلسه توسط Meet مراجعه کنید.

کاربر //cloudidentity.googleapis.com/users/ USER

که در آن USER شناسه موجود در فیلد signedinUser.user از منبع participants Meet REST API است. برای جزئیات بیشتر، به Work with participants مراجعه کنید.

این اشتراک، رویدادهای مربوط به تمام فضاهای جلسه‌ای که کاربر مالک آن فضا است را دریافت می‌کند. معمولاً، مالک فضای جلسه، برگزارکننده رویداد تقویم گوگل مرتبط با آن فضای جلسه نیز هست.

انواع رویداد برای ایجاد اشتراک‌ها

وقتی در یک منبع Meet اشتراک ایجاد می‌کنید، از فیلد eventTypes[] برای مشخص کردن انواع رویدادهایی که می‌خواهید دریافت کنید استفاده می‌کنید. انواع رویدادها طبق مشخصات CloudEvents قالب‌بندی می‌شوند google.workspace. APPLICATION . RESOURCE . VERSION . ACTION

برای مثال، برای دریافت رویدادهای مربوط به شرکت‌کنندگان جدید در یک کنفرانس برای یک فضای Meet، نوع رویداد را google.workspace.meet.participant.v2.joined مشخص می‌کنید. برای کسب اطلاعات بیشتر در مورد نحوه عملکرد رویدادها، به ساختار رویدادهای Google Workspace مراجعه کنید.

جدول زیر انواع رویدادهایی را که برای اشتراک در منابع Meet پشتیبانی می‌شوند، نشان می‌دهد:

نوع رویداد قالب داده‌های منابع
کنفرانسی در فضای جلسات آغاز می‌شود. google.meet.conference.v2.started conferenceRecord
یک کنفرانس در فضای جلسات به پایان می‌رسد. google.meet.conference.v2.ended conferenceRecord
یک شرکت‌کننده به یک کنفرانس فعال در فضای جلسه می‌پیوندد. google.meet.participant.v2.joined conferenceRecord.participantSession
یک شرکت‌کننده، کنفرانس فعال در فضای جلسه را ترک می‌کند. google.meet.participant.v2.left conferenceRecord.participantSession
یک فایل ضبط برای کنفرانس در فضای جلسه ایجاد می‌شود. google.meet.recording.v2.fileGenerated conferenceRecord.recording
یک فایل رونوشت برای یک کنفرانس در فضای جلسه ایجاد می‌شود. google.meet.transcript.v2.fileGenerated conferenceRecord.transcript

داده‌های رویداد

این بخش داده‌های رویداد و نمونه‌هایی از داده‌های مفید برای رویدادها در فضاهای جلسه Meet را شرح می‌دهد.

وقتی اشتراک Google Workspace شما رویدادی را از Meet دریافت می‌کند، فیلد data شامل محتوای آن رویداد می‌شود. این محتوای داده حاوی اطلاعاتی درباره منبع Google Workspace است که تغییر کرده است. برای مثال، اگر در رویدادهای مربوط به رونوشت‌های جدید در یک فضا مشترک شده باشید، محتوای داده برای این رویدادها حاوی اطلاعاتی درباره منبع transcripts است که تغییر کرده‌اند.

داده‌های منبع در بار داده رویداد

جدول زیر نمونه‌هایی از داده‌های JSON برای اشتراک در فضای جلسه Meet را ارائه می‌دهد. این نمونه‌ها از شناسه رکورد کنفرانس (برای مثال، conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ ) برای شناسایی فضای جلسه استفاده می‌کنند. برای اطلاعات بیشتر، به نحوه شناسایی یک فضای جلسه توسط Meet مراجعه کنید.

برای هر رویدادی که اشتراک دریافت می‌کند، محتوای آن رویداد در فیلد data ظاهر می‌شود:

مثال نوع رویداد بار داده JSON

کنفرانسی برای فضای جلسات Meet آغاز می‌شود.

google.workspace.meet.conference.v2.started

داده‌های منابع را شامل نمی‌شود 
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
یک شرکت‌کننده به کنفرانسی در فضای جلسه Meet می‌پیوندد.

google.workspace.meet.participant.v2.joined

داده‌های منابع را شامل نمی‌شود 
{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
برای کنفرانسی در فضای جلسه Meet، ضبطی انجام می‌شود. google.workspace.meet.recording.v2.fileGenerated
داده‌های منابع را شامل نمی‌شود 
{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
برای کنفرانسی در فضای جلسه Meet، متن رونوشت تهیه می‌شود. google.workspace.meet.transcript.v2.fileGenerated
داده‌های منابع را شامل نمی‌شود 
{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}

محدودیت‌ها

  • دعوت‌شدگان به تقویم و سایر شرکت‌کنندگان دعوت‌شده به کنفرانس فقط می‌توانند رویدادهای زیر را دریافت کنند: google.workspace.meet.conference.v2.started و google.workspace.meet.transcript.v2.fileGenerated .