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