این صفحه رویدادهای Google Meet را توصیف می‌کند که برنامه شما می‌تواند با استفاده از Google Workspace Events API در آنها مشترک شود. بعد از اینکه تصمیم گرفتید به چه نوع رویدادهایی نیاز دارید، برای شروع دریافت رویدادها از Google Meet اشتراکی ایجاد کنید .
برای کسب اطلاعات بیشتر درباره توسعه برنامه‌ها برای Google Meet، به نمای کلی Google Meet REST API مراجعه کنید.
رویدادهای Meet پشتیبانی می شود
اشتراک‌های Google Workspace به شما امکان می‌دهند رویدادهایی را درباره انواع تغییرات زیر در Meet دریافت کنید:
- یک کنفرانس در یک فضای جلسه شروع یا به پایان می رسد.
- یک شرکت کننده به یک کنفرانس می پیوندد یا از آن خارج می شود.
- ضبط برای یک کنفرانس تولید می شود.
- یک متن برای یک کنفرانس تولید می شود.
منابعی که می توانید برای رویدادها نظارت کنید
برای دریافت رویدادها، یک منبع Meet را برای نظارت تعیین می کنید که به آن منبع هدف اشتراک می گویند.
Google Workspace Events API از منابع هدف زیر برای Meet پشتیبانی می‌کند:
| منبع هدف | قالب | محدودیت ها (در صورت وجود) |
|---|---|---|
| فضای جلسه | //meet.googleapis.com/spaces/ SPACE که در آن SPACE شناسه در نام منبع منبع | |
| کاربر | //cloudidentity.googleapis.com/users/ USER که در آن USER شناسه در قسمت | اشتراک رویدادهایی را درباره فضاهای جلسه دریافت می کند که کاربر یکی از موارد زیر است:
|
انواع رویداد برای ایجاد اشتراک
وقتی اشتراکی برای منبع 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 دارد که تغییر کرده است. برای مثال، اگر در رویدادهایی در مورد رونوشت‌های جدید در یک فضا مشترک شده‌اید، بارگذاری این رویدادها حاوی اطلاعاتی درباره منبع transcript تغییر یافته است.
داده های منبع در بارگذاری رویداد
جدول زیر نمونه‌هایی از بارهای JSON برای اشتراک در فضای جلسه Meet را ارائه می‌کند. نمونه ها از کنفرانس کنفرانس conferenceRecords/AAA-BBB-CCC-DDD-EEE استفاده می کنند که در فضا برگزار می شود. برای هر رویدادی که اشتراک دریافت می‌کند، محموله در قسمت data رویداد ظاهر می‌شود:
| مثال | نوع رویداد | محموله JSON |
|---|---|---|
کنفرانسی برای فضای جلسه Meet شروع می شود. | | داده های منابع را در بر نمی گیرد
{
"conferenceRecord":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
}
}
|
| یک شرکت‌کننده به کنفرانسی در فضای جلسه Meet می‌پیوندد. | | داده های منابع را در بر نمی گیرد
{
"participantSession":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
}
}
|
| ضبط برای یک کنفرانس در فضای جلسه Meet ایجاد می شود. | google.workspace.meet.recording.v2.fileGenerated | داده های منابع را در بر نمی گیرد
{
"recording":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
}
}
|
| رونوشت برای یک کنفرانس در فضای جلسه Meet ایجاد می شود. | google.workspace.meet.transcript.v2.fileGenerated | داده های منابع را در بر نمی گیرد
{
"transcript":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
}
}
|
موضوعات مرتبط
- آموزش: رویدادهای جلسه را با پایتون و Google Meet REST API مشاهده کنید
- ساختار رویدادهای Google Workspace
- دامنه های OAuth را انتخاب کنید
- برای دریافت رویدادهای Meet اشتراکی ایجاد کنید
- نمای کلی Google Meet REST API
این صفحه رویدادهای Google Meet را توصیف می‌کند که برنامه شما می‌تواند با استفاده از Google Workspace Events API در آنها مشترک شود. بعد از اینکه تصمیم گرفتید به چه نوع رویدادهایی نیاز دارید، برای شروع دریافت رویدادها از Google Meet اشتراکی ایجاد کنید .
برای کسب اطلاعات بیشتر درباره توسعه برنامه‌ها برای Google Meet، به نمای کلی Google Meet REST API مراجعه کنید.
رویدادهای Meet پشتیبانی می شود
اشتراک‌های Google Workspace به شما امکان می‌دهند رویدادهایی را درباره انواع تغییرات زیر در Meet دریافت کنید:
- یک کنفرانس در یک فضای جلسه شروع یا به پایان می رسد.
- یک شرکت کننده به یک کنفرانس می پیوندد یا از آن خارج می شود.
- ضبط برای یک کنفرانس تولید می شود.
- یک متن برای یک کنفرانس تولید می شود.
منابعی که می توانید برای رویدادها نظارت کنید
برای دریافت رویدادها، یک منبع Meet را برای نظارت تعیین می کنید که به آن منبع هدف اشتراک می گویند.
Google Workspace Events API از منابع هدف زیر برای Meet پشتیبانی می‌کند:
| منبع هدف | قالب | محدودیت ها (در صورت وجود) |
|---|---|---|
| فضای جلسه | //meet.googleapis.com/spaces/ SPACE که در آن SPACE شناسه در نام منبع منبع | |
| کاربر | //cloudidentity.googleapis.com/users/ USER که در آن USER شناسه در قسمت | اشتراک رویدادهایی را درباره فضاهای جلسه دریافت می کند که کاربر یکی از موارد زیر است:
|
انواع رویداد برای ایجاد اشتراک
وقتی اشتراکی برای منبع 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 دارد که تغییر کرده است. برای مثال، اگر در رویدادهایی در مورد رونوشت‌های جدید در یک فضا مشترک شده‌اید، بارگذاری این رویدادها حاوی اطلاعاتی درباره منبع transcript تغییر یافته است.
داده های منبع در بارگذاری رویداد
جدول زیر نمونه‌هایی از بارهای JSON برای اشتراک در فضای جلسه Meet را ارائه می‌کند. نمونه ها از کنفرانس کنفرانس conferenceRecords/AAA-BBB-CCC-DDD-EEE استفاده می کنند که در فضا برگزار می شود. برای هر رویدادی که اشتراک دریافت می‌کند، محموله در قسمت data رویداد ظاهر می‌شود:
| مثال | نوع رویداد | محموله JSON |
|---|---|---|
کنفرانسی برای فضای جلسه Meet شروع می شود. | | داده های منابع را در بر نمی گیرد
{
"conferenceRecord":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
}
}
|
| یک شرکت‌کننده به کنفرانسی در فضای جلسه Meet می‌پیوندد. | | داده های منابع را در بر نمی گیرد
{
"participantSession":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP"
}
}
|
| ضبط برای یک کنفرانس در فضای جلسه Meet ایجاد می شود. | google.workspace.meet.recording.v2.fileGenerated | داده های منابع را در بر نمی گیرد
{
"recording":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP"
}
}
|
| رونوشت برای یک کنفرانس در فضای جلسه Meet ایجاد می شود. | google.workspace.meet.transcript.v2.fileGenerated | داده های منابع را در بر نمی گیرد
{
"transcript":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT"
}
}
|