نظرة عامة حول Google Meet REST API

تتيح لك واجهة برمجة التطبيقات Google Meet REST إنشاء اجتماعات في Google Meet وإدارتها، كما توفِّر نقاط دخول للمستخدمين مباشرةً من تطبيقك.

باستخدام واجهة برمجة التطبيقات Meet REST، يمكنك إجراء ما يلي:

  • يمكنك إنشاء مساحة اجتماع لربط المستخدمين عبر الفيديو.
  • يمكنك الحصول على مساحة اجتماعات أو مكالمة فيديو حسب اسم المورد.
  • احصل على قائمة بالمشاركين وجلسات المشاركين.
  • احصل على عناصر الاجتماع (التسجيلات والنصوص وإدخالات النص).

يمكنك أيضًا الاشتراك في فعاليات Meet باستخدام Google Workspace Events API. لتلقّي إشعار بالتغييرات، يمكنك الاشتراك في مساحة اجتماعات محدَّدة أو في جميع مساحات الاجتماعات التي يملكها مستخدم محدَّد. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة الاشتراك في الفعاليات باستخدام Google Workspace Events API والاشتراك في فعاليات Google Meet.

حالات الاستخدام

يمكن دمج التطبيقات مع Meet REST API لتنفيذ المهام التالية:

  • قبل المؤتمر: يمكنك تخصيص تجربة المؤتمر حسب الحاجة من خلال إنشاء مساحة للاجتماع. يمكنك أيضًا إدارة المدعوين وضبط الإعدادات مسبقًا.

  • أثناء المؤتمر: يمكنك استرداد معلومات المؤتمر لتغيير تجربة التطبيق استنادًا إلى البيانات الوصفية التي يتم عرضها.

  • بعد المؤتمر: يمكنك جلب عناصر المؤتمر، مثل التسجيل وتحويل الصوت إلى نص.

في ما يلي بعض الأمثلة على العناصر التي يمكنك استخدامها لاستخدام Meet REST API:

  • إدارة المبيعات والحسابات

    • استرداد معلومات الاجتماع والمشارك لأغراض التسجيل.
    • يمكنك جلب عناصر الاجتماع ونشرها في الحسابات.
    • يمكنك إجراء تحويل الصوت إلى نص والتسجيلات من خلال نماذج الذكاء الاصطناعي لإجراء تدريب وتحليل فعّال للمبيعات.

  • التعلُّم والتطوير

    • يمكنك إنشاء اجتماعات وإعدادها مسبقًا للتدريب.
    • إسناد أدوار المضيفين المشاركين إلى المدرّبين وقادة الجلسات.
    • يمكنك استرداد التسجيلات التي تتيح للطلاب مراجعة المواد بعد انتهاء الدورة التدريبية.

  • عمليات المطوّرين

    • يمكنك إنشاء اجتماعات للتواصل مع زملائك في الفريق على الفور.
    • اسمح للأطراف المعنية الآخرين بالانضمام إلى الاجتماعات الجارية من خلال مشاركة الاجتماعات في الوقت الفعلي ومعلومات المشاركين.
    • شغِّل بيانات تحويل الصوت إلى نص من خلال نماذج الذكاء الاصطناعي لإنشاء الخطوات التالية الصحيحة.
يمكنك إنشاء اجتماع ديناميكي والانضمام إليه مع زملائك في مساحة Chat.
الشكل 1. يمكنك إنشاء اجتماع ديناميكي والانضمام إليه مع زملائك في مساحة Chat.

يمكنك أيضًا دمج واجهات برمجة تطبيقات Google Workspace أخرى، مثل Chat API، في تطبيقك لتعزيز التعاون. لمزيد من المعلومات، يُرجى الاطّلاع على حالات استخدام Chat.

عبارات عامة

في ما يلي قائمة بالمصطلحات الشائعة المستخدمة في واجهة برمجة التطبيقات هذه:

العناصر
ملفّ يتم إنشاؤه من خلال Meet استجابةً لمؤتمر، مثل التسجيلات وtranscripts. عادةً ما يكون العنصر جاهزًا للجلب بعد انتهاء المؤتمر بوقت قصير.
حدث في التقويم
حدث في "تقويم Google" يضم العديد من الضيوف، وينشئه عادةً منظّم الاجتماع وتحتوي على معلومات الانضمام إلى اجتماع. يمكن أن يكون تطبيق Meet هو حل المؤتمر الذي يمكن تنظيمه للفعالية.
Call
جلسة تستخدم Meet، أو لإشعار الآخرين ببدء مكالمة أو أنها قيد التقدم، والسماح لهم بالانضمام على الفور.
مؤتمر
المؤتمر هو مثال على مكالمة داخل مساحة اجتماع. عادةً ما يعتبر المستخدمون هذا السيناريو اجتماعًا واحدًا.
المضيف المشارك
شخص في مكالمة منحه امتيازات إدارة المضيف من خلال مضيف، باستثناء إمكانية إزالة المضيف الأصلي.
المضيف
الشخص الذي أجرى مكالمة (منظِّم الاجتماع) أو الشخص الذي يتحكّم في المكالمة. لاحظ أن منظم الاجتماع يمكنه تنظيم الاجتماع ولكنه لا يكون حاضرًا أثناء حدوثه. يمكن للمضيف أيضًا تفويض امتيازات المضيف إلى مضيف مشارك.
رمز الاجتماع

سلسلة فريدة مكوّنة من 10 أحرف وقابلة للكتابة لمساحة اجتماع يتم استخدامها ضمن معرّف الموارد المنتظم (URI) للاجتماع في مساحة اجتماع إنها غير حساسة لحالة الأحرف. مثلاً: abc-mnop-xyz ويجب ألّا يزيد عدد الأحرف عن 128 حرفًا.

يجب عدم تخزين رموز الاجتماعات على المدى الطويل حيث يمكن أن تنفصل عن مساحة الاجتماع ويمكن إعادة استخدامها لمساحات اجتماعات مختلفة في المستقبل. بشكل عام، تنتهي صلاحية رموز الاجتماعات بعد 365 يومًا من آخر استخدام. لمزيد من المعلومات، راجِع التعرّف على رموز الاجتماعات في Google Meet.

اسم الاجتماع

معرّف فريد ينشئه الخادم ويتم استخدامه لتحديد مساحة اجتماع. إنها حساسة لحالة الأحرف. مثلاً: jQCFfuBOdN5z يتم عرض معرّف الاجتماع في الحقل name لمورد spaces.

منظّم الاجتماع

المستخدم الذي أنشأ مساحة الاجتماع يمكن أيضًا اعتبار هذا المستخدم مالك الاجتماع. قد لا يكون حاضرًا أثناء المكالمة أو قد يكون مضيف الاجتماع. يمكن أن يكون هناك منظّم اجتماع واحد فقط.

مساحة الاجتماع

مكان افتراضي أو كائن دائم (مثل غرفة اجتماعات) حيث يعقد مؤتمر. يمكن عقد مؤتمر نشط واحد فقط في مساحة واحدة في أي وقت. تساعد مساحة الاجتماعات أيضًا المستخدمين على مقابلة الموارد المشتركة والعثور عليها.

معرّف الموارد المنتظم (URI) للاجتماع

عنوان URL قابل للنقر يبدأ أو ينضم المستخدِم إلى مكالمة. لكل مكالمة عنوان URL فريد يتكون من https://meet.google.com/ متبوعًا برمز الاجتماع. مثلاً: https://meet.google.com/abc-mnop-xyz

المشارك

انضمّ شخص إلى مكالمة أو يستخدم وضع المزاملة أو يشاهد كمشاهد أو جهاز غرفة متصل بمكالمة. يتوفّر مورد واحد conferenceRecords.participants لكل مستخدم. عندما ينضم أحد المشاركين إلى المؤتمر، يتم تعيين معرّف فريد.

جلسة المشارِك

معرّف جلسة فريد يتم إنشاؤه لكل زوج من جهاز المشاركين ينضم إلى مكالمة. يتوفّر مورد conferenceRecords.participants.participantSessions واحد لكل جلسة. إذا انضم المشارك إلى المكالمة نفسها عدة مرات من نفس زوج الجهاز المشارك، فسيتم تعيين معرّفات جلسة فريدة له.

معلومات التفويض والمصادقة الخاصة بواجهة برمجة التطبيقات

نطاقات التفويض هي الأذونات التي تطلب من المستخدمين المصادقة عليها لتطبيقك للوصول إلى محتوى الاجتماع. عندما يثبّت شخص تطبيقك، يُطلب من المستخدم التحقق من صحة هذه النطاقات وبشكل عام، ينبغي لك اختيار النطاق الأكثر تضييقًا وتجنب طلب النطاقات التي لا يتطلبها تطبيقك. يمكن للمستخدمين الآن منح المستخدمين إمكانية الوصول إلى نطاقات محدودة وموضّحة بوضوح.

تتوافق واجهة برمجة تطبيقات REST في Meet مع نطاقات 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 لواجهات Google APIs.