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

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

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

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

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

قبل البدء

أكمِل الخطوات التالية قبل ضبط "خدمات ألعاب Google Play".

إنشاء حساب مطوِّر على Google Play

إنشاء مشروع على Google Cloud

يجب أن تكون قد أعددت مشروعًا على Google Cloud. لمزيد من المعلومات، يُرجى الاطّلاع على

لاستخدام Play Console، عليك تفعيل واجهات برمجة التطبيقات التي تخطّط لاستخدامها مع مشروعك.

وحدة التحكم

تفعيل Google Play Game Services API

gcloud 

gcloud services enable \
   --project "PROJECT" \
   "games.googleapis.com"

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

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

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

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

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

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

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

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

    • نعم، لعبتي تستخدم Google APIs: حدِّد هذا الخيار إذا سبق لك إعداد واجهة برمجة تطبيقات Google للعبة. في هذه الحالة، ستظهر لك قائمة بمشاريعك من Google Cloud Console. اختَر مشروعك من القائمة، ثم انقر على استخدام.

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

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

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

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

يجب أن تحتوي لعبتك على معرِّف عميل OAuth 2.0 حتى تتم مصادقة التطبيق ومنح الإذن له بالاتصال بـ "خدمات ألعاب 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. افتح نافذة طرفية وشغِّل أداة 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، يمكن العثور على ملف تخزين مفاتيح debugging عادةً في ~/.android/debug.keystore.

  5. اختياري: إذا سبق لك إنشاء متجر مفاتيح جديد باستخدام Unity Hub، لا تنشئ شهادة جديدة باستخدام التعليمات الواردة في الخطوة السابقة. استخدِم بصمة SHA1 التي أنشأتها في IDE Unity.

    • استخدِم الأمر التالي لطباعة بصمة SHA1 في الوحدة الطرفية:

      keytool -list -keystore <var>path</var>/<var>name_of_keystore</var>.keystore -v

  6. تطلب منك الأداة keytool إدخال كلمة مرور لملف تخزين المفاتيح. بعد ذلك، يطبع keytool بصمة الإصبع في المحطة الطرفية.

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

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

لمزيد من المعلومات حول بروتوكول 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" التي تم ضبطها بشكل صحيح.

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

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

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

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

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

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

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

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

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

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

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

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

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

1. إعداد لعبتك باستخدام Play Console
إذا أنشأت معرّف عميل Oauth 2.0 لتطبيقك في Google Cloud Console، لن تعرف "خدمات ألعاب 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" ل لعبتك، مثل الألعاب المحفوظة ولوحات الصدارة والإنجازات.