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

توضّح هذه الصفحة كيفية استخدام حزمة تطوير البرامج (SDK) في Google Workspace Marketplace لإعداد تطبيقك وإدارته على Google Workspace Marketplace.

لإتاحة استخدام تطبيقك، عليك إعداده في حزمة تطوير البرامج (SDK) الخاصة بـ Marketplace. ‫Marketplace SDK هي مجموعة أدوات تتيح لك إنشاء تطبيقك والتحكّم فيه على Marketplace. يمكنك استخدام حزمة تطوير البرامج (SDK) في Marketplace لإدارة إعدادات Marketplace، مثل ما يلي:

• ما إذا كان تطبيقك متاحًا لمؤسسة Google Workspace معيّنة (تطبيق خاص) أو لجميع مستخدمي Marketplace (تطبيق عام)
• أنواع مستخدمي Marketplace الذين يمكنهم تثبيت تطبيقك
• تطبيقات Google Workspace التي يتكامل معها تطبيقك
• نطاقات OAuth التي يتطلّبها تطبيقك
• معلومات عن الجهة التي أنشأت التطبيق وتتولّى صيانته

بغض النظر عمّا إذا كنت ستنشر تطبيقك بشكل خاص أو عام، عليك استخدام حزمة تطوير البرامج (SDK) في Marketplace لإدارة تطبيقك على Marketplace.

تفعيل حزمة تطوير البرامج (SDK) في Marketplace

إذا لم يسبق لك إجراء ذلك، فعِّل Marketplace SDK في مشروعك على Google Cloud.

افتح مشروعك على السحابة الإلكترونية في Google Cloud Console

افتح مشروع على السحابة الإلكترونية الذي تريد استخدامه لهذا النموذج إذا لم يكن مفتوحًا من قبل:

1. في وحدة تحكّم Google Cloud، انتقِل إلى صفحة اختيار مشروع.

   اختيار مشروع على السحابة الإلكترونية

2. اختَر مشروع Google Cloud الذي تريد استخدامه. أو انقر على إنشاء مشروع واتّبِع التعليمات الظاهرة على الشاشة. في حال إنشاء مشروع على Google Cloud، قد تحتاج إلى تفعيل الفوترة للمشروع.

تفعيل حزمة تطوير البرامج (SDK) في Marketplace

• في 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 تثبيت تطبيقك من صفحة بطاقة بيانات المتجر على Marketplace.

• التثبيت الفردي والتثبيت من قِبل المشرف (الإعداد التلقائي): يمكن للمستخدمين الفرديين أو المشرفين تثبيت التطبيق على مستوى نطاقهم أو وحدتهم التنظيمية أو مجموعة من المستخدمين. قد تمنع سياسات نطاق المستخدم تثبيت تطبيق حتى إذا كان التثبيت الفردي مفعّلاً.
• التثبيت من المشرف فقط: لا يمكن تثبيت التطبيق إلا بواسطة المشرفين لنطاقهم أو وحدتهم التنظيمية أو مجموعة من المستخدمين. لا يظهر تطبيقك إلا في نتائج البحث على Google Workspace Marketplace للمشرفين والمستخدمين الذين لم يسجّلوا الدخول إلى حساباتهم على Google. حدِّد هذا الخيار إذا كان تطبيقك يتطلّب تثبيت النطاق.

إعدادات التثبيت ومستوى الظهور الشائعة

يلخّص الجدول التالي بعض خيارات إعدادات التطبيقات الشائعة المتعلّقة بالتثبيت وإمكانية الظهور:

تحديد كيفية دمج تطبيقك مع تطبيقات Google Workspace

يتيح لك الخيار عمليات دمج التطبيقات اختيار خدمات Google Workspace التي تم تصميم تطبيقك أو إضافتك للعمل معها، مثل إضافة Google Workspace أو تطبيق Google Chat. يجب اختيار خيار واحد على الأقل. في بعض الحالات، يمكنك تضمين عمليات دمج متعددة للتطبيقات في بطاقة بيانات تطبيقك. اطّلِع على إدراج عمليات دمج التطبيقات معًا.

بالنسبة إلى كل إضافة من إضافات Google Workspace، تعرض الصفحة حالة النشر لكل منتج مضيف متوافق معها. يساعدك ذلك في معرفة عمليات الدمج المتاحة للمستخدمين. في ما يلي حالات دمج التطبيقات المحتملة:

• Unsaved: لقد أضفت عملية دمج أو عدّلتها، ولكن لم تحفظ التغييرات في علامة التبويب "إعدادات التطبيق".
• Draft: تم حفظ تغييراتك ولكن لم يتم نشرها.
• Under review: أرسلت عملية دمج تطبيقك المعدَّلة للمراجعة.
• Published: يتم تضمين عملية دمج تطبيقك في بطاقة بيانات Marketplace.

بناءً على عمليات دمج التطبيقات التي تختارها، قد تحتاج إلى تقديم المزيد من المعلومات وتفعيل واجهات برمجة التطبيقات ذات الصلة في مشروعك على Google Cloud. يوضّح الجدول التالي الإعدادات الإضافية المطلوبة لكلّ نوع:

تحديد مستوى الوصول الذي يتطلّبه تطبيقك

ضمن نطاقات OAuth، قدِّم قائمة كاملة بنطاقات OAuth 2.0 التي يتطلّبها تطبيقك. يجب أن تتطابق نطاقات OAuth التي تُدخلها هنا مع ما تعرضه في شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth، وفي بيان برمجة تطبيقات إذا كان ذلك منطبقًا.

في حال تضمين أكثر من عملية دمج لتطبيق واحد، احرص على إضافة النطاقات من كل عملية إلى صفحة "إعدادات التطبيق" في حزمة تطوير البرامج (SDK) لسوق Marketplace وشاشة طلب الموافقة في OAuth.

استخدِم دائمًا أضيق النطاقات الممكنة (على سبيل المثال، لا تدرِج نطاق Drive كاملاً إذا كنت بحاجة إلى نطاق للقراءة فقط).

لمزيد من التفاصيل حول مشاريع "برمجة التطبيقات"، يُرجى الاطّلاع على نطاقات الأذونات.

تقديم معلومات عن مطوّر التطبيق

ضمن معلومات المطوّر، املأ معلومات الاتصال وتفاصيل أخرى. تظهر هذه الحقول في صفحة بطاقة بيانات المتجر الخاصة بتطبيقك.

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

باستخدام المعلومات الواردة في القسم السابق، احفظ إعدادات تطبيقك في حزمة تطوير البرامج (SDK) في Marketplace:

1. في Google Cloud Console، انتقِل إلى صفحة إعدادات التطبيق في حزمة تطوير البرامج (SDK) في Marketplace:

   الانتقال إلى صفحة إعداد حزمة تطوير البرامج (SDK) في Marketplace

2. املأ كل قسم استنادًا إلى ما حدّدته في القسم السابق.

3. انقر على حفظ المسودة.

4. (اختياري) يمكنك الحصول على إحصاءات حول استخدام التطبيق في إحصاءات Google. لإجراء ذلك، أضِف معرّفًا على "إحصاءات Google" في حزمة تطوير البرامج (SDK) في Marketplace.

   1. انتقِلوا إلى علامة التبويب الإحصاءات.
   2. أدخِل رقم تعريف "إحصاءات Google".
   3. انقر على حفظ.

تحديد المشاكل وحلّها

يوضّح هذا القسم المشاكل الشائعة التي قد تواجهك.

عدم توفّر الأذونات المطلوبة عند نشر التطبيقات في Marketplace

لا يمكنك نشر تطبيقات على Marketplace لأنّ محاولات إعداد التطبيق في صفحة "إعدادات التطبيق" ضمن حزمة تطوير البرامج (SDK) في Marketplace تتعذّر وتظهر رسالة الخطأ التالية:

You are missing at least one of the following required permissions: Project workspacemarketplace.appconfiguration.view / workspacemarketplace.appconfiguration.update

يحدث هذا الخطأ عند تفعيل واجهة برمجة التطبيقات Marketplace SDK وعند استخدام دور إدارة هوية الوصول (IAM) غير Editor أو Owner.

لحلّ الخطأ، نفِّذ أحد الحلول التالية:

• اطلب من مالك المشروع منح الدور roles/appmetadata.workspaceMarketplaceAppConfigurationAdmin للحساب الذي لا تتوفّر فيه الأذونات المطلوبة، وذلك للسماح له بضبط التطبيق وإدارته في Marketplace SDK.

• اطلب من مالك المشروع إضافة الأذونات الناقصة إلى دور مخصّص من خلال صفحة إدارة الهوية وإمكانية الوصول والمشرف > الأدوار في Google Cloud Console. بعد ذلك، امنح الدور المخصّص للحساب الذي تنقصه الأذونات.

• يمكن استخدام roles/editor أو roles/owner الأساسيَّين لنشر التطبيقات. ومع ذلك، تعتبر مستندات استخدام إدارة الهوية وإمكانية الوصول (IAM) بشكل آمن هذه الممارسة غير جيدة لأنّه لا يمكن بسهولة حصر إذن التعديل على موارد أخرى في المشروع.