توضِّح هذه الصفحة كيفية استخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace لضبط تطبيقك وإدارته على Google Workspace Marketplace.
لتوفير تطبيقك للاستخدام، عليك إعداده في حزمة تطوير البرامج (SDK) لـ Marketplace. حزمة تطوير البرامج (SDK) في Marketplace هي مجموعة أدوات تتيح لك إنشاء تطبيقك والتحكّم فيه على Google Workspace Marketplace. يمكنك استخدام حزمة تطوير البرامج (SDK) لـ Marketplace لإدارة إعدادات Marketplace، مثل ما يلي:
- ما إذا كان تطبيقك متاحًا لمؤسسة Google Workspace معيّنة (تطبيق خاص) أو لجميع مستخدمي Marketplace (تطبيق متاح للجميع)
- تتضمن أنواع مستخدمي Marketplace الذين يمكنهم تثبيت تطبيقك
- تطبيقات Google Workspace التي يتكامل معها تطبيقك
- نطاقات OAuth التي يتطلبها تطبيقك
- معلومات عن الجهة التي أنشأت التطبيق وتحافظ عليه
بغض النظر عمّا إذا كنت تنشر تطبيقك بشكل خاص أو علني، عليك استخدام حزمة SDK لـ Marketplace لإدارة تطبيقك على Marketplace.
تفعيل حزمة تطوير البرامج (SDK) في Marketplace
في مشروعك على Google Cloud، فعِّل حزمة تطوير البرامج (SDK) في Google Workspace Marketplace إذا لم يسبق لك ذلك.
فتح مشروعك على Google Cloud في "وحدة تحكُّم Google Cloud"
افتح مشروع Cloud الذي تريد استخدامه لهذه العيّنة إذا لم يكن مفتوحًا من قبل:
- في وحدة تحكّم Google Cloud، انتقِل إلى صفحة اختيار مشروع.
- اختَر مشروع Google Cloud الذي تريد استخدامه. أو انقر على إنشاء مشروع واتّبِع التعليمات الظاهرة على الشاشة. في حال إنشاء مشروع على Google Cloud، قد تحتاج إلى تفعيل الفوترة للمشروع.
تفعيل حزمة تطوير البرامج (SDK) في Google Workspace Marketplace
قبل استخدام واجهات برمجة تطبيقات Google، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في مشروع واحد على Google Cloud.في Google Cloud Console، فعِّل حزمة تطوير البرامج (SDK) في Google Workspace Marketplace.
تحديد إعدادات الضبط لتطبيقك
يوضّح المرجع التالي الإعدادات المتاحة في صفحة إعدادات التطبيق لحزمة SDK في Marketplace.
اختيار مَن يمكنه عرض تطبيقك وتثبيته
عند ضبط إعدادات تطبيقك، يمكنك تحديد المستخدمين الذين يمكنهم الوصول إليه باستخدام الإعدادات التالية:
- مستوى رؤية التطبيق: إذا كنت بصدد نشر تطبيق ضمن مؤسسة Google Workspace، سواء كانت بطاقة بيانات تطبيقك غير مُدرَجة أو مرئية لجميع المستخدمين في مؤسستك أو لأي مستخدم يستخدم Google Workspace.
- إعدادات التثبيت: تشير إلى ما إذا كان يمكن لمشرفي Google Workspace فقط تثبيت التطبيق.
بغض النظر عن الإعدادات التي تحدّدها في بطاقة بيانات التطبيق، قد لا يتمكّن المستخدمون الذين ينتمون إلى مؤسسة في Google Workspace من اكتشاف تطبيقك أو تثبيته أو استخدامه استنادًا إلى الإعدادات التي ضبطها المشرفون. يمكن للمشرفين التأثير في مدى توفّر تطبيقك بالطرق التالية:
- التحكّم في إمكانية عرض المستخدمين للتطبيقات في Marketplace وتثبيت التطبيقات نيابةً عنهم
- استخدام قائمة مسموح بها لإدارة التطبيقات وتنظيمها لمؤسستهم إذا كنت تطوّر تطبيقًا لمؤسّسة تستخدم قوائم المسموح بها، يمكنك الرجوع إلى أحد المشرفين بشأن إضافة التطبيق إلى القائمة المسموح بها.
- يمكنك إيقاف تطبيقات معيّنة في Google Workspace، مثل إزالة إمكانية الوصول إلى Google Chat أو تطبيقات Google Chat أو كليهما. وفي هذه الحالات، لن يتمكّن المستخدمون من تثبيت تطبيقك من Marketplace.
للتعرّف على كيفية إدارة المشرفين للوصول إلى Marketplace، اطّلِع على مستندات "مساعدة مشرف Marketplace".
إعدادات ظهور التطبيقات
يظهر لك خيار مستوى رؤية التطبيق إذا كنت تستخدم حساب Google Workspace (حساب أنشأته مؤسستك التعليمية أو مؤسستك التي تعمل بها). إذا كنت تستخدم حساب مستهلك (حساب ينتهي بـ "@gmail.com")، يمكنك النشر علنًا فقط.
- عام: يمكن لأي مستخدم خارج نطاقك العثور على التطبيق وتثبيته. إذا اخترت مستوى الظهور العلني، تراجع Google بطاقة بيانات تطبيقك وتوافق عليها قبل نشره.
- خاص: يمكن للمستخدمين في نطاقك فقط العثور على تطبيقك وتثبيته.
إذا اخترت نشر التطبيق على أنّه غير مدرَج، لن تظهر بطاقة بيانات التطبيق في المتصفّح أو نتائج البحث. لا يمكن للمستخدمين الوصول إلى صفحة المتجر الخاصة بالتطبيق إلا باستخدام عنوان URL المباشر.
إذا كنت تريد حصر البلدان والمناطق التي يتوفّر فيها تطبيقك، يمكنك إعداد ذلك في قسم التوزيع عند إنشاء بطاقة بيانات المتجر.
إعدادات تثبيت التطبيقات
يحدِّد خيار إعدادات التثبيت ما إذا كان بإمكان المستخدمين أو مشرفي Google Workspace تثبيت تطبيقك من صفحة بطاقة بيانات المتجر على Google Workspace Marketplace.
- التثبيت الفردي + التثبيت من قِبل المشرف (الإعداد التلقائي): يمكن للمستخدمين الفرديين أو المشرفين تثبيت التطبيق لنطاقهم أو وحدتهم التنظيمية أو مجموعة من المستخدمين. قد تمنع سياسات النطاق المستخدم من تثبيت تطبيق حتى إذا كانت عمليات التثبيت الفردية مفعّلة.
- التثبيت من قِبل المشرفين فقط: لا يمكن للمشرفين تثبيت التطبيق إلا لنطاقهم أو وحدتهم التنظيمية أو مجموعة من المستخدمين. لا يظهر تطبيقك إلا في نتائج البحث في Google Workspace Marketplace للمشرفين والمستخدمين الذين لم يسجّلوا الدخول إلى حساباتهم على Google. حدِّد هذا الخيار إذا كان تطبيقك يتطلّب تثبيت النطاق.
إعدادات التثبيت ومستوى الرؤية الشائعة
يلخّص الجدول التالي بعض خيارات الإعدادات الشائعة للتطبيقات المتعلّقة بالتثبيت ومستوى العرض:
| مستخدِمو التطبيق المقصودون | إعداد مستوى ظهور التطبيق | إعداد تثبيت التطبيقات | مَن يمكنه تثبيت تطبيقي؟ | من يمكنه استخدام تطبيقي؟ | |
|---|---|---|---|---|---|
| للتطبيقات التي تم إنشاؤها لمؤسسة Google Workspace | |||||
| مستخدمون محدَّدون في مؤسستك | خاص وغير مُدرَج | التثبيت الفردي والتثبيت من قِبل المشرف | أي مستخدم في مؤسستك لديه عنوان URL لبيانات تطبيقك، إذا كان ذلك مسموحًا به | أي مستخدم في مؤسستك لديه عنوان URL لبيانات تطبيقك، إذا كان ذلك مسموحًا به | |
| مؤسستك | خاصة | تثبيت فردي والمشرف | لأي شخص في مؤسستك، في حال السماح بذلك. | أي شخص في مؤسستك، إذا كان ذلك مسموحًا به | |
| مؤسستك | خاص | المشرف فقط | المشرفون | المستخدمون الذين ثبَّت المشرف التطبيق لديهم | |
| بالنسبة إلى التطبيقات المتاحة للمستخدمين خارج مؤسسة محدّدة على Google Workspace | |||||
| المستخدمون في مؤسسات Google Workspace | الملف الشخصي العلني | المشرف فقط | المشرفون | المستخدمون الذين ثبّت المشرف التطبيق لديهم | |
| جميع مستخدمي Google Workspace | علنية | التثبيت الفردي والتثبيت من قِبل المشرف |
|
|
|
تحديد كيفية دمج تطبيقك مع تطبيقات Google Workspace
اختَر خدمات Google Workspace التي تم تصميم تطبيقك أو إضافتك للعمل معها، مثل إضافة Google Workspace أو تطبيق Google Chat. يجب اختيار خيار واحد على الأقل. في بعض الحالات، يمكنك تضمين عمليات دمج تطبيقات متعددة في بطاقة بيانات تطبيقك. يُرجى الاطّلاع على إدراج عمليات دمج التطبيقات معًا.
استنادًا إلى عمليات دمج التطبيقات التي تختارها، قد تحتاج إلى تقديم المزيد من المعلومات وتفعيل واجهات برمجة التطبيقات ذات الصلة في مشروعك على Google Cloud. يوضّح الجدول التالي الإعدادات الإضافية اللازمة لكلّ منها:
إضافة Google Workspace (Apps Script)
لنشر إضافة Google Workspace، يجب تقديم رقم تعريف نشر الإضافة. للعثور على رقم تعريف النشر، اتّبِع الخطوات التالية:
- افتح إضافة Google Workspace في محرِّر "برمجة تطبيقات Google".
- انقر على نشر > إدارة عمليات النشر.
- ضمن رقم تعريف النشر، انقر على نسخ.
إضافة Google Workspace (عمليات النشر عبر بروتوكول HTTP)
إذا أنشأت إضافة Google Workspace باستخدام نقاط نهاية HTTP، اتّبِع الخطوات التالية للحصول على رقم تعريف النشر من مورد النشر في Google Cloud.
- في صفحة "إعدادات التطبيق" ضمن "إضافة Google Workspace"، انقر على HTTP أو عمليات النشر الأخرى > اختيار عملية النشر.
- اختَر عملية النشر التي تريد نشرها.
- انقر على اختيار.
إضافة المحرِّر ("مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google" و"نماذج Google")
لنشر إضافة "محرِّر"، عليك تقديم معرّف نص المشروع البرمجي والإصدار الذي تريد نشره.
للعثور على رقم تعريف نص المشروع، اتّبِع الخطوات التالية:
- افتح الإضافة في محرِّر Apps Script.
- على يمين الصفحة، انقر على إعدادات المشروع .
- ضمن "المعرّفات"، انسخ معرّف النص البرمجي.
للعثور على الإصدار، اتّبِع الخطوات التالية:
- افتح الإضافة في محرِّر Apps Script.
- في أعلى يسار الصفحة، انقر على نشر > إدارة عمليات النشر.
- يظهر رقم الإصدار ضمن "الإعداد".
تطبيق Google Chat
لنشر تطبيق Google Chat، عليك ضبط Google Chat API. اطّلِع على نشر تطبيقات Google Chat.
تطبيق Drive
لنشر تطبيق Drive، يجب تفعيل Google Drive API وضبطها.
تطبيق الويب
لنشر تطبيق ويب، عليك تقديم عنوان URL العام للتنقّل، وهو عنوان URL الذي يشير إلى تطبيق الويب من قائمة تطبيقات Google . يجب أن يكون تطبيق الويب في مرحلة الإصدار العلني وأن يعمل بشكل كامل.
عند ملء صفحة بطاقة بيانات المتجر، يجب تقديم رموز إضافية بحجم 96×96 و48×48 بكسل.
إذا أنشأت تطبيق الويب في "برمجة تطبيقات Google"، اتّبِع الخطوات التالية للحصول على عنوان URL للتنقّل العام:
- افتح إضافة Google Workspace في محرِّر Apps Script.
- انقر على نشر > عملية نشر جديدة.
- ضمن "اختيار النوع"، انقر على تطبيق ويب.
- املأ الخيارات وانقر على نشر.
- انقر على نسخ.
تحديد مستوى الوصول الذي يتطلّبه تطبيقك
ضمن نطاقات OAuth، قدِّم قائمة كاملة بنطاقات OAuth 2.0 التي يحتاجها تطبيقك. يجب أن تتطابق نطاقات OAuth التي تُدخلها هنا مع ما تعرِضه في شاشة موافقة OAuth وفي بيان Apps Script، إن أمكن.
في حال تضمين أكثر من عملية دمج واحدة للتطبيق، تأكَّد من إضافة النطاقات من كل نطاق إلى صفحة ضبط تطبيق SDK Marketplace وشاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
استخدِم دائمًا النطاقات الأضيق الممكنة (على سبيل المثال، لا تُدرِج نطاقًا كاملاً لتطبيق Drive إذا كنت بحاجة إلى نطاق للقراءة فقط).
بالنسبة إلى مشاريع "برمجة تطبيقات Google"، يُرجى الاطّلاع على نطاقات التفويض للحصول على مزيد من التفاصيل.
تقديم معلومات عن مطوّر التطبيق
ضمن معلومات المطوّر، أدخِل معلومات الاتصال والتفاصيل الأخرى. تظهر هذه الحقول على صفحة بطاقة بيانات المتجر لتطبيقك.
| الحقول | |
|---|---|
| حالة "التاجر" |
بموجب قوانين حماية المستهلك، يجب إبلاغ المستهلكين المقيمين في المنطقة الاقتصادية الأوروبية بما إذا كان التاجر في Google Workspace Marketplace تاجرًا أو غير تاجر:
إذا لم يتم تحديد حالة التاجر، ستظهر الرسالة "حالة التاجر غير محدّدة" في بطاقة بيانات المتجر الخاصة بتطبيقك. |
| اسم المطوِّر | الاسم الذي سيتم عرضه كمؤلف التطبيق. إذا كنت تاجرًا، أدخِل اسمك التجاري أو اسمك القانوني. |
| العنوان البريدي للمطوِّر |
مطلوبة للتجّار لا يتم جمع هذه البيانات عن غير التجّار. الموقع الجغرافي لنشاطك التجاري يُرجى إدخال عنوان بريدي صالح يمكن التواصل معك من خلاله. |
| عنوان URL للموقع الإلكتروني للمطوّر | الموقع الإلكتروني الذي يصف هويتك (أو هوية مؤسستك) كمطوّر |
| البريد الإلكتروني للمطوِّر |
عنوان البريد الإلكتروني المُستخدَم كجهة اتصال لم يتم تضمينه في بطاقة بيانات تطبيقك. يُرجى التأكّد من تعديل عنوان البريد الإلكتروني هذا باستمرار أثناء استخدامه:
|
| عنوان URL للموقع الإلكتروني للتطبيق | اختياريّ. الموقع الإلكتروني الذي يقدّم وصفًا إضافيًا لتطبيقك |
حفظ إعدادات ضبط تطبيقك في حزمة تطوير البرامج (SDK) في Marketplace
باستخدام المعلومات المستمَدة من القسم السابق، احفظ إعدادات تطبيقك في حزمة تطوير البرامج (SDK) للسوق:
في Google Cloud Console، انتقِل إلى صفحة Configuration (الإعداد) لحزمة تطوير البرامج (SDK) في Marketplace:
الانتقال إلى صفحة "ضبط حزمة تطوير البرامج (SDK) في Marketplace"
املأ كل قسم استنادًا إلى ما حدّدته في القسم السابق.
انقر على حفظ.
(اختياري) يمكنك الحصول على إحصاءات حول استخدام التطبيق في إحصاءات Google. لإجراء ذلك، أضِف رقم تعريف "إحصاءات Google" في حزمة تطوير البرامج (SDK) للسوق.
- الانتقال إلى علامة التبويب الإحصاءات
- أدخِل رقم تعريف "إحصاءات Google".
- انقر على حفظ.