پاسخ به رویدادها از Google Meet

This document explains how to receive and respond to Google Meet events from Google Cloud Pub/Sub.

یک رویداد Meet نشان‌دهنده یک فعالیت یا تغییر در یک منبع Meet است، مانند ایجاد یک جلسه جدید. می‌توانید از رویدادها برای درک آنچه اتفاق افتاده و سپس انجام اقدام یا برای پاسخ دادن به کاربران خود به شیوه‌ای معنادار استفاده کنید.

Here are some examples of how you can use events:

  • Observe and respond to changes in a meeting, such as when a meeting starts or ends.

  • Track who attended the meeting for regulatory or training purposes.

  • Listen for the meeting transcript so the file contents can be parsed and logged into a CRM or database.

نحوه عملکرد رویدادها

هر زمان که اتفاقی در Google Meet رخ می‌دهد، یک منبع API REST در Google Meet ایجاد یا به‌روزرسانی می‌شود. Meet از رویدادها برای ارائه اطلاعات به برنامه شما در مورد نوع فعالیت رخ داده و منبع API REST Meet که تحت تأثیر قرار گرفته است، استفاده می‌کند.

Example of how a new meeting space triggers an event.
Figure 1. A user creates a meeting space, which creates a Space resource. Meet then creates an event that contains data about the new meeting space.

Meet رویدادها را بر اساس نوع دسته‌بندی می‌کند. انواع رویدادها به شما کمک می‌کنند تا فقط نوع اطلاعات مورد نیاز خود را فیلتر و دریافت کنید و به شما امکان می‌دهد فعالیت‌های مشابه را به یک روش انجام دهید.

The following example shows how an activity in Meet affects a related Meet REST API resource, and the type of event that your Meet app receives:

فعالیت با منبع REST API آشنا شوید نوع رویداد
یک کاربر به فضای جلسه می‌پیوندد. یک منبع ConferenceRecord ایجاد می‌شود. رکورد جدید کنفرانس

دریافت داده‌های رویداد از گوگل میت

To receive event data, your app can do either of the following:

The following table explains the difference and reasons for subscribing to events versus querying for them:

اشتراک در رویدادها پرس و جو برای داده ها
موارد استفاده
  • رویدادها را در زمان واقعی پردازش یا پاسخ دهید.
  • برای بهبود عملکرد برنامه خود، تغییرات در منابع را زیر نظر بگیرید.
  • داده‌ها را به صورت دستی بازیابی کنید.
  • Fetch all data from Meet (due to an outage or inactive subscription).
رابط برنامه‌نویسی کاربردی رابط برنامه‌نویسی کاربردی رویدادهای فضای کاری گوگل (Google Workspace Events API) با REST API آشنا شوید
منبع رویدادها سوابق کنفرانس و کاربران سابقه فضایی و کنفرانس
رویدادهای پشتیبانی شده سابقه کنفرانس

For a list of supported event types, see Event types for creating subscriptions in the Google Workspace Events API documentation.		 سابقه فضایی و کنفرانس

For a list of supported endpoints, see the Space resource and the ConferenceRecord resource in the Meet REST API documentation.
قالب رویداد A Google Cloud Pub/Sub message, formatted according to the CloudEvent specification. For details, see Structure of Google Workspace events . یک منبع Meet REST API ( Space و ConferenceRecord )
داده‌های رویداد Base64-encoded string with or without resource data. For example payloads, see Event data . بار داده JSON که حاوی داده‌های منبع است. برای مثال، به منبع ConferenceRecord در مستندات مرجع مراجعه کنید.

Example: Retrieve events about participants in a meeting space

در این مثال، یک برنامه Meet می‌خواهد اطلاعاتی در مورد تغییرات شرکت‌کنندگان در یک فضای جلسه دریافت کند. در فضای جلسه، یک شرکت‌کننده به یک کنفرانس فعال می‌پیوندد که یک منبع ParticipantSession را پر می‌کند و یک رویداد جدید را آغاز می‌کند. سپس می‌توانید با استفاده از روش subscribe یا query اطلاعات مربوط به این رویدادها را دریافت کنید.

اشتراک در رویدادها

برای دریافت رویدادها به صورت بلادرنگ، برنامه Meet subscriptions.create از API رویدادهای فضای کاری گوگل را فراخوانی می‌کند تا برای انواع رویدادها در فضای جلسه مشترک شود. پس از ایجاد اشتراک، برنامه Meet می‌تواند شروع به دریافت رویدادها کند.

A Meet app that subscribes to participant events using the Google Workspace Events API.
شکل ۲. یک برنامه Meet رویدادهای شرکت‌کنندگان را از طریق اشتراک با استفاده از API رویدادهای Google Workspace دریافت می‌کند.

در شکل ۲، برنامه Meet اشتراک فعالی در فضای جلسه دارد، بنابراین هر زمان که جلسه یک شرکت‌کننده در فضای جلسه تغییر کند، برنامه یک رویداد دریافت می‌کند. سپس برنامه Meet می‌تواند به صورت بلادرنگ به هر یک از فعالیت‌ها پاسخ دهد، مانند اطلاع از زمان پیوستن یا ترک یک شرکت‌کننده در یک کنفرانس فعال.

To learn about creating subscriptions using the Google Workspace Events API, see the Google Workspace Events API documentation .

پرس و جو برای رویدادهای اخیر

Instead of receiving events as they occur, a Meet app can also call the Meet REST API to list recent meeting space events that are related to participant activity.

A Meet app that queries for participant events using the Meet REST API.
Figure 3. A Meet app receives recent participant events by querying for meeting space events using the 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 .