نشر إضافة Meet

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

إنشاء مشروع على 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، وانقر على تفعيل.

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

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

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

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

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

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

نشر 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. انقر على حفظ.

    لمعرفة تفاصيل حول كيفية إنشاء مشروع "برمجة تطبيقات Google"، يُرجى الاطّلاع على مستندات "برمجة التطبيقات". تعتمد إضافة Meet فقط على ملف البيان appscript.json، الذي يُعرَف أيضًا باسم بيان مشروع "برمجة التطبيقات". تأكَّد من أنّ ملف البيان في مشروعك على 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، تجعلها متاحة لمستخدمين آخرين للعثور عليها وتثبيتها واستخدامها.