إعداد "خدمات ألعاب Google Play"

توضّح هذه الصفحة كيفية إعداد "خدمات ألعاب Google Play" للعبة Android باستخدام Google Play Console. توفّر لك Play Console مكانًا مركزيًا لإدارة خدمات الألعاب وضبط البيانات الوصفية المستخدَمة لمصادقة لعبتك واعتمادها.

لإضافة لعبتك إلى Play Console، يُرجى اتّباع الخطوات العامة التالية:

• أنشِئ مشروعًا للعبتك وحدِّد تفاصيل مثل اسم اللعبة ووصفها.

• أنشئ واربط بيانات الاعتماد اللازمة لتفويض لعبتك والمصادقة عليها في "خدمات ألعاب Google Play".

قبل البدء

• يجب أن يكون لديك حساب مطوّر على Google Play تم إعداده في Play Console. لمزيد من المعلومات، يُرجى الاطّلاع على التسجيل في حساب مطوّر برامج Google Play.

• منح إذن التعديل: لتعديل إعدادات "خدمات ألعاب Play" في Play Console، يجب أن يكون لدى فريقك أذونات لإدارة "خدمات ألعاب Play". لمزيد من المعلومات، يُرجى الاطّلاع على إضافة مستخدمي حساب المطوّر وإدارة الأذونات.

تسجيل الدخول إلى Play Console

لتسجيل الدخول، انتقِل إلى Google Play Console. إذا لم يسبق لك التسجيل في Play Console، سيُطلب منك إجراء ذلك.

إضافة لعبتك إلى Play Console

لإضافة لعبتك، يمكنك اتّباع الخطوات التالية:

1. في Play Console، أنشِئ تطبيقًا وحدِّد أنه لعبة. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على إنشاء تطبيقك وإعداده.

2. انتقِل إلى Grow (نمو) > خدمات ألعاب Play > الإعداد والإدارة > الضبط.

3. حدِّد ما إذا كانت لعبتك تستخدم واجهات Google APIs مثل Firebase. من المهم تحديد الخيار الصحيح، وإلا فقد تواجه لعبتك مشاكل عند استخدام Google APIs. إليك الخيارات المتاحة:

   • لا، لعبتي لا تستخدم Google APIs: إذا كنت بصدد إنشاء لعبة جديدة، أو لم يسبق لك إعداد Google API لها، حدِّد هذا الخيار. أدخِل اسم اللعبة ثم انقر على إنشاء.

   • نعم، لعبتي تستخدم Google APIs: حدّد هذا الخيار إذا سبق لك إعداد Google API للعبة. إذا كان الأمر كذلك، ستظهر لك قائمة بمشروعاتك من Google Cloud Console. اختَر مشروعك من القائمة ثم انقر على Use (استخدام).

   • استخدام مشروع حالي على "خدمات ألعاب Play": إذا أردت استخدام مشروع حالي على "خدمات ألعاب Play"، حدِّد هذا الخيار. ستظهر لك قائمة بالمشاريع الحالية في "خدمات ألعاب Play" ضمن حسابك. اختَر مشروع لعبتك من القائمة ثم انقر على استخدام. وهذا ليس خيارًا نموذجيًا، ولكن يمكنك تنفيذه إذا كنت تنشئ لعبة جديدة في Play Console من أجل تغيير اسم الحزمة، أو إذا كانت لديك إصدارات مجانية ومدفوعة من لعبتك بأسماء حِزم مختلفة.

   يتم إنشاء مشروع اللعبة على "خدمات ألعاب Play" وإنشاء إدخال مناسب لك في Google Cloud Console.

4. في قسم الخصائص، انقر على تعديل الخصائص لإضافة معلومات، مثل الوصف والفئة وأصول الرسومات للعبتك. وفي ما يلي بعض الإرشادات لتنظيم المواقع الإلكترونية:

   • يكون الاسم المعروض فقط مطلوبًا للاختبار. يجب ملء الحقول الأخرى قبل أن تتمكّن من نشر لعبتك.

   • يجب أن يتطابق الاسم المعروض ووصف اللعبة مع الاسم الذي أعددته في بطاقة بيانات اللعبة على "متجر Play".

   • للحصول على إرشادات عن إنشاء أصول الرسومات، راجع إضافة مواد عرض للمعاينة لعرض تطبيقك وإرشادات الصور المميزة في Google Play.

إنشاء معرِّف عميل OAuth 2.0

يجب أن تتضمن لعبتك معرِّف عميل OAuth 2.0 حتى تتم مصادقتها ويُسمح لها بالاتصال بخدمات ألعاب Google Play. لإعداد بيانات اعتماد لـ "خدمات ألعاب Play"، وهي عملية ربط بين معرِّف العميل ولعبتك، استخدِم Google Cloud Platform لإنشاء معرِّف العميل. بعد ذلك، يمكنك استخدام Google Play Console لإضافة بيانات اعتماد وربط معرِّف العميل باللعبة.

للحصول على تعليمات أكثر تفصيلاً، يُرجى الاطّلاع على الخطوات التالية:

ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

وإذا لم تكن قد ضبطت شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth بعد، سيعرض قسم بيانات الاعتماد رسالة تطلب منك ضبطها.

انقر على ضبط. يؤدي ذلك إلى فتح مربّع حوار يحتوي على مزيد من التعليمات ورابط لصفحة في Google Cloud Platform.

احرص على أن تكون شاشة طلب الموافقة متاحة لكل من تتوفّر له اللعبة. يجب أن تشمل القائمة النهائية للنطاقات games وgames_lite وdrive.appdata، فلن تتطلب أي من هذه النطاقات التحقق من التطبيقات. ننصحك بنشر شاشة طلب الموافقة على الفور. وإذا لم يكن ذلك ممكنًا، يمكنك إتاحة شاشة طلب الموافقة للمختبِرين للسماح لهم بتسجيل الدخول إلى اللعبة.

إذا كنت قد أكملت إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth، انقر على تم. يتم تحديث Google Play Console تلقائيًا، وإذا تمت عملية الضبط بنجاح، ستتمكّن من إنشاء بيانات اعتماد:

إنشاء بيانات اعتماد

للسماح للعبتك بالاتصال بـ "خدمات ألعاب Google Play"، يجب إنشاء بيانات اعتماد بمعرِّف عميل OAuth2 معتمد.

في قسم بيانات الاعتماد، انقر على إضافة بيانات الاعتماد.

في المعالج، اختَر ما إذا كنت تريد إنشاء بيانات اعتماد Android (إذا كان ملف APK الخاص باللعبة سيصادق على المستخدم ويستخدم واجهات برمجة التطبيقات لخدمات ألعاب Play) أو بيانات اعتماد خادم ألعاب (إذا كان خادم اللعبة سيستخدم واجهات برمجة التطبيقات لخدمات ألعاب Play). اتّبِع التعليمات الخاصة بنوع بيانات الاعتماد المطلوب.

Android

إعداد تفاصيل بيانات الاعتماد

تأكَّد من أنّ الاسم في حقل الاسم يتطابق مع اسم لعبتك. اختَر ما إذا كنت تريد تفعيل مكافحة القرصنة.

إعداد التفويض

بعد ذلك، اختَر معرّف عميل OAuth لاستخدامه في مشروع اللعبة هذا. إذا كان لديك معرِّفات عملاء OAuth2، يمكنك اختيار معرِّف. ومع ذلك، ستقوم عادةً بإنشاء قائمة جديدة. انقر على إنشاء عميل OAuth. يؤدي ذلك إلى فتح مربّع حوار يتضمّن روابط لصفحات في التطبيق وتعليمات حول إنشاء معرِّف عميل OAuth في Google Cloud Platform.

1. اختر Android كنوع التطبيق.
2. أدخِل اسم اللعبة في الحقل الاسم.
3. أدخِل اسم حزمة تطبيق Android في حقل اسم الحزمة.

4. افتح وحدة طرفية وشغِّل أداة الأداة Keytool للحصول على الملفات المرجعية لشهادة SHA1 الخاصة بإصدار الشهادات وتصحيح الأخطاء.

   للحصول على الملف المرجعي لشهادة الإصدار، شغِّل الأمر التالي:

   keytool -list -keystore <path-to-production-keystore> -v

   للحصول على الملف المرجعي لشهادة تصحيح الأخطاء، شغِّل الأمر التالي:

   keytool -list -keystore <path-to-debug-keystore> -v

   ملاحظة: في نظام التشغيل Windows، يمكنك العثور على ملف تخزين مفاتيح تصحيح الأخطاء في C:\Users\<USERNAME>\.android\debug.keystore. في نظام التشغيل Mac أو Linux، يكون عادةً ملف تصحيح الأخطاء في ~/.android/debug.keystore.

5. تطالبك أداة Keytool بإدخال كلمة مرور لملف تخزين المفاتيح. كلمة المرور التلقائية لملف تخزين مفاتيح تصحيح الأخطاء هي android. تطبع أداة المفاتيح بعد ذلك بصمة الإصبع إلى المحطة.

6. ألصق الملف المرجعي لشهادة SHA1 في حقل الملف المرجعي لشهادة التوقيع (SHA1).

7. انقر على إنشاء.

لمزيد من المعلومات عن بروتوكول OAuth 2.0 على Android، يُرجى الاطّلاع على المصادقة على خدمات OAuth2.

تحذير: احرِص على تسجيل اسم الحزمة وشهادة التوقيع التي ضبطتها في هذه الخطوة. سيؤدي استخدام شهادة أو اسم حزمة مختلف في تطبيقك إلى تعذُّر المصادقة.

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

قد تحتاج إلى إنشاء اثنين من بيانات الاعتماد: واحدة بالالملف المرجعي لشهادة الإصدار، والأخرى تتضمن الملف المرجعي لشهادة تصحيح الأخطاء. تأكد من استخدام نفس اسم الحزمة لكليهما. يسمح ذلك لـ "خدمات ألعاب Google Play" بالتعرّف على المكالمات من حِزم APK المرتبطة والموقَّعة بأي من الشهادتَين. لمزيد من المعلومات حول توقيع الشهادة لنظام Android، راجع توقيع تطبيقك.

خادم اللعبة

إعداد تفاصيل بيانات الاعتماد

تأكَّد من أنّ الاسم في حقل الاسم يتطابق مع اسم لعبتك.

إعداد التفويض

بعد ذلك، اختَر معرّف عميل OAuth لاستخدامه في مشروع اللعبة هذا. إذا كان لديك معرِّفات عملاء OAuth2، يمكنك اختيار معرِّف. ومع ذلك، ستقوم عادةً بإنشاء قائمة جديدة. انقر على إنشاء عميل OAuth. يؤدي ذلك إلى فتح مربّع حوار يتضمّن روابط لصفحات في التطبيق وتعليمات حول إنشاء معرِّف عميل OAuth في Google Cloud Platform.

1. اختَر تطبيق الويب كنوع التطبيق.
2. أدخِل اسم اللعبة في الحقل الاسم.
3. انقر على إنشاء.

لمزيد من المعلومات عن بروتوكول OAuth 2.0 على Android، يُرجى الاطّلاع على المصادقة على خدمات OAuth2.

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

تفعيل الاختبار

للتأكّد من عمل "خدمات ألعاب Google Play" بشكلٍ صحيح في لعبتك، يجب اختبار خدمات الألعاب قبل نشر تغييرات لعبتك على Google Play.

إذا كانت لعبتك غير منشورة، يمكنك منح المختبِرين إذن الوصول من خلال إضافة حسابات المستخدمين إلى القائمة المسموح بها. وبخلاف ذلك، سيواجه المختبِرون أخطاء OAuth و404 عند محاولة الوصول إلى نقاط النهاية في "خدمات ألعاب Play"، مثل نقطة نهاية تسجيل الدخول.

سيتمكّن المستخدمون الذين لديهم حسابات اختبار مُعتمَدة من الوصول إلى مشروع اللعبة غير المنشور على "خدمات ألعاب Play" ويمكنهم اختبار عمل "خدمات ألعاب Play" التي تم ضبطها بشكلٍ صحيح.

ملاحظة مهمة: لا تنسَ إضافة نفسك كمختبِر، وإلا لن تعمل حزمة تطوير البرامج (SDK) لألعاب Play مع حساب المستخدم الخاص بك.

هناك طريقتان لتمكين المختبِرين من استخدام واجهات برمجة التطبيقات لخدمات ألعاب Play على لعبتك:

• على المستوى الفردي، يمكنك إضافة عناوين بريد إلكتروني فردية.

• على مستوى المجموعة، من خلال تفعيل "خدمات ألعاب Play" لقناة إصدار Play Console

لإضافة مختبِرين فرديين إلى مشروع لعبتك:

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

لمنح مجموعة تجريبية من إذن الوصول للاختبار، يجب تفعيل قناة الإصدار المحدود للوصول إلى "خدمات ألعاب Play":

يسهّل Google Play توزيع الإصدارات التجريبية من تطبيقك على المجموعات الخاضعة للرقابة من المستخدمين الموثوق بهم بفضل ميزات قناة الإصدار. يمكنك الاطّلاع على إعداد اختبار مفتوح أو مغلق أو داخلي على موقع مساعدة Google Play الإلكتروني.

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

1. افتح قسم مختبِرو "خدمات ألعاب Play" (النمو > خدمات ألعاب Play > الإعداد والإدارة > المختبرين) واختر علامة التبويب مسارات الإصدار. في هذه الصفحة، يمكنك أيضًا الاطّلاع على قائمة المسارات التي سبق تفعيلها لاختبار "خدمات ألعاب Play".
2. انقر على إضافة أغانٍ.
3. اختَر مسار اختبار واحد أو أكثر لتفعيله في اختبار "خدمات ألعاب Play".
4. انقر على إضافة مقاطع صوتية.

ستظهر الآن مسارات الإصدار التي تم اختيارها في قائمة المسارات المفعّلة لاختبار "خدمات ألعاب Play".

لا تتوفّر هذه الميزة إلا إذا كان لديك تطبيق Android مرتبط بلعبتك في Google Play Console.

تجنُّب المشاكل الشائعة

لتجنُّب أخطاء الإعداد الشائعة، احرص على اتّباع هذه الاقتراحات عند إعداد لعبتك لاستخدام "خدمات ألعاب Google Play".

1. إعداد لعبتك باستخدام Play Console

إذا أنشأت معرِّف عميل Oauth 2.0 لتطبيقك في Google Cloud Console، لن تعرف "خدمات ألعاب Google Play" بالعلاقة بين إنجاز اللعبة ولوحات الصدارة ومعرِّف العميل. لإجراء عملية الربط هذه، يجب إنشاء بيانات اعتماد باستخدام معرِّف عميل Oauth 2.0 كما هو موضّح في إنشاء بيانات اعتماد.

2. استخدام معرّف التطبيق الصحيح في Android

معرِّف التطبيق هو مورد سلسلة مطلوب يجب الرجوع إليه في بيان Android. تتألف سلسلة معرّف التطبيق فقط من الأرقام (عادةً 12 رقمًا أو أكثر) في بداية معرّف العميل الذي توفّره Play Console. يمكن العثور على رقم تعريف التطبيق في أعلى صفحة الإعداد وهو مصنّف على أنّه رقم تعريف المشروع أسفل اسم لعبتك.

3. وقِّع ملف APK باستخدام الشهادة الصحيحة

عند ربط تطبيق Android بلعبتك في Play Console، يجب استخدام اسم الحزمة والملف المرجعي للشهادة نفسيهما اللذَين استخدمتهما لنشر تطبيقك. وفي حال عدم التطابق، لن تنجح المكالمات التي يتم إرسالها إلى "خدمات ألعاب Google Play". يجب إنشاء معرّفَي عميل، أحدهما يتضمّن الملف المرجعي لشهادة الإصدار والآخر يتضمّن الملف المرجعي لشهادة تصحيح الأخطاء، ويستخدم اسم الحزمة نفسه لكل منهما. لمعرفة المزيد من المعلومات حول طريقة تحديد شهادة التوقيع في Play Console، يمكنك مراجعة توقيع تطبيقاتك.

4. عند تطوير البرامج لنظام التشغيل Android، ننصحك بتضمين حزمة تطوير البرامج (SDK) الخاصة بألعاب Play كمشروع مكتبة وليس كمشروع JAR مستقل.

احرص على الإشارة إلى حزمة SDK لخدمات Google Play كمشروع مكتبة في مشروع Android، وإلا فقد يؤدي ذلك إلى حدوث أخطاء عندما يتعذّر على تطبيقك العثور على موارد خدمات Google Play. للتعرّف على كيفية إعداد مشروع Android لاستخدام "خدمات Google Play"، راجِع إعداد "خدمات Google Play".

5. تسجيل الدخول باستخدام حساب مختبِر أثناء التطوير

إذا لم تنشر التغييرات على إعدادات اللعبة في Play Console، قد تحدث أخطاء أثناء الاختبار إذا لم تسجّل الدخول باستخدام حساب مختبِر في القائمة البيضاء. يجب دائمًا تفعيل حساب الناشر على Play Console لأغراض الاختبار. لمعرفة كيفية إدارة حسابات المختبِرين، يُرجى الاطّلاع على تفعيل الحسابات للاختبار.

‫6. نشر شاشة طلب الموافقة في Google Cloud Platform

قبل نشر التطبيق في Play Console، انشر شاشة طلب الموافقة في Google Cloud Platform. وبدون هذه الخطوة، لن يتمكن الجمهور العام من استخدام أي من ميزات "خدمات ألعاب Play".

7. في إصدار التطبيق، يجب نشر إعدادات "خدمات ألعاب Play" أولاً قبل نشر لعبتك.

قد ينشر المطوّرون تطبيقاتهم عن طريق الخطأ بدون نشر الإعدادات المقابلة في "خدمات ألعاب Play" لتطبيقهم. وقد يؤدي ذلك إلى ظهور أخطاء للّاعبين الذين يسجّلون الدخول باستخدام حسابات غير تابعة للمختبِرين لأنّ التطبيق لا يمكنه الرجوع إلى إعدادات اللعبة الصحيحة. عند إصدار لعبتك، لا تنسَ نشر إعدادات اللعبة أولاً باستخدام الخيار نشر اللعبة في Play Console. لمعرفة كيفية نشر تغييراتك، راجع مقالة نشر تغييرات لعبتك.

للحصول على نصائح إضافية، يُرجى الاطّلاع على دليل تحديد المشاكل في أجهزة Android وحلّها.

الخطوات التالية

بعد إكمال مهام الإعداد الأولية الموضّحة أعلاه، يمكنك تفعيل ميزات "خدمات ألعاب Play" للعبتك، مثل الألعاب المحفوظة ولوحات الصدارة والإنجازات.