توضِّح هذه الصفحة كيفية استخدام حزمة تطوير البرامج (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 إذا لم يسبق لك ذلك.
فتح مشروعك على Cloud في Google Cloud Console
افتح مشروع 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، يُرجى الاطّلاع على مستندات help Marketplace Admin help.
إعدادات ظهور التطبيقات
يظهر لك خيار مستوى رؤية التطبيق إذا كنت تستخدم حساب 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 في محرِّر Apps Script.
- انقر على نشر > إدارة عمليات النشر.
- ضمن رقم تعريف عملية النشر، انقر على نسخ.
إضافة Google Workspace (عمليات النشر عبر بروتوكول HTTP)
إذا أنشأت إضافة Google Workspace باستخدام نقاط نهاية HTTP، اتّبِع الخطوات التالية للحصول على معرّف النشر من مرجع نشر Google Cloud.
- في صفحة "إعدادات التطبيق" ضمن "إضافة Google Workspace"، انقر على HTTP أو عمليات النشر الأخرى > اختيار عملية النشر.
- اختَر عملية النشر التي تريد نشرها.
- انقر على اختيار.
إضافة المحرِّر ("مستندات Google" و"جداول بيانات 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 بكسل.
إذا أنشأت تطبيق الويب في Apps Script، اتّبِع الخطوات التالية للحصول على عنوان URL عالمي لشريط التنقّل:
- افتح إضافة Google Workspace في محرِّر Apps Script.
- انقر على نشر > عملية نشر جديدة.
- ضمن "اختيار النوع"، انقر على تطبيق ويب.
- املأ الخيارات وانقر على نشر.
- انقر على نسخ.
تحديد مستوى الوصول الذي يتطلّبه تطبيقك
ضمن نطاقات OAuth، قدِّم قائمة كاملة بنطاقات OAuth 2.0 التي يحتاجها تطبيقك. يجب أن تتطابق نطاقات OAuth التي تُدخلها هنا مع ما تعرِضه في شاشة موافقة OAuth وفي بيان Apps Script، إن أمكن.
إذا كنت تُدرِج أكثر من عملية دمج تطبيق واحدة، تأكَّد من إضافة النطاقات من كل عملية دمج إلى صفحة "إعدادات تطبيق حزمة تطوير البرامج (SDK) في Marketplace" وإلى شاشة موافقة بروتوكول OAuth.
استخدِم دائمًا النطاقات الأضيق الممكنة (على سبيل المثال، لا تُدرِج نطاقًا كاملاً لتطبيق Drive إذا كنت بحاجة إلى نطاق للقراءة فقط).
بالنسبة إلى مشاريع Apps Script، يُرجى الاطّلاع على نطاقات التفويض للحصول على مزيد من التفاصيل.
تقديم معلومات عن مطوّر التطبيق
ضمن معلومات المطوّر، أدخِل معلومات الاتصال والتفاصيل الأخرى. تظهر هذه الحقول في صفحة بطاقة بيانات المتجر الخاصة بتطبيقك.
| الحقول | |
|---|---|
| حالة التاجر |
بموجب قوانين حماية المستهلك، يجب إبلاغ المستهلكين المقيمين في المنطقة الاقتصادية الأوروبية بما إذا كان التاجر في Google Workspace Marketplace تاجرًا أو غير تاجر:
إذا لم يتم تحديد حالة التاجر، ستظهر الرسالة "حالة التاجر غير محدّدة" في صفحة بطاقة بيانات المتجر الخاصة بتطبيقك. |
| اسم المطوِّر | الاسم الذي سيتم عرضه كمؤلف التطبيق. إذا كنت تاجرًا، أدخِل اسمك التجاري أو اسمك القانوني. |
| العنوان البريدي للمطوِّر |
مطلوبة للتجّار لا يتم جمع هذه البيانات عن غير التجّار. الموقع الجغرافي لنشاطك التجاري أدخِل عنوانًا بريديًا صالحًا يمكن التواصل معك من خلاله. |
| عنوان URL للموقع الإلكتروني للمطوّر | الموقع الإلكتروني الذي يصف هويتك (أو هوية مؤسستك) كمطوّر |
| عنوان البريد الإلكتروني للمطوِّر |
عنوان البريد الإلكتروني المُستخدَم كجهة اتصال لم يتم تضمينها في بطاقة بيانات تطبيقك. يُرجى التأكّد من تعديل عنوان البريد الإلكتروني هذا باستمرار أثناء استخدامه:
|
| عنوان URL للموقع الإلكتروني للتطبيق | اختيارية: الموقع الإلكتروني الذي يقدّم وصفًا إضافيًا لتطبيقك |
حفظ إعدادات ضبط تطبيقك في حزمة تطوير البرامج (SDK) في Marketplace
باستخدام المعلومات الواردة في القسم السابق، احفظ إعدادات تطبيقك في حزمة SDK في Marketplace:
في Google Cloud Console، انتقِل إلى صفحة Configuration (الإعداد) لحزمة تطوير البرامج (SDK) في Marketplace:
الانتقال إلى صفحة "ضبط حزمة تطوير البرامج (SDK) في Marketplace"
املأ كل قسم استنادًا إلى ما حدّدته في القسم السابق.
انقر على حفظ.
(اختياري) يمكنك الحصول على إحصاءات عن استخدام التطبيق في إحصاءات Google. ولإجراء ذلك، أضِف معرّف "إحصاءات Google" في حزمة تطوير البرامج (SDK) لسوق التطبيقات.
- الانتقال إلى علامة التبويب الإحصاءات
- أدخِل رقم تعريفك على "إحصاءات Google".
- انقر على حفظ.