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

توضّح هذه الصفحة كيفية استخدام حزمة تطوير البرامج (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

إذا لم يسبق لك فعل ذلك، في مشروعك على Google Cloud تفعيل حزمة تطوير البرامج (SDK) في Google Workspace Marketplace:

1. افتح وحدة تحكُّم Google Cloud.
2. في أعلى الصفحة، انقر على اختيار مشروع. في حال كان هناك مشروع آخر على Google Cloud مفتوح حاليًا، انقر على اسم المشروع على Google Cloud للتبديل المشاريع على السحابة الإلكترونية.
3. اختَر مشروع Google Cloud لتطبيقك وانقر على فتح.
4. في شريط البحث أعلى الشاشة، اكتب Google Workspace Marketplace SDK واضغط على مفتاح Enter.

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

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

6. في حال لم تكن حزمة تطوير البرامج (SDK) في Google Workspace Marketplace مفعَّلة، انقر على تفعيل.

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

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

اختيار المستخدمين الذين يمكنهم الاطّلاع على تطبيقك وتثبيته

عند إعداد تطبيقك، يمكنك تحديد المستخدمين الذين يمكنهم الوصول إليه. باستخدام الإعدادات التالية:

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

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

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

للتعرّف على كيفية إدارة المشرفين لأذونات الوصول إلى Marketplace، راجع مستندات المساعدة الخاصة بمشرفي Marketplace

إعدادات ظهور التطبيقات

تحذير: بعد تحديد خيار مستوى العرض وحفظ إعدادات التطبيق لا يمكنك تغيير اختيارك لاحقًا.

سيظهر لك خيار مستوى رؤية التطبيق إذا كنت تستخدم Google Workspace. حساب (حساب تنشئه مؤسستك التعليمية أو عملك). إذا كنت باستخدام حساب المستهلك (حساب ينتهي بـ " @gmail.com")، يمكنك فقط وأن يتم نشرها علنًا.

• عام: يمكن لأي مستخدم من خارج نطاق مؤسستك العثور على التطبيق وتثبيته. مجالك. إذا اخترت ظهور التطبيق للجميع، تراجع Google تطبيقك وتوافق عليه. من البيانات قبل أن يتم نشرها.
• خاص: يمكن فقط للأشخاص داخل نطاقك العثور على تطبيقك وتثبيته.

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

إذا أردت تحديد البُلدان والمناطق التي يتوفّر فيها تطبيقك، ويمكنك إعداد هذه الطريقة في القسم التوزيع عند إنشاء بطاقة بيانات المتجر

إعدادات تثبيت التطبيقات

تحدِّد إعدادات التثبيت ما إذا كان يمكن للمستخدمين أو مشرفي Workspace تثبيت التطبيق. تطبيقك من صفحة بطاقة بيانات المتجر على Google Workspace Marketplace.

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

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

إضافة Google Workspace (عمليات نشر HTTP)

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

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

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

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

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

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

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

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

تطبيق Google Chat

لنشر تطبيق Google Chat، عليك إعداد Google Chat API. عرض النشر التطبيقات.

تطبيق Drive

لنشر أحد تطبيقات Drive، يجب تفعيل إعداد Drive API:

تطبيق الويب

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

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

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

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

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

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

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

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

بالنسبة إلى مشاريع "برمجة تطبيقات Google"، يُرجى الاطّلاع على النطاقات لمزيد من التفاصيل.

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

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

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

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

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

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