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