نمای کلی فضاهای جلسه Google Meet

تصویرسازی رابط برنامه‌نویسی کاربردی REST گوگل میت

این راهنما توضیح می‌دهد که چگونه API REST گوگل میت به شما امکان می‌دهد جلسات را برای گوگل میت ایجاد و مدیریت کنید.

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

برای کار با فضاهای جلسه، به ایجاد و مدیریت فضاهای جلسه مراجعه کنید. برای یادگیری نحوه پیکربندی برنامه‌ریزی‌شده یک فضای جلسه، به پیکربندی فضاهای جلسه و اعضا مراجعه کنید.

نحوه فراخوانی متدهای فضای جلسه

جدول زیر جزئیات نقش‌های جلسه مورد نیاز برای استفاده از متدهای فضای جلسه را نشان می‌دهد:

روش مالکان شرکت‌کنندگان دیگران
endActiveConference ایکس
get ایکس ایکس ایکس
با تنظیمات ایکس
با کنفرانس فعال ایکس ایکس
patch ایکس

چگونه Meet یک فضای جلسه را شناسایی می‌کند

رابط برنامه‌نویسی کاربردی REST گوگل میت برای هر فضای جلسه یک منبع spaces ایجاد می‌کند. منبع spaces چندین نقطه ورود برای پیوستن به یک کنفرانس ارائه می‌دهد.

جدول زیر نحوه شناسایی و پیوستن به یک فضای جلسه را نشان می‌دهد:

نام فیلد توضیحات
name نام فضا. رشته {space} شناسه منبع برای فضا است و به صورت spaces/{space} قالب‌بندی می‌شود. این یک شناسه منحصر به فرد تولید شده توسط سرور است و به حروف کوچک و بزرگ حساس است. به عنوان مثال، spaces/jQCFfuBOdN5z .
meetingCode نام مستعار برای نام فضا. {meetingCode} یک رشته کاراکتر منحصر به فرد و قابل تایپ است و به حروف کوچک و بزرگ حساس نیست. قالب آن به صورت spaces/{meetingCode} است. برای مثال، spaces/abc-mnop-xyz . حداکثر طول آن ۱۲۸ کاراکتر است. این بخشی از meetingUri است: https://meet.google.com/abc-mnop-xyz .
phoneAccess روش‌های دسترسی به تلفن برای این فضای جلسه. شیء phoneAccess حاوی اطلاعات مورد نیاز برای تماس تلفنی در یک کنفرانس، از جمله شماره تلفن‌های منطقه‌ای برای فضای جلسه و یک کد پین مخصوص آن شماره تلفن است. این پین فقط از ارقام اعشاری تشکیل شده و طول آن ممکن است متفاوت باشد. به عنوان مثال، "pin": 19707127300 .

مشابه رابط کاربری Meet، منبع spaces شامل مجموعه‌ای محدود از شماره‌های dial-in است. می‌توانید با افزودن {meetingCode} به آدرس اینترنتی زیر، شماره تلفن‌های اضافی برای یک فضای جلسه را مشاهده کنید: https://meet.google.com/tel/ . به عنوان مثال، https://meet.google.com/tel/abc-mnop-xyz .
gatewaySipAccess روش‌های دسترسی پروتکل شروع جلسه (SIP) برای این فضای جلسه. یک آدرس SIP جزئیات نحوه یافتن و پیوستن سخت‌افزار کنفرانس ویدیویی شخص ثالث به یک کنفرانس Meet را شرح می‌دهد. شیء gatewaySipAccess حاوی یک URI و کد دسترسی عددی است. Meet از طرح SIP URI پشتیبانی می‌کند.

برای مدیریت فضای جلسه، از مقادیر زیر برای فیلد name استفاده کنید:

  • برای دریافت جزئیات مربوط به فضای جلسه، می‌توانید از spaces/{space} یا نام مستعار spaces/{meetingCode} استفاده کنید. برای اطلاعات بیشتر، به دریافت فضای جلسه مراجعه کنید.

  • برای به‌روزرسانی جزئیات یک فضای جلسه، فقط می‌توانید spaces/{space} استفاده کنید. برای اطلاعات بیشتر، به به‌روزرسانی فضای جلسه مراجعه کنید.

  • برای پایان دادن به یک کنفرانس فعال در یک فضای جلسه، فقط می‌توانید spaces/{space} استفاده کنید. برای اطلاعات بیشتر، به پایان دادن به کنفرانس فعال مراجعه کنید.

چرخه عمر یک فضای جلسه

یک فضای جلسه در طول چرخه حیات خود چندین مرحله را طی می‌کند. نمودار زیر مراحل سطح بالای چرخه حیات یک فضای جلسه را نشان می‌دهد:

چرخه حیات فضای جلسات.
شکل ۱. چرخه عمر یک فضای جلسه.

  1. فراخوانی spaces.create . فضای جلسه ایجاد می‌شود و شیء spaces برگردانده شده شامل رشته meetingUri است. سپس meetingUri بین شرکت‌کنندگان توزیع می‌شود.

  2. فضای جلسه جدید را بررسی کنید . برای بررسی وضعیت کنفرانس، متد spaces.get را فراخوانی کنید.

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

  3. شروع کنفرانس . وقتی اولین شرکت‌کننده روی meetingUri در فضای جلسه کلیک می‌کند، کنفرانس شروع می‌شود. شیء activeConference پر شده و رشته activeConference.conferenceRecord تنظیم می‌شود.

  4. (اختیاری) دریافت داده‌های کنفرانس . در طول یک کنفرانس فعال، می‌توانید به برخی از مقادیر conferenceRecord دسترسی داشته باشید. برای مثال، متد conferenceRecords.participants.list را برای مشاهده‌ی همه شرکت‌کنندگان در کنفرانس فراخوانی کنید. همچنین می‌توانید تا 30 روز پس از کنفرانس به این اطلاعات دسترسی داشته باشید.

  5. (اختیاری) پایان دادن به کنفرانس . در طول کنفرانس، صاحب جلسه می‌تواند متد spaces.endActiveConference را برای پایان دادن به یک کنفرانس فعال برای همه شرکت‌کنندگان به صورت برنامه‌نویسی شده فراخوانی کند.

  6. کنفرانس پایان می‌یابد . وقتی آخرین شرکت‌کننده خارج شود، کنفرانس پایان می‌یابد.

  7. نظرسنجی برای مصنوعات پس از کنفرانس . کنفرانس پایان یافته است ( STATE=ENDED ) اما مصنوعات هنوز تولید نشده‌اند. startTime و endTime کنفرانس نیز پر شده‌اند. شما باید نقطه پایانی مصنوع را نظرسنجی کنید تا شیء مصنوع STATE FILE_GENERATED را بخواند.

    به جای نظرسنجی، می‌توانید در رویدادهای Meet مشترک شوید تا اعلان‌های فوری دریافت کنید.

  8. دریافت مصنوعات پس از کنفرانس . می‌توانید مصنوعاتی مانند ضبط‌ها و رونوشت‌ها را پس از تولید بازیابی کنید. برای مثال، متد conferenceRecords.recordings.get را برای دریافت یک ضبط با استفاده از شناسه ضبط فراخوانی کنید.

    پس از آماده شدن، یک URI به شیء مصنوع پر می‌شود و به عنوان بخشی از شیء منبع بازگردانده می‌شود.