در رویدادهای 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 اشتراک ایجاد می‌کنید، از فیلد eventTypes[] برای مشخص کردن انواع رویدادهایی که می‌خواهید دریافت کنید استفاده می‌کنید. انواع رویدادها طبق مشخصات CloudEvents قالب‌بندی می‌شوند google.workspace. APPLICATION . RESOURCE . VERSION . ACTION

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

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

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

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

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

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

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

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

{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
      

{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
      

{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
      

{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}
      

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

مباحث مرتبط

• مرور کلی API رویدادهای Google Workspace
• ساختار رویدادهای Google Workspace
• انتخاب محدوده‌های API رویدادهای Google Workspace
• مرور کلی API REST گوگل میت
• انتخاب محدوده‌های API REST گوگل میت
• آموزش: مشاهده رویدادهای جلسات با پایتون و رابط برنامه‌نویسی کاربردی REST گوگل میت