اضبط تطبيقك في حزمة تطوير البرامج (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 Console، انتقِل إلى صفحة اختيار مشروع.

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

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

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

قبل استخدام واجهات Google APIs، عليك تفعيلها في مشروع على Google Cloud. يمكنك تفعيل واجهة برمجة تطبيق واحدة أو أكثر في مشروع واحد على Google Cloud.

• في Google Cloud Console، فعِّل حزمة تطوير البرامج (SDK) في Google Workspace Marketplace.

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

تحذير: تأكَّد من تفعيل حزمة تطوير البرامج (SDK) في Google Workspace Marketplace، وليس واجهة برمجة التطبيقات. ‫Google Workspace Marketplace API هي أداة مختلفة تُستخدَم للدمج مع خدمات الترخيص والفوترة من Google.

تحديد إعدادات الضبط لتطبيقك

يوضّح المرجع التالي الإعدادات المتوفّرة في صفحة إعدادات التطبيق في حزمة تطوير البرامج (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 Chat، يمكنك اختيار التثبيت الفردي + تثبيت المشرف فقط، لأنّه يمكن للمستخدمين العثور على تطبيقات Chat وتثبيتها مباشرةً من Google Chat. للحصول على تفاصيل حول طريقة التثبيت، يُرجى الاطّلاع على كيفية عثور المستخدمين على تطبيقات Chat واستخدامها.

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

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

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

مستخدمو التطبيق المقصودون	إعدادات ظهور التطبيق	إعدادات تثبيت التطبيقات	مَن يمكنه تثبيت تطبيقي؟	مَن يمكنه استخدام تطبيقي؟
بالنسبة إلى التطبيقات المصمّمة لمؤسسة Google Workspace
مستخدمون محدَّدون في مؤسستك	خاص وغير مُدرَج	التثبيت الفردي والتثبيت من قِبل المشرف	إذا كان ذلك مسموحًا به، يمكن لأي مستخدم في مؤسستك لديه عنوان URL لبطاقة بيانات التطبيق.	إذا كان ذلك مسموحًا به، يمكن لأي مستخدم في مؤسستك لديه عنوان URL لبطاقة بيانات التطبيق.
مؤسستك	خاص	التثبيت الفردي والتثبيت من قِبل المشرف	إذا كان مسموحًا بذلك، يمكن لأي مستخدم في مؤسستك.	إذا كان مسموحًا بذلك، يمكن لأي مستخدم في مؤسستك.
مؤسستك	خاص	المشرف فقط	المشرفون	المستخدمون الذين ثبّت المشرف التطبيق على أجهزتهم
بالنسبة إلى التطبيقات المتاحة للمستخدمين خارج مؤسسة Google Workspace معيّنة
المستخدمون في مؤسسات Google Workspace	عام	المشرف فقط	المشرفون	المستخدمون الذين ثبّت المشرف التطبيق على أجهزتهم
جميع مستخدمي Google Workspace	عام	التثبيت الفردي والتثبيت من قِبل المشرف	أي شخص يستخدم تطبيقات Google Workspace للاستخدام الشخصي إذا كان ذلك مسموحًا به، يمكن للمستخدمين في مؤسسات Google Workspace.	أي شخص يستخدم تطبيقات Google Workspace للاستخدام الشخصي إذا كان ذلك مسموحًا به، يمكن للمستخدمين في مؤسسات Google Workspace.

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

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

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

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

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

إضافة Google Workspace

لنشر إضافة Google Workspace، يجب تقديم معرّف نشر الإضافة.

للعثور على رقم تعريف عملية النشر في برمجة تطبيقات، اتّبِع الخطوات التالية:

1. افتح إضافة Google Workspace في محرّر برمجة تطبيقات.
2. انقر على نشر > إدارة عمليات النشر.
3. ضمن معرّف النشر، انقر على نسخ.

للعثور على رقم تعريف النشر لإضافة HTTP، اتّبِع الخطوات التالية:

1. في صفحة "إعداد التطبيق" ضِمن "إضافة Google Workspace"، انقر على عمليات نشر HTTP أو عمليات نشر أخرى > اختيار عملية نشر.
2. اختَر عملية النشر التي تريد نشرها.
3. انقر على اختيار.

ملاحظة: إذا كانت الإضافة توسّع نطاق Google Chat، عليك أيضًا ضبط Google Chat API. للاطّلاع على الخطوات، يُرجى الانتقال إلى ضبط Chat API.

إضافة المحرّر (مستندات Google وجداول بيانات Google والعروض التقديمية من Google ونماذج Google)

لنشر إضافة في "محرّر Google"، يجب تقديم معرّف نص المشروع البرمجي والإصدار الذي تريد نشره.

للعثور على رقم تعريف نص برمجي للمشروع، اتّبِع الخطوات التالية:

1. افتح الإضافة في محرِّر برمجة تطبيقات.
2. على يمين الصفحة، انقر على إعدادات المشروع .
3. ضِمن "مستندات التعريف"، انسخ معرّف النص البرمجي.

للعثور على الإصدار، اتّبِع الخطوات التالية:

1. افتح الإضافة في محرِّر برمجة تطبيقات.
2. في أعلى يسار الصفحة، انقر على نشر > إدارة عمليات النشر.
3. يظهر رقم الإصدار ضمن "الإعدادات".

تطبيق Google Chat

لنشر تطبيق تفاعلي على Google Chat، اطّلِع على المستندات التالية:

• لضبط تطبيق Chat في واجهة برمجة تطبيقات Chat، يُرجى الاطّلاع على ضبط واجهة برمجة تطبيقات Chat.
• إذا أنشأت تطبيقًا في Chat لا يمثّل إضافة في Google Workspace، عليك ضبط إعدادات أحداث التفاعل في Chat API. لمعرفة الخطوات، يُرجى الاطّلاع على مقالة تلقّي تفاعلات المستخدمين والردّ عليها.
• إذا أنشأت تطبيق Chat باستخدام الإعداد التلقائي في AppSheet، يمكنك نشر تطبيق Chat باتّباع الخطوات الموضّحة في مستندات AppSheet، وتحديدًا مشاركة تطبيق Chat باستخدام الإعداد التلقائي.

تطبيق Drive

لنشر تطبيق على Drive، عليك تفعيل Google Drive API وإعداده.

تطبيق الويب

لنشر تطبيق ويب، يجب تقديم عنوان URL الخاص بشريط التنقّل العام، وهو عنوان URL الذي يشير إلى تطبيق الويب من قائمة تطبيقات Google . يجب أن يكون تطبيق الويب في مرحلة الإنتاج ويعمل بشكل كامل.

عند ملء صفحة "بطاقة بيانات المتجر"، يجب تقديم رموز إضافية بحجم 96×96 و48×48 بكسل.

إذا أنشأت تطبيق الويب في "برمجة تطبيقات Google"، اتّبِع الخطوات التالية للحصول على عنوان URL الخاص بشريط التنقّل الشامل:

1. افتح إضافة Google Workspace في محرّر برمجة تطبيقات.
2. انقر على نشر > عملية نشر جديدة.
3. ضِمن "اختيار النوع"، انقر على تطبيق ويب.
4. املأ الخيارات وانقر على نشر.
5. انقر على نسخ.

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

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

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

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

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

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

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

الحقول
حالة التاجر	وفقًا لقوانين حماية المستهلك، يجب إبلاغ المستهلكين في المنطقة الاقتصادية الأوروبية بما إذا كان البائع في السوق جهة تجارية أو جهة غير تجارية: الجهة التجارية: الجهة التجارية هي الشخص الذي يعمل لأغراض تتعلّق بالتجارة أو النشاط التجاري أو الحرفة أو المهنة، أو بالنيابة عن جهة تجارية. جهة غير تجارية: الجهة غير التجارية (المستهلك) هي شخص يعمل لأغراض غير مهنية. إذا لم يتم تحديد الحالة، ستظهر عبارة "حالة التاجر غير محدّدة" في صفحة بطاقة بيانات المتجر الخاصة بتطبيقك.
اسم المطوِّر	الاسم الذي سيتم عرضه كمؤلف التطبيق. إذا كنت تاجرًا، يُرجى تقديم اسمك التجاري أو اسمك القانوني.
العنوان البريدي للمطوِّر	هذه السمة مطلوبة للتجّار. لا يتم جمعها للجهات غير التجارية. تمثّل هذه السمة الموقع الجغرافي لنشاطك التجاري. أدخِل عنوانًا بريديًا صالحًا يمكن التواصل معك من خلاله.
عنوان URL للموقع الإلكتروني الخاص بالمطوّر	الموقع الإلكتروني الذي يصفك (أو مؤسستك) بصفتك المطوِّر
البريد الإلكتروني للمطوِّر	عنوان البريد الإلكتروني الذي سيتم استخدامه للتواصل ولا يتم تضمينها في بطاقة بيانات تطبيقك على المتجر. يُرجى التأكّد من تعديل عنوان البريد الإلكتروني هذا باستمرار لأنّه يُستخدم في ما يلي: إذا احتاجت Google إلى التواصل مع المطوّر، مثلاً أثناء عملية مراجعة التطبيق لإرسال ملاحظات من إضافات "محرّر Google" في حال عدم توفّر عنوان URL للإبلاغ عن مشكلة في صفحة "بطاقة بيانات المتجر"
عنوان URL للموقع الإلكتروني الخاص بالتطبيق	اختيارية: الموقع الإلكتروني الذي يقدّم وصفًا إضافيًا لتطبيقك

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

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

1. في Google Cloud Console، انتقِل إلى صفحة إعدادات التطبيق في Marketplace SDK:

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

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

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

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

   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) بأمان هذه الممارسة غير جيدة لأنّه لا يمكن بسهولة حصر إذن التعديل على موارد أخرى في المشروع.