Google Play Games Services API

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

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

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

مستند الاستكشاف

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

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

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

  • https://games.googleapis.com

مورد REST: ‏ accesstokens

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

مورد REST: ‏ achievementDefinitions

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

مورد REST: ‏ achievements

الطرق
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: ‏ applications

الطرق
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: ‏ events

الطرق
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
لعرض بيانات إعدادات اللعبة الوصفية للتطبيق الذي يتم استدعاؤه
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
تعرض هذه السمة بيانات اللعب المجمّعة لكل فئة للاعب الذي يتطابق مع playerId.

مورد REST: ‏ playerGameEvents

الطرق
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
تسجّل هذه الطريقة مجموعة من أحداث اللعبة الخاصة بلاعب معيّن.

مورد REST: ‏ players

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

مورد REST: ‏ revisions

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

مورد REST: ‏ scores

الطرق
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: ‏ snapshots

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

مورد REST: ‏ stats

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