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

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

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

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

  • يمكنك إنشاء بيانات الاعتماد اللازمة وربطها باعتماد لعبتك ومصادقتها على "خدمات ألعاب Google 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 API: حدّد هذا الخيار إذا سبق لك إعداد Google API للعبة. في هذه الحالة، ستظهر لك قائمة بمشاريعك من Google Cloud Console. اختَر مشروعك من القائمة، ثم انقر على استخدام.

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

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

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

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

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

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

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

إشعار لضبط شاشة موافقة OAuth

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

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

تأكّد من أن شاشة الموافقة متاحة للجميع التي تتوفّر لها اللعبة. يجب أن تتضمّن القائمة النهائية للنطاقات 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. افتَح وحدة طرفية وشغِّل أداة الأدوات الأساسية للحصول على الملفات المرجعية لشهادة SHA1 لإصدار الشهادات وتصحيح الأخطاء.

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

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

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

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

  5. تطلب منك الأداة الأساسية لإدخال كلمة مرور ملف تخزين المفاتيح. تكون كلمة المرور التلقائية لتخزين مفاتيح التشفير هي android. بعدها، تتم طباعة بصمة الإصبع

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

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

لمزيد من المعلومات حول OAuth 2.0 على نظام التشغيل Android، يُرجى الاطِّلاع على المصادقة على خدمات OAuth2.

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

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

خادم اللعبة

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

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

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

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

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

لمزيد من المعلومات حول OAuth 2.0 على نظام التشغيل Android، يُرجى الاطِّلاع على المصادقة على خدمات OAuth2.

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

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

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

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

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

تتوفّر طريقتان تتيح للمختبرين استخدام واجهات برمجة التطبيقات لخدمات "ألعاب Play" في لعبتك:

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

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

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

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

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

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

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

  1. افتح قسم مختبرو خدمات ألعاب Play (Grow > خدمات ألعاب 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" للعبتك، مثل الألعاب المحفوظة ولوحات الصدارة والإنجازات.