نمای کلی Google Meet REST API

رابط برنامه‌نویسی کاربردی REST گوگل میت به شما امکان می‌دهد جلسات را برای گوگل میت ایجاد و مدیریت کنید و نقاط ورود را مستقیماً از برنامه خود به کاربران خود ارائه می‌دهد.

با Meet REST API، می‌توانید موارد زیر را انجام دهید:

  • فضاهای جلسه را برای ارتباط کاربران از طریق ویدیو ایجاد و پیکربندی کنید.
  • سطوح دسترسی به فضا، تنظیمات مدیریت و ضبط یا رونوشت خودکار را از قبل پیکربندی کنید.
  • اعضای فضای جلسه را مدیریت کنید و نقش‌های میزبان مشترک را تعیین کنید.
  • یک کنفرانس فعال را به صورت برنامه‌ریزی‌شده در یک فضای جلسه به پایان برسانید.
  • سوابق کنفرانس، جزئیات حضور و غیاب و فراداده‌های جلسه شرکت‌کنندگان را دریافت کنید.
  • بازیابی مصنوعات جلسه (ضبط‌ها، رونوشت‌ها، نوشته‌های رونوشت و یادداشت‌های هوشمند).

همچنین می‌توانید با استفاده از رابط برنامه‌نویسی کاربردی رویدادهای Google Workspace در رویدادهای Meet مشترک شوید. برای اطلاع از تغییرات، می‌توانید در یک فضای جلسه مشخص یا در تمام فضاهای جلسه متعلق به یک کاربر مشخص مشترک شوید. برای اطلاعات بیشتر، به موارد زیر مراجعه کنید:

موارد استفاده

برنامه‌ها می‌توانند با Meet REST API ادغام شوند تا وظایف زیر را انجام دهند:

  • قبل از کنفرانس : فضاهای جلسه را بنا به درخواست ایجاد کنید، محدودیت‌های دسترسی (باز، قابل اعتماد یا محدود) را از قبل پیکربندی کنید، کنترل‌های مدیریت (اشتراک‌گذاری صفحه، چت، واکنش‌ها، میکروفون و دوربین) را اعمال کنید، ضبط خودکار یا رونویسی خودکار را پیکربندی کنید و به اعضای فضا نقش‌های میزبان مشترک اختصاص دهید.

  • در طول یک کنفرانس : فراداده‌های فعال کنفرانس و جلسات شرکت‌کنندگان را بازیابی کنید، اعضا را به صورت پویا مدیریت کنید، با استفاده از API رویدادهای Google Workspace به رویدادهای چرخه عمر در لحظه گوش دهید، یا کنفرانس فعال را به صورت برنامه‌نویسی شده پایان دهید.

  • بعد از کنفرانس : سوابق کنفرانس و گزارش‌های حضور و غیاب را بازیابی کنید، فایل‌های ضبط‌شده، رونوشت‌های Google Docs و یادداشت‌های هوشمند را از Google Drive دانلود کنید و به ورودی‌های ریز به ریز متن سخنرانی‌ها برای آموزش، انطباق با قوانین یا تحلیل هوش مصنوعی دسترسی داشته باشید.

برخی از مواردی که ممکن است بخواهید از Meet REST API برای آنها استفاده کنید عبارتند از:

  • مدیریت فروش و حساب

    • اطلاعات جلسه و شرکت‌کنندگان را برای اهداف ثبت بازیابی کنید.
    • مصنوعات جلسه را دریافت کنید و آنها را در حساب‌ها ارسال کنید.
    • اجرای رونوشت‌ها و ضبط‌ها از طریق مدل‌های هوش مصنوعی برای ایجاد تحلیل‌های مربیگری و اثربخشی فروش.

  • یادگیری و توسعه

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

  • پشتیبانی و مشاوره مشتری

    • فضاهای جلسه امن و محدود را مستقیماً از طریق تیکت‌های میز کمک یا پورتال‌های مشتری ایجاد کنید.
    • مدیریت میزبان را از قبل پیکربندی کنید تا فقط نمایندگان پشتیبانی بتوانند حضور و غیاب را ارائه یا مدیریت کنند.
    • ضبط یا رونویسی خودکار را برای تضمین کیفیت و سوابق انطباق فعال کنید.
    • با پایان یافتن قرار ملاقات‌ها یا جلسات پشتیبانی، کنفرانس‌های فعال را به‌طور برنامه‌ریزی‌شده خاتمه دهید.

  • عملیات توسعه‌دهندگان

    • جلساتی ایجاد کنید تا فوراً هم‌تیمی‌ها را به هم متصل کنید.
    • با به اشتراک گذاشتن اطلاعات لحظه‌ای جلسات و شرکت‌کنندگان، به سایر ذینفعان اجازه دهید به جلسات جاری بپیوندند.
    • داده‌های رونویسی را از طریق مدل‌های هوش مصنوعی اجرا کنید تا مراحل بعدی صحیح تولید شوند.
در یک فضای چت، یک جلسه پویا با همکارانتان ایجاد کنید و به آن بپیوندید.
شکل ۱. ایجاد و پیوستن به یک جلسه پویا با همکارانتان در یک فضای چت.

همچنین می‌توانید سایر APIهای Google Workspace مانند Chat API را در برنامه خود بگنجانید تا همکاری را حتی بیشتر گسترش دهید. برای اطلاعات بیشتر، به موارد استفاده Chat مراجعه کنید.

اصطلاحات رایج

در زیر لیستی از اصطلاحات رایج مورد استفاده در این API آمده است:

کنفرانس فعال
کنفرانس جاری که در داخل یک فضای جلسه برگزار می‌شود. در هر زمان معین، فقط یک کنفرانس فعال می‌تواند در یک فضای جلسه برگزار شود. پس از پایان، آن کنفرانس به یک سابقه کنفرانس تبدیل می‌شود.
مصنوع
فایلی که توسط Meet در پاسخ به یک کنفرانس ایجاد می‌شود، مانند recordings ، transcripts و smartNotes . این موارد در Drive سازمان‌دهنده جلسه ذخیره می‌شوند. آنها معمولاً بلافاصله پس از پایان کنفرانس آماده دریافت هستند.
رویداد تقویم
رویدادی در تقویم گوگل با چندین شرکت‌کننده که معمولاً توسط برگزارکننده جلسه ایجاد می‌شود و حاوی اطلاعات پیوستن به جلسه است. Meet می‌تواند راهکار کنفرانسی برای این رویداد باشد.
تماس بگیرید
جلسه‌ای با استفاده از Meet، یا برای اطلاع‌رسانی به دیگران مبنی بر شروع یا در حال انجام بودن تماس و امکان پیوستن فوری آنها.
میزبان مشترک
شخصی در یک تماس که توسط یک میزبان، امتیازات مدیریت میزبان به او اعطا شده است، به جز امکان حذف میزبان اصلی.
کنفرانس
کنفرانس نمونه‌ای از یک تماس تلفنی در یک فضای جلسه است. کاربران معمولاً این سناریو را یک جلسه واحد در نظر می‌گیرند.
سابقه کنفرانس
یک شناسه منحصر به فرد برای هر نمونه از کنفرانس . این شناسه به طور خودکار با شروع کنفرانس ایجاد می‌شود. منبع conferenceRecords از قالب conferenceRecords/{conferenceRecord} استفاده می‌کند. برای مثال، conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ .
شماره گیری کنید
برای استفاده از تلفن برای شرکت در یک تماس یا گوش دادن به یک تماس پخش شده.
میزبان
شخصی که تماس را ایجاد کرده است ( سازمان‌دهنده جلسه ) یا شخصی که تماس را کنترل می‌کند. توجه داشته باشید که یک سازمان‌دهنده جلسه می‌تواند جلسه را سازماندهی کند اما در زمان برگزاری آن حضور نداشته باشد. یک میزبان همچنین می‌تواند امتیازات میزبانی را به یک میزبان مشترک واگذار کند.
کد جلسه

یک رشته ۱۰ کاراکتری منحصر به فرد و قابل تایپ برای فضای جلسه که در URI جلسه فضای جلسه استفاده می‌شود. این رشته به حروف کوچک و بزرگ حساس نیست. برای مثال، abc-mnop-xyz . حداکثر طول آن ۱۲۸ کاراکتر است.

کدهای جلسه نباید برای مدت طولانی ذخیره شوند زیرا ممکن است از فضای جلسه جدا شوند و در آینده برای فضاهای مختلف جلسه دوباره استفاده شوند. معمولاً کدهای جلسه ۳۶۵ روز پس از آخرین استفاده منقضی می‌شوند. برای اطلاعات بیشتر، به «درباره کدهای جلسه در Google Meet بیشتر بدانید» مراجعه کنید.

نام جلسه

یک شناسه منحصر به فرد تولید شده توسط سرور که برای شناسایی فضای جلسه استفاده می‌شود. این شناسه به حروف کوچک و بزرگ حساس است. برای مثال، jQCFfuBOdN5z . شناسه جلسه در فیلد name منبع spaces برگردانده می‌شود. برای اطلاعات بیشتر، به نحوه شناسایی فضای جلسه توسط Meet مراجعه کنید.

برگزارکننده جلسه

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

فضای جلسات

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

آدرس اینترنتی (URI) جلسه

یک URL قابل کلیک که کاربر را به یک تماس شروع یا به آن ملحق می‌کند. هر تماس یک URL منحصر به فرد دارد که شامل https://meet.google.com/ و به دنبال آن کد جلسه است. به عنوان مثال، https://meet.google.com/abc-mnop-xyz .

عضو

کاربری که به طور صریح با نقشی مشخص (مانند COHOST ) به فضای جلسه اضافه شده است. برخلاف شرکت‌کننده‌ای که فقط در طول یک کنفرانس زنده حضور دارد، یک عضو با فضای جلسه دائمی مرتبط است و امتیازات خود را در چندین کنفرانس در آن فضا حفظ می‌کند.

شرکت‌کننده

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

جلسه شرکت کنندگان

یک شناسه جلسه منحصر به فرد برای هر جفت شرکت‌کننده-دستگاه که به یک تماس می‌پیوندد ایجاد می‌شود. برای هر جلسه یک منبع participantSessions وجود دارد. اگر شرکت‌کننده چندین بار از یک جفت شرکت‌کننده-دستگاه به یک تماس بپیوندد، به هر یک از آنها شناسه‌های جلسه منحصر به فردی اختصاص داده می‌شود.

ضبط

یک فایل ویدیویی MP4 و فراداده‌های مرتبط که هنگام ضبط کنفرانس تولید می‌شوند. فایل‌های ضبط شده در Drive سازمان‌دهنده جلسه ذخیره می‌شوند و می‌توانند به عنوان مصنوعات جلسه بازیابی شوند.

آدرس SIP

یک آدرس پروتکل شروع جلسه (SIP) جزئیات نحوه یافتن و پیوستن سخت‌افزار کنفرانس ویدیویی شخص ثالث به یک کنفرانس Meet را شرح می‌دهد. Meet از طرح SIP URI پشتیبانی می‌کند.

یادداشت هوشمند

خلاصه‌ای مختصر از نکات کلیدی و موارد عملی از کنفرانسی که توسط Gemini تولید شده و به عنوان فایل Docs به Drive برگزارکننده جلسه صادر شده است.

رونوشت

یک سند متنی که مکالمه گفتاری یک کنفرانس را ضبط می‌کند و به عنوان فایل Docs به درایو سازمان‌دهنده جلسه صادر شده است.

ورودی رونوشت

بخش مجزایی از سخنرانی رونویسی‌شده‌ی یک شرکت‌کننده در یک کنفرانس . هر ورودی شامل هویت شرکت‌کننده، مهر زمان، متن گفتاری و کد زبان است و به مدت ۳۰ روز پس از پایان کنفرانس در دسترس است.