نمای کلی Google Meet REST API

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

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

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

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

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

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

  • قبل از کنفرانس : با ایجاد فضای جلسه، تجربه کنفرانس را مطابق نیاز خود تنظیم کنید. همچنین می‌توانید مدعوین را مدیریت کرده و تنظیمات را از قبل پیکربندی کنید.

  • در طول یک کنفرانس : اطلاعات کنفرانس را بازیابی کنید تا تجربه برنامه خود را بر اساس فراداده‌های برگردانده شده تغییر دهید.

  • بعد از کنفرانس : مصنوعات کنفرانس، مانند ضبط و رونویسی را دریافت کنید.

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

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

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

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

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

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

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

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

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

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

مصنوع
فایلی که توسط Meet در پاسخ به یک کنفرانس ایجاد می‌شود، مانند recordings و transcripts . این فایل‌ها در Google 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 .

شرکت‌کننده

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

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

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