نشر إضافة Meet

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

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

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

تفعيل حزمة تطوير البرامج (SDK) في Google Workspace Marketplace وواجهة برمجة التطبيقات لإضافات Google Workspace

يجب استخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace وواجهة برمجة التطبيقات لإضافات Google Workspace من أجل تطوير إضافات Meet. لتفعيلها، اتّبِع الخطوات التالية:

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

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

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

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

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

  1. افتح وحدة تحكّم Google Cloud.
  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: اختياري. منطقي. إذا تم ضبط القيمة على false، يجب أن يستخدم المستخدمون الإضافة لمعرفة ما يحدث في جلسة إضافة تعاونية. في حال ضبطها على "صحيح"، يمكن للمستخدم الذي بدأ جلسة التعاون باستخدام الإضافة مشاركة شاشته مع الآخرين.

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

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

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

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

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

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

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

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