يتم إنشاء إضافات Google Meet وضبطها كجزء من مشروع على السحابة الإلكترونية من Google.
إنشاء مشروع على Google Cloud
لإنشاء مشروع على Google Cloud، يُرجى الاطّلاع على مقالة إنشاء مشروع على Google Cloud.
تفعيل حزمة تطوير البرامج (SDK) في Google Workspace Marketplace وGoogle Workspace add-ons API
يجب استخدام حزمة تطوير البرامج (SDK) في Marketplace وGoogle Workspace add-ons API لتطوير إضافات Meet. لتفعيلهما:
- افتح Google Cloud Console.
- في أعلى الصفحة، إذا كان مشروع مختلف مفتوحًا حاليًا، انقر على اسم مشروع تطبيقك للتبديل بين المشاريع.
- في أعلى الصفحة، في شريط البحث، اكتب
Google Workspace Marketplace SDKواضغط على مفتاح الإدخال. افتح صفحة
Google Workspace Marketplace SDKوانقر على تفعيل.كرِّر هذه الخطوات للعثور على
Google Workspace add-ons APIوتفعيلها.
إنشاء عملية نشر
لاستخدام إضافة في Meet، تحتاج إلى عملية نشر وملف بيان للإضافة.
انتقِل إلى حزمة تطوير البرامج (SDK) في Google Workspace Marketplace لمشروعك في Google Cloud Console
- افتح Google Cloud Console.
- في أعلى الصفحة، إذا كان مشروع مختلف مفتوحًا حاليًا، انقر على اسم مشروع تطبيقك للتبديل بين المشاريع.
- انقر على واجهات برمجة التطبيقات والخدمات.
- انقر على
Google Workspace Marketplace SDKلعرض صفحة التفاصيل.
إنشاء عملية النشر
يمكنك إنشاء عملية النشر مباشرةً في Google Cloud Console من خلال إنشاء عملية نشر HTTP (ننصح بذلك) أو باستخدام برمجة تطبيقات Google.
عملية نشر HTTP
- انقر على علامة التبويب عمليات نشر HTTP.
انقر على إنشاء عملية نشر جديدة وأدخِل رقم تعريف عملية نشر الإضافة.
رقم تعريف عملية النشر هو سلسلة عشوائية تساعد مطوّر الإضافة في تحديد عملية النشر التي تحتوي على بيان الإضافة. أرقام تعريف عمليات النشر مطلوبة ويجب ألا يزيد عدد أحرفها عن 100 حرف.
انقر على التالي.
تُفتح لوحة جانبية لإرسال مواصفات بيان الإضافة بتنسيق 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. للاطّلاع على إرشادات تصميم الشعار، يُرجى قراءة أفضل الممارسات.
انقر على إرسال.
لمزيد من المعلومات عن عمليات النشر، يُرجى الاطّلاع على مقالة إنشاء مورد عملية نشر.
في علامة التبويب إعدادات التطبيق ، ضمن تكامل التطبيق، انقر على إضافة Google Workspace. انقر على النشر باستخدام مورد عملية نشر على السحابة الإلكترونية ، ثم اختَر عملية نشر HTTP الصحيحة.
برمجة تطبيقات Google
انقر على علامة التبويب إعدادات التطبيق.
ضمن تكامل التطبيق ، انقر على إضافة Google Workspace. انقر على النشر باستخدام رقم تعريف عملية نشر برمجة تطبيقات Google وأدخِل رقم تعريف عملية نشر النص البرمجي.
انقر على حفظ.
لمعرفة التفاصيل حول كيفية إنشاء مشروع في برمجة تطبيقات 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. للاطّلاع على إرشادات تصميم الشعار، يُرجى قراءة أفضل الممارسات.
تثبيت الإضافة واختبارها في Meet
لاختبار الإضافة في Meet، عليك أولاً تثبيتها للمستخدم الذي سجّل الدخول:
عملية نشر HTTP
- انتقِل إلى حزمة تطوير البرامج (SDK) في Google Workspace Marketplace لمشروعك في Google Cloud Console.
- انقر على علامة التبويب عمليات نشر HTTP.
- انقر على تثبيت ضمن عمود الإجراءات.
برمجة تطبيقات Google
يجب أن تتمكّن الآن من استخدام الإضافة في اجتماع. لتجربتها، ابدأ اجتماعًا على meet.google.com. تظهر الإضافة المثبَّتة الآن في لوحة "الأنشطة" .
بالإضافة إلى تثبيت الإضافة للمستخدم الفردي الذي سجّل الدخول، يمكنك أيضًا نشرها. عند نشر إضافة Google Workspace، يمكنك إتاحتها للآخرين للعثور عليها وتثبيتها واستخدامها.