نشر إضافة Meet

يتم إنشاء إضافات Google Meet وضبطها كجزء من مشروع على Google Cloud.

ملاحظة: لإنشاء إضافة، عليك أولاً إنشاء تطبيق ويب يستخدِم حزمة تطوير البرامج (SDK) لإضافة Meet.

إنشاء مشروع على Google Cloud

لإنشاء مشروع على Google Cloud، راجِع مقالة إنشاء مشروع على Google Cloud.

تفعيل حزمة تطوير البرامج (SDK) في Google Workspace Marketplace وGoogle Workspace add-ons API

يجب استخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace وGoogle Workspace Add-ons API لتطوير إضافات Meet. لتفعيل هذه الميزة:

1. افتح Google Cloud console.
2. في أعلى الصفحة، إذا كان هناك مشروع مختلف مفتوحًا، اختَر اسم مشروع تطبيقك للتبديل بين المشاريع.
3. في أعلى الصفحة، اكتب Google Workspace Marketplace SDK واضغط على مفتاح Enter.

4. افتح صفحة Google Workspace Marketplace SDK، وانقر على تفعيل.

   تحذير: تأكَّد من تفعيل Google Workspace Marketplace SDK وليس API. ‫Google Workspace Marketplace API هي أداة مختلفة تُستخدَم للقيام بعملية دمج مع خدمات الترخيص والفوترة في Google.

5. كرِّر هذه الخطوات للعثور على Google Workspace add-ons API وتفعيله.

إنشاء عملية نشر

لاستخدام إضافة في Meet، تحتاج إلى عملية نشر وملف بيان الإضافة.

انتقِل إلى حزمة تطوير البرامج (SDK) في Google Workspace Marketplace لمشروعك في Google Cloud Console.

1. افتح Google Cloud console.
2. في أعلى الصفحة، إذا كان هناك مشروع مختلف مفتوحًا، اختَر اسم مشروع تطبيقك للتبديل بين المشاريع.
3. انقر على واجهات برمجة التطبيقات والخدمات.
4. انقر على Google Workspace Marketplace SDK لعرض صفحة التفاصيل.

إنشاء عملية النشر

يمكنك إنشاء عملية النشر مباشرةً في وحدة تحكّم Google Cloud من خلال إنشاء عملية ملف شخصي على HTTP (إجراء يُنصح به) أو باستخدام Google Apps Script.

نشر HTTP

1. انقر على علامة التبويب عمليات نشر HTTP.

2. انقر على إنشاء عملية نشر جديدة وأدخِل رقم تعريف عملية نشر الإضافة.

   معرّف النشر هو سلسلة عشوائية تساعد مطوّر الإضافة في تحديد عملية النشر التي تحتوي على بيان الإضافة. يجب إدخال معرّفات النشر ، ويمكن أن تتألّف من 100 حرف كحدّ أقصى.

3. انقر على التالي.

   ستفتح لك لوحة جانبية لإرسال مواصفات بيان الإضافة بتنسيق JSON. ويُعرَف هذا الملف أيضًا باسم DEPLOYMENT.JSON.

   ملف بيان الإضافة هو الإعدادات المركزية لإضافة Google Meet. يعرض نموذج الرمز التالي حقول Meet المتاحة للويب في ملف بيان الإضافة.

   {
     "addOns": {
       "common": {
         "name": "NAME",
         "logoUrl": "LOGO_URL"
       },
       "meet": {
         "web": {
           "sidePanelUri": "SIDE_PANEL_URI",
           "addOnOrigins": ["ADD_ON_ORIGINS"],
           "darkModeLogoUrl": "DARK_MODE_LOGO_URL",
           "logoUrl": "MEET_WEB_LOGO_URL",
           "supportsScreenSharing": SUPPORTS_SCREENSHARING
         }
       }
     }
   }
   

   غيِّر القيم في السلسلة على الشكل التالي:

   • ‫NAME: سلسلة. اسم إضافة Google Meet.
   • ‫LOGO_URL: سلسلة. عنوان URL لشعار إضافة Google Workspace. ويُستخدَم هذا المفتاح في الإضافة على مستوى منتجات Google Workspace.
   • ‫SIDE_PANEL_URI: سلسلة. عنوان URL لنقطة دخول تطبيقك الإضافي. يتم عرض هذا العنوان في إطار iframe ضمن اللوحة الجانبية. يجب أن يكون أصل عنوان URL هذا جزءًا من الأصول المحدّدة في حقل ADD_ON_ORIGINS.
   • ‫ADD_ON_ORIGINS: قائمة السلاسل قائمة ب المصادر التي تتم فيها استضافة الإضافة يكون مصدر عنوانَي URL هو نفسه عندما يتشاركان المخطّط والمضيف والمنفذ نفسهما. يُسمح أيضًا بمصادر فرعية ، كما يُسمح بالنطاقات الفرعية التي تستخدم أحرف البدل. لمزيد من المعلومات، اطّلِع على أمان الإضافات.
   • ‫DARK_MODE_LOGO_URL: سلسلة. عنوان URL خاص بالوضع الداكن للشعار الخاص بالإضافة يضمن تقديم شعار للوضع الداكن أن تبدو الإضافة بأفضل شكل في أي مظهر من مظاهر Meet. للاطّلاع على إرشادات تصميم الشعار، يُرجى الاطّلاع على أفضل الممارسات.
   • ‫MEET_WEB_LOGO_URL: اختياري. سلسلة. عنوان URL خاص بتطبيق Meet للشعار المخصّص للإضافة يتم استخدام هذا الشعار في Meet. إذا لم يكن متوفّرًا، يتم استخدام logoUrl من القسم الشائع. للاطّلاع على إرشادات تصميم الشعار، يُرجى الاطّلاع على أفضل الممارسات.
   • ‫SUPPORTS_SCREENSHARING: اختياري. منطقي. إذا كان الإعداد هو "خطأ"، يجب على المستخدمين استخدام الإضافة للاطّلاع على ما يحدث في جلسة الإضافة المشترَكة. في حال ضبطها على "صحيح"، يمكن لمُشغِّل جلسة الإضافة التعاونية مشاركة الشاشة لعرض الإضافة.

4. انقر على إرسال.

   لمزيد من المعلومات عن عمليات النشر، يُرجى الاطّلاع على مقالة إنشاء موارد النشر.

5. في علامة التبويب إعدادات التطبيق، ضمن دمج التطبيق، اختَر إضافة Google Workspace. اختَر النشر باستخدام مورد نشر السحابة الإلكترونية، ثم اختَر نشر HTTP الصحيح.

لغة برمجة تطبيقات Google

1. انقر على علامة التبويب إعدادات التطبيق.

2. ضمن دمج التطبيقات، اختَر إضافة Google Workspace. اختَر النشر باستخدام برمجة تطبيقات Google رقم تعريف النشر وأدخِل رقم تعريف نشر النص البرمجي.

3. انقر على حفظ.

   للتعرّف على تفاصيل حول كيفية إنشاء مشروع على Apps Script، يُرجى الاطّلاع على مستندات Apps Script. تعتمد إضافة Meet على ملف البيان appsscript.json فقط، والذي يُعرف أيضًا باسم بيان مشروع "برمجة تطبيقات Google". تأكَّد من أنّ ملف البيان في مشروعك على Apps Script يحتوي على قسمَي addOns وmeet. يتّبع القسمان addOns وmeet البنية نفسها الموضّحة في علامة التبويب "نشر HTTP".

   على عكس إضافات Google Workspace الأخرى، لا يمكن إنشاء إضافات Meet بالكامل في Apps Script. بدلاً من ذلك، عليك إنشاء تطبيق ويب كامل من خلال إنشاء لوحة جانبية ومساحة عرض رئيسية. بعد ذلك، يجب تحديد عنوان URL لللوحة الجانبية لتطبيق الويب ضمن العنصر SIDE_PANEL_URI من ملف بيان appsscript.json.

تثبيت الإضافة واختبارها في Meet

لاختبار الإضافة في Meet، عليك أولاً تثبيتها للمستخدم الذي سجّل الدخول:

نشر HTTP

1. انتقِل إلى حزمة تطوير البرامج (SDK) في Google Workspace Marketplace لمشروعك في Google Cloud Console.
2. انقر على علامة التبويب عمليات نشر HTTP.
3. انقر على تثبيت ضمن عمود الإجراءات.

لغة برمجة تطبيقات Google

1. اتّبِع مستندات إضافات Google Workspace من أجل تثبيت إضافة لم يتم نشرها.

من المفترض أن تتمكّن الآن من استخدام الإضافة في اجتماع. لتجربة هذه الميزة، ابدأ اجتماعًا على meet.google.com. ستظهر الإضافة المثبَّتة الآن في لوحة "الأنشطة".

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