تتيح خدمة ألعاب Google Play للمطوّرين تحسين الألعاب من خلال قوائم الصدارة على الشبكات الاجتماعية والإنجازات وحالة اللعبة وتسجيل الدخول باستخدام حساب Google وغير ذلك.
- مورد RST: رموز الوصول
- مصدر REST: تعريفات الإنجازات
- مورد RST: الإنجازات
- مصدر RST: التطبيقات
- مورد RST: الفعاليات
- مورد RST: قوائم الصدارة
- مصدر RST: metagame
- مصدر RST: اللاعبين
- مصدر RST: الاستدعاء
- مصدر RST: النُسخ السابقة
- مورد RST: النتائج
- مورد RST: اللقطات
- مصدر RST: الإحصاءات
الخدمة: 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 عرض إحصاءات التفاعل والإنفاق في هذا التطبيق للمستخدم الذي تمت مصادقته حاليًا. |