نمای کلی Google Meet REST API

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

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

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

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

موارد استفاده کنید

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

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

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

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

چند نمونه از مواردی که ممکن است بخواهید از Meet REST API استفاده کنید شامل موارد زیر است:

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

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

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

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

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

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

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

غیرواقعی، ساختگی
فایلی که توسط Meet در پاسخ به یک کنفرانس تولید می‌شود، مانند موارد ضبط‌شده و رونوشت‌ها . معمولاً یک مصنوع به زودی پس از پایان کنفرانس آماده دریافت است.
رویداد تقویم
رویدادی در Google Calendar با شرکت‌کنندگان متعدد، که معمولاً توسط سازمان‌دهنده جلسه ایجاد می‌شود و حاوی اطلاعات پیوستن به یک جلسه است. Meet ممکن است راه حل کنفرانس برای این رویداد باشد.
زنگ زدن
جلسه ای که از Meet استفاده می کند، یا به دیگران اطلاع می دهد که تماسی شروع شده یا در حال انجام است و به آنها اجازه می دهد فوراً ملحق شوند.
کنفرانس
کنفرانس نمونه ای از تماس در فضای جلسه است. کاربران معمولاً این سناریو را یک جلسه در نظر می گیرند.
میزبان مشترک
شخصی در تماسی که توسط یک میزبان به او امتیازات مدیریت میزبان داده شده است، به جز توانایی حذف میزبان اصلی.
میزبان
شخصی که تماس ایجاد کرده است ( سازمان دهنده جلسه ) یا شخصی که تماس را کنترل می کند. توجه داشته باشید که یک سازمان دهنده جلسه می تواند جلسه را سازماندهی کند اما در زمان برگزاری آن حضور نداشته باشد. یک میزبان همچنین می‌تواند امتیازات میزبان را به یک میزبان مشترک واگذار کند.
کد جلسه

یک رشته 10 کاراکتری قابل تایپ و منحصر به فرد برای فضای جلسه که در URI جلسه یک فضای جلسه استفاده می شود. به حروف بزرگ و کوچک حساس نیست. به عنوان مثال، abc-mnop-xyz . حداکثر طول 128 کاراکتر است.

کدهای جلسه نباید طولانی مدت ذخیره شوند، زیرا ممکن است از یک فضای جلسه جدا شوند و در آینده برای مکان های مختلف جلسه مورد استفاده مجدد قرار گیرند. به طور کلی، کدهای جلسه 365 روز پس از آخرین استفاده منقضی می شوند. برای اطلاعات بیشتر، در مورد کدهای جلسه در Google Meet آشنا شوید.

نام جلسه

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

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

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

فضای جلسه

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

URI جلسه

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

شرکت کننده

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

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

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

اطلاعات مجوز و احراز هویت خاص API

محدوده مجوز مجوزهایی هستند که از کاربران درخواست می‌کنید تا برنامه شما به محتوای جلسه اجازه دسترسی داشته باشند. هنگامی که شخصی برنامه شما را نصب می کند، از کاربر خواسته می شود تا این حوزه ها را تأیید کند. به طور کلی، شما باید محدودترین محدوده ممکن را انتخاب کنید و از درخواست دامنه هایی که برنامه شما به آن نیاز ندارد اجتناب کنید. کاربران با سهولت بیشتری به محدوده‌های محدود و به وضوح توضیح داده شده دسترسی می‌دهند.

Meet REST API از دامنه های OAuth 2.0 زیر پشتیبانی می کند:

کد محدوده شرح استفاده
https://www.googleapis.com/auth/meetings.space.readonly به برنامه‌ها اجازه دهید فراداده‌های مربوط به هر فضای جلسه‌ای را که کاربر به آن دسترسی دارد بخواند. حساس
https://www.googleapis.com/auth/meetings.space.created به برنامه ها اجازه ایجاد، اصلاح و خواندن فراداده مربوط به فضاهای جلسه ایجاد شده توسط برنامه شما را بدهید. حساس
https://www.googleapis.com/auth/drive.readonly به برنامه‌ها اجازه دهید فایل‌های ضبط‌شده و رونویسی را از Google Drive API بارگیری کنند. محصور

برای اطلاعات بیشتر درباره حوزه‌های خاص OAuth 2.0، به OAuth 2.0 Scopes برای Google API مراجعه کنید.