Google Play Game Services

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

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

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

مستند Discovery

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

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

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

  • https://games.googleapis.com

مورد REST: accesstokens

الطُرق
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
إنشاء رمز مميّز لواجهة برمجة التطبيقات Play Grouping API لمستخدم "خدمات ألعاب Play" المحدَّد من خلال بيانات الاعتماد المرفقة
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
إنشاء رمز مميّز لواجهة برمجة التطبيقات Play Grouping API لمستخدم "خدمات ألعاب Play" المحدَّد من خلال رقم تعريف جلسة Recall المقدَّم في الطلب

مورد 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: Leaderboards

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

مورد REST: metagame

الطُرق
getMetagameConfig GET /games/v1/metagameConfig
إرجاع بيانات إعداد metagame لتطبيق الاتصال.
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

الطُرق
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
يمكنك استرداد رموز Recall المميّزة من جميع الألعاب المطلوبة المرتبطة بمشغّل "خدمات ألعاب Play" المشفر في رقم تعريف جلسة الاستدعاء المقدَّم.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
يمكنك استرداد آخر رمز مميّز لتذكُّر بيانات الألعاب من جميع ألعاب المطوّرين المرتبطة بمشغّل "خدمات ألعاب Play" المشفر في رقم تعريف جلسة الاستدعاء المقدَّم.
linkPersona POST /games/v1/recall:linkPersona
اربط العنصر الرئيسي لمشغّل "خدمات ألعاب Play" المشفر في رقم تعريف جلسة الاستدعاء المقدَّم بحساب داخل اللعبة.
resetPersona POST /games/v1/recall:resetPersona
احذف جميع رموز Recall المميّزة التي تربط الشخصية المحدّدة بأي لاعب (مع ملف شخصي أو بدونه).
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
عرض إحصاءات التفاعل والإنفاق في هذا التطبيق للمستخدم الذي تمت مصادقته حاليًا.