إدارة إعدادات مشروع "خدمات ألعاب Play" في Google Cloud

قد تحتاج في بعض الحالات إلى عرض مشروع "خدمات ألعاب Play" وتعديله مباشرةً في Google Cloud.

تشمل السيناريوهات النموذجية ما يلي:

• تفعيل واجهات برمجة تطبيقات إضافية لمشروعك (مثل Google Drive)
• تعديل معلومات العلامة التجارية للعبتك في مربّع حوار OAuth 2.0
• عرض حصة واجهة برمجة التطبيقات وطلب المزيد (إذا لزم الأمر)
• تعديل عناوين URI المصرَّح بها أو مصادر JavaScript في معرّفات العملاء التي أنشأتها في الماضي

عرض مشروعك

لعرض مشروعك في Google Cloud:

1. اختَر بيانات اعتماد للعبتك في صفحة الإعدادات (زيادة عدد المستخدمين > خدمات ألعاب Play  > الإعداد والإدارة > الإعدادات).
2. انتقِل إلى قسم المصادقة وانقر على عرض في Google Cloud.

تعديل حصص استخدام واجهة برمجة التطبيقات

في Google Cloud، يمكنك عرض حدود استخدام واجهة برمجة التطبيقات التي تم إعدادها للعبتك ومقدار الحصة التي تم استخدامها. يمكنك أيضًا ضبط حدود لكل مستخدم لمنع مستخدم مسيء (أو برنامج عميل للعبة يتضمّن أخطاء) من استنفاد حصتك.

لعرض حدود الاستخدام أو تغييرها لمشروعك، أو لطلب زيادة حصتك، اتّبِع الخطوات التالية:

1. إذا لم يكن لديك حساب فوترة لمشروعك، أنشئ حسابًا.
2. انتقِل إلى صفحة واجهات برمجة التطبيقات المفعَّلة في مكتبة واجهات برمجة التطبيقات في واجهة برمجة التطبيقات، واختَر واجهة برمجة تطبيقات من القائمة.
3. لعرض الإعدادات المتعلّقة بالحصة وتغييرها، انقر على الحصص. لعرض إحصاءات الاستخدام، انقر على الاستخدام.

يتم تحديد "المستخدمين" استنادًا إلى عنوان IP الخاص بالعميل الذي يقدّم طلب الحصة. على سبيل المثال، إذا كانت جميع طلباتك واردة من خادم واحد، قد يتم وضع علامة على هذا الخادم بشكل خاطئ كمستخدم واحد غير مرغوب فيه. لمنع حدوث ذلك، يمكنك إرفاق وسيطة userIp=x.x.x.x بطلبات نقطة نهاية واجهة برمجة التطبيقات.

لمزيد من المعلومات حول ضبط الحصص لكل مستخدم، يُرجى الاطّلاع على مقالة تحديد الحد الأقصى لاستخدام واجهة برمجة التطبيقات.

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

عرض حدود المعدّل في OAuth والحدود القصوى للمستخدمين الجدد

لعرض الحصص المتعلّقة تحديدًا بمعدّلات منح إذن المستخدم في OAuth والحدود القصوى للمستخدمين الجدد:

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

إذا تبيّن لك أنّ لعبتك ستبلغ حد المعدّل قريبًا، عليك اتّخاذ إجراء لمنع حدوث أي انقطاع للاعبين من خلال طلب زيادة حصة حد المعدّل.

لمزيد من المعلومات، يُرجى الاطّلاع على حدود المعدّل في تطبيقات OAuth.

تفعيل واجهات برمجة التطبيقات الأخرى

عند إنشاء معرّف العميل في Play Console، يتم تلقائيًا تفعيل واجهة برمجة التطبيقات "خدمات ألعاب Google Play" لمشروعك. يمكنك تفعيل واجهات برمجة تطبيقات Google الأخرى من Google Cloud.

لتفعيل واجهة برمجة تطبيقات لمشروعك، اتّبِع الخطوات التالية:

1. افتح مكتبة واجهات برمجة التطبيقات في وحدة تحكّم واجهة Google API. اختَر مشروعًا أو أنشئ مشروعًا جديدًا إذا طُلب منك ذلك. تعرض مكتبة واجهات برمجة التطبيقات جميع واجهات برمجة التطبيقات المتاحة، مجمّعة حسب مجموعة المنتجات والشهرة.

2. إذا لم تظهر واجهة برمجة التطبيقات التي تريد تفعيلها في القائمة، استخدِم ميزة البحث للعثور عليها.

3. اختَر واجهة برمجة التطبيقات التي تريد تفعيلها، ثم انقر على الزر تفعيل.

4. فعِّل الفوترة إذا طُلب منك ذلك.

5. اقبَل بنود خدمة واجهة برمجة التطبيقات إذا طُلب منك ذلك.

تعديل معلومات العلامة التجارية

لتعديل معلومات العلامة التجارية (العنوان والشعار وما إلى ذلك) للعبتك التي تظهر في مربّع حوار OAuth 2.0، اضبط السمات في شاشة طلب الموافقة في Google Cloud.

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

1. افتح صفحة شاشة طلب الموافقة في Play Console. اختَر مشروعًا أو أنشئ مشروعًا جديدًا إذا طُلب منك ذلك.
2. املأ النموذج وانقر على حفظ.

تعديل نوع مستخدم OAuth

إذا كنت تختبر في مسار الاختبار الإنتاج (الاختبار والإصدار > الإنتاج) باستخدام حساب اختبار شخصي، يجب أن تكون قد ضبطت أيضًا إعداد شريحة جمهور OAuth في Google Cloud على خارجي. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إدارة شريحة جمهور التطبيق.

تعديل السمات المتعلّقة بمعرّف العميل

لتعديل السمات المتعلّقة بمعرّف عميل OAuth 2.0 (مصادر الويب وعناوين URL لإعادة التوجيه لتطبيق ويب وما إلى ذلك):

1. افتح Play Console وانتقِل إلى لعبتك.
2. اختَر بيانات اعتماد للعبتك في صفحة الإعدادات (زيادة عدد المستخدمين > خدمات ألعاب Play  > الإعداد والإدارة > الإعدادات).
3. انتقِل إلى أسفل قسم المصادقة وانقر على عرض في Google Cloud.
4. في Google Cloud، اختَر مشروعك.
5. في الشريط الجانبي الأيمن، انقر على واجهات برمجة التطبيقات والمصادقة. تأكَّد من أنّ حالة واجهة برمجة التطبيقات "خدمات ألعاب Google Play" هي مفعَّلة في قائمة واجهات برمجة التطبيقات المعروضة.
6. في الشريط الجانبي الأيمن، انقر على التطبيقات المسجَّلة.
7. وسِّع قسم "معرّف عميل OAuth 2.0" وابحث عن السمة التي تريد تعديلها.

نقل عملاء OAuth من مشروع حالي على السحابة الإلكترونية

لعرض مشروعك في Google Cloud، اتّبِع الخطوات الواردة في مقالة عرض مشروعك.

لإعداد "خدمات ألعاب Play"، يجب توفّر مشروع فريد على Google Cloud. إذا كانت ألعاب متعدّدة تشارك مشروعًا واحدًا على السحابة الإلكترونية، عليك نقل عملاء OAuth على Android إلى مشاريع مستقلة لضمان الإعداد بشكل صحيح.

في المثال السابق، أنشأت اللعبة 1 واللعبة 2 عملاء الويب وAndroid ضمن مشروع واحد على Google Cloud لتسجيل الدخول باستخدام حساب Google. علينا نقل عملاء الويب وAndroid للعبة 2 من مشروع Google Cloud القديم الحالي إلى مشروع Google Cloud مستهدَف جديد.

الخطوة 1: إعداد النظام الخلفي

قبل إجراء التبديل، عليك تعديل النظام الخلفي والعملاء للتعامل مع وجود معرّفات عملاء الويب القديمة والجديدة في الوقت نفسه.

• الإعداد من جهة الخادم: إذا كان خادمك يتحقّق من معرّف عميل الويب ضمن الرمز المميّز للمعرّف، عليك تعديل منطق الخادم لدعم الرموز المميّزة للمعرّف الصادرة عن كلٍّ من العملاء القدامى في مشروع السحابة الإلكترونية القديم والعملاء الجدد الذين عليك إنشاؤهم في مشروع السحابة الإلكترونية المستهدَف في الوقت نفسه.
• الإعداد من جهة العميل: يجب أن يدعم تطبيق العميل معرّفات عملاء ويب متعدّدة لتسجيل الدخول باستخدام معرّف عميل الويب الجديد عند التبديل. يمكنك استخدام أي من الطرق التالية:
  • تضمين معرّفَي عميل ويب في تطبيق العميل، والتبديل إلى معرّف عميل الويب الجديد عند انتهاء صلاحية معرّف العميل القديم
  • الحصول ديناميكيًا على أحدث معرّف عميل ويب من الخادم لإكمال التبديل
• إنشاء عملاء الويب مسبقًا: في مشروعك المستهدَف، عليك إنشاء عميل ويب جديد مسبقًا لتجنُّب التأخيرات المحتملة أثناء التبديل الذري.

الخطوة 2: إعداد عملاء OAuth الجدد على الويب وAndroid في Google Cloud الصحيح

الخطوة 2.1: أنشئ عميل OAuth جديد على الويب للعبة 2 في مشروع Google Cloud المستهدَف:

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

غيِّر اسم حزمة عميل Android للعبة 2 في مشروع Google Cloud القديم إلى قيمة غير صالحة، مثل com.noexist.none.

الخطوة 2.3: أنشئ على الفور عميل Android جديدًا للعبة 2 باستخدام رقم الملف المرجعي SHA-1 واسم الحزمة نفسَيهما للعبة 2 في مشروع Google Cloud المستهدَف:

الخطوة 3: نشر الإعدادات في الوقت الفعلي

بعد إنشاء عميل Android الجديد بنجاح في المشروع المستهدَف ، نفِّذ الإجراءات التالية على الفور:

• إعادة توجيه العملاء: استخدِم آلية الإعداد الديناميكي (مثل "الإعداد عن بُعد") لتبديل تطبيق العميل على الفور بحيث يبدأ في استخدام معرّف عميل الويب الجديد.
• الاحتفاظ بالعملاء القدامى: احتفِظ بعملاء OAuth القدامى كخيار احتياطي للرجوع إلى تسجيل الدخول السابق باستخدام عميل OAuth في حال حدوث أي مشاكل.