اضبط تطبيقك في حزمة تطوير البرامج (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

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

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

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

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 Cloud. يوضّح الجدول التالي الإعدادات الإضافية المطلوبة لكلّ نوع:

إضافة Google Workspace

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

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

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

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

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

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

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

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

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

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

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

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

تطبيق Google Chat

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

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

تطبيق Drive

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

تطبيق الويب

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

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

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

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

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

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

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

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

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

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

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

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

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