Google Play Game Services

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

الخدمة: Games.googleapis.com

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

مستند "اقتراحات"

مستند الاستكشاف هو مواصفات يمكن للآلة قراءتها لوصف واجهات برمجة تطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات للعملاء ومكوّنات IDE وأدوات أخرى تتفاعل مع Google APIs. قد توفّر خدمة واحدة مستندات اكتشاف متعددة. توفّر هذه الخدمة مستند الاستكشاف التالي:

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي عنوان URL أساسي يحدد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تتضمن خدمة واحدة نقاط نهاية متعددة للخدمة. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية وجميع معرّفات الموارد المنتظمة (URI) التالية مرتبطة بنقطة نهاية الخدمة هذه:

  • https://games.googleapis.com

مرجع REST: achievementDefinitions (تعريفات الإنجاز)

الطُرق
list GET /games/v1/achievements
تتضمّن قائمة بجميع تعريفات الإنجازات لتطبيقك.

مورد REST: الإنجازات

الطُرق
increment POST /games/v1/achievements/{achievementId}/increment
لزيادة خطوات الإنجاز باستخدام المعرّف المحدّد للمشغّل الذي تمّت المصادقة عليه حاليًا.
list GET /games/v1/players/{playerId}/achievements
يتم عرض مستوى التقدّم المحرز لجميع إنجازات تطبيقك للمشغّل الذي تمت مصادقته حاليًا.
reveal POST /games/v1/achievements/{achievementId}/reveal
لضبط حالة الإنجاز الذي يحمل المعرّف المحدّد، على REVEALED للمشغّل الذي تمّت المصادقة عليه حاليًا.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
تحدِّد هذه السياسة خطوات اللاعب الذي تمّت المصادقة عليه حاليًا نحو فتح إنجاز.
unlock POST /games/v1/achievements/{achievementId}/unlock
يتم فتح قفل هذا الإنجاز للّاعب الذي تمّت المصادقة عليه حاليًا.
updateMultiple POST /games/v1/achievements/updateMultiple
يعدّل هذا الفلتر إنجازات متعدّدة للمشغّل الذي تمّت مصادقته حاليًا.

موارد REST: التطبيقات

الطُرق
get GET /games/v1/applications/{applicationId}
يسترد البيانات البيانات الوصفية للتطبيق باستخدام المعرّف المحدّد.
getEndPoint POST /games/v1/applications/getEndPoint
تعرض عنوان URL لنوع نقطة النهاية المطلوب.
played POST /games/v1/applications/played
يمكنك الإشارة إلى أنّ المستخدم الذي تمت مصادقته حاليًا يشغِّل تطبيقك.
verify GET /games/v1/applications/{applicationId}/verify
يتم التحقق من أنّ رمز المصادقة المُقدَّم مع هذا الطلب خاص بالتطبيق الذي يحمل المعرّف المحدد، ويعرض رقم تعريف المُشغِّل الذي تم منحه له.

مورد REST: الفعاليات

الطُرق
listByPlayer GET /games/v1/events
تعرض قائمة توضح مستوى التقدم الحالي في الأحداث في هذا التطبيق للمستخدم الذي تمت مصادقته حاليًا.
listDefinitions GET /games/v1/eventDefinitions
تعرض قائمة بتعريفات الأحداث في هذا التطبيق.
record POST /games/v1/events
يتم تسجيل مجموعة من التغييرات لعدد مرات وقوع الأحداث للمستخدم الذي تمت مصادقته حاليًا لهذا التطبيق.

مورد REST: قوائم الصدارة

الطُرق
get GET /games/v1/leaderboards/{leaderboardId}
استرداد البيانات الوصفية للوحة الصدارة باستخدام المعرّف المحدّد.
list GET /games/v1/leaderboards
يتم إدراج جميع البيانات الوصفية للوحة الصدارة لتطبيقك.

مرجع REST: metagame

الطُرق
getMetagameConfig GET /games/v1/metagameConfig
عرض بيانات الإعدادات الوصفية للألعاب الوصفية لتطبيق الاتصال.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
أدرج بيانات التشغيل المجمّعة لكل فئة للّاعب المقابل لـ playerId.

مورد REST: اللاعبون

الطُرق
get GET /games/v1/players/{playerId}
استرداد مورد المشغّل بالمعرّف المحدّد.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
يمكنك الحصول على معرّفات مشغِّل التطبيقات للّاعب الذي تمّت المصادقة عليه حاليًا في جميع الألعاب التي يطلبها المطوّر نفسه الذي يعتمده تطبيق الاتصال.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
يسترد هذا الإعداد معرّفات المشغّلات ذات النطاق المحدّد للمستخدم الذي تمّت مصادقته في الوقت الحالي.
list GET /games/v1/players/me/players/{collection}
يمكنك الحصول على مجموعة من المشغّلات للمستخدم الذي تمت مصادقته حاليًا.

مورد REST: Recall

الطُرق
linkPersona POST /games/v1/recall:linkPersona
اربط حساب مدير "خدمات ألعاب Play" الذي تم تشفيره في رقم تعريف جلسة التذكُّر المقدّمة بحساب داخل اللعبة.
resetPersona POST /games/v1/recall:resetPersona
احذِف كل الرموز المميّزة لتذكُّر بيانات الألعاب التي تربط الشخصية المعنيّة بأي لاعب (لديه ملف شخصي أو لا يتضمّنه).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
يمكنك استرداد كل الرموز المميّزة لتذكُّر الحسابات المُستخدَمة المرتبطة ببرنامج "خدمات ألعاب Play" الأساسي والمشفّر في معرّف جلسة الاستدعاء المقدَّم.
unlinkPersona POST /games/v1/recall:unlinkPersona
حذف رمز مميَّز لتذكُّر الحسابات المُستخدَمة من أجل ربط مدير "خدمات ألعاب Play" الذي تم تحديده من خلال جلسة استدعاء الألعاب، وحساب داخل اللعبة يتم تحديده من خلال "الشخصية" أو قيمة الرمز المميّز

مورد REST: المراجعات

الطُرق
check GET /games/v1/revisions/check
يتحقّق مما إذا كان برنامج الألعاب قديمًا.

مورد REST: النتائج

الطُرق
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
يمكنك الحصول على أعلى النتائج والحصول على ترتيب اختياري في قوائم الصدارة للاعب الذي تمّت المصادقة عليه حاليًا.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
يتم عرض النتائج في لوحة صدارة، بدءًا من الأعلى.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
يتم عرض النتائج في لوحة صدارة حول نتيجة اللاعبين (وتتضمّنها).
submit POST /games/v1/leaderboards/{leaderboardId}/scores
لإرسال النتيجة إلى لوحة الصدارة المحددة.
submitMultiple POST /games/v1/leaderboards/scores
لإرسال عدة نتائج إلى لوحات الصدارة.

مورد REST: لقطات

الطُرق
get GET /games/v1/snapshots/{snapshotId}
استرداد البيانات الوصفية لمعرّف لقطة معيّن.
list GET /games/v1/players/{playerId}/snapshots
استرداد قائمة باللقطات التي أنشأها تطبيقك للمشغّل المقابل لمعرّف المشغّل.

مورد REST: stats

الطُرق
get GET /games/v1/stats
تعرض إحصاءات التفاعل والإنفاق في هذا التطبيق للمستخدم الذي تمت مصادقته حاليًا.