نشر إضافة Meet

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

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

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

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

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

يجب استخدام حزمة تطوير البرامج (SDK) في 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 وليس واجهة برمجة التطبيقات. 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 Console من خلال إنشاء عملية نشر HTTP (ننصح بذلك) أو باستخدام برمجة تطبيقات Google.

عملية نشر HTTP

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   يوضّح نموذج الرمز التالي حقول Meet المتاحة في ملف بيان الإضافة.

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

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

   • NAME: سلسلة. اسم إضافة Google Meet
   • LOGO_URL: سلسلة. عنوان URL لشعار إضافة Google Workspace يُستخدم هذا الشعار للإضافة على مستوى منتجات Google Workspace.
   • SIDE_PANEL_URL: سلسلة. عنوان URL لنقطة دخول تطبيق الإضافة. يظهر هذا العنوان في إطار iframe ضمن اللوحة الجانبية. يجب أن يكون مصدر عنوان URL هذا جزءًا من المصادر المحدّدة في الحقل ADD_ON_ORIGINS.
   • SUPPORTS_SCREENSHARING: اختياري. منطقي. إذا تم ضبط هذه القيمة على "خطأ"، يجب أن يستخدم المستخدمون الإضافة للاطّلاع على ما يحدث في جلسة تعاونية للإضافة. إذا تم ضبط هذه القيمة على "صحيح"، يمكن لمُنشئ جلسة التعاونية للإضافة مشاركة شاشة العرض الخاصة به للإضافة.
   • ADD_ON_ORIGINS: قائمة سلاسل. قائمة بـ المصادر التي تتم فيها استضافة الإضافة يكون لعنوانَي URL المصدر نفسه عندما يتشاركان المخطط والمضيف والمنفذ نفسهما. يُسمح أيضًا بالمصادر الفرعية، وكذلك النطاقات الفرعية التي تستخدم أحرف بدل. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة أمان الإضافة.
   • MEET_WEB_LOGO_URL: اختياري. سلسلة. عنوان URL خاص بـ Meet لشعار الإضافة يُستخدم هذا الشعار في جميع أنحاء Meet. إذا لم يكن هذا الشعار متوفرًا، يتم استخدام logoUrl من القسم الشائع. للاطّلاع على إرشادات تصميم الشعار، يُرجى الاطّلاع على أفضل الممارسات.
   • DARK_MODE_LOGO_URL: سلسلة. عنوان URL خاص بالمظهر الداكن لشعار الإضافة يضمن توفير شعار للمظهر الداكن ظهور الإضافة بأفضل شكل في أي مظهر من مظاهر Meet. للاطّلاع على إرشادات تصميم الشعار ، يُرجى الاطّلاع على أفضل الممارسات.
   ملاحظة مهمة: على عكس إضافات Google Workspace الأخرى، لا يمكن إنشاء إضافات Meet بالكامل في برمجة تطبيقات Google. عليك بدلاً من ذلك إنشاء تطبيق ويب كامل من خلال إنشاء لوحة جانبية ومرحلة رئيسية. يجب بعد ذلك تحديد عنوان URL للوحة الجانبية لتطبيق الويب ضمن الـ SIDE_PANEL_URL في ملف بيان 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، يمكنك إتاحتها للآخرين للعثور عليها وتثبيتها واستخدامها.