- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- الولاية
- PlayerAchievement
- الولاية
- جرِّبه الآن
يسرد مستوى التقدُّم في جميع إنجازات تطبيقك للمشغّل الذي تمت مصادقته حاليًا.
طلب HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/achievements
مَعلمات المسار
المعلمات | |
---|---|
playerId |
رقم تعريف اللاعب يجب استخدام قيمة |
معامِلات طلب البحث
المعلمات | |
---|---|
language |
اللغة المفضلة المراد استخدامها للسلاسل التي يتم عرضها بهذه الطريقة. |
maxResults |
الحد الأقصى لعدد موارد الإنجاز التي سيتم عرضها في الرد، ويتم استخدامه للترقيم. بالنسبة إلى أي استجابة، قد يكون العدد الفعلي لموارد الإنجاز التي يتم عرضها أقل من قيمة |
pageToken |
الرمز المميّز الذي تم عرضه من خلال الطلب السابق |
state |
تطلب من الخادم عرض الإنجازات ذات الحالة المحدّدة فقط. وفي حال عدم تحديد هذه المَعلمة، سيتم عرض جميع الإنجازات. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
قائمة بكائنات الإنجاز.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"kind": string,
"nextPageToken": string,
"items": [
{
object ( |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة |
nextPageToken |
الرمز المميّز المقابل لصفحة النتائج التالية. |
items[] |
الإنجازات. |
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
الحالة
عمليات التعداد | |
---|---|
ALL |
إدراج جميع الإنجازات هذا هو الخيار التلقائي. |
HIDDEN |
إدراج الإنجازات المخفية فقط |
REVEALED |
تم الكشف عن الإنجازات فقط في القائمة. |
UNLOCKED |
إدراج الإنجازات التي تم فتحها فقط |
PlayerAchievement
كائن إنجاز.
تمثيل JSON |
---|
{
"kind": string,
"id": string,
"currentSteps": integer,
"formattedCurrentStepsString": string,
"achievementState": enum ( |
الحقول | |
---|---|
kind |
تُحدِّد نوع هذا المورد بشكلٍ فريد. وتكون القيمة دائمًا هي السلسلة الثابتة |
id |
رقم تعريف الإنجاز. |
currentSteps |
الخطوات الحالية لإنجاز تدريجي. |
formattedCurrentStepsString |
الخطوات الحالية لإنجاز تدريجي كسلسلة. |
achievementState |
حالة الإنجاز. |
lastUpdatedTimestamp |
الطابع الزمني لآخر تعديل لحالة هذا الإنجاز. |
experiencePoints |
نقاط الخبرة التي تم الحصول عليها مقابل الإنجاز ولا يتوفّر هذا الحقل للإنجازات التي لم يفتحها المختبِرون بعد و0 للإنجازات التي فتحها المختبِرون غير المنشورة. |
الحالة
تحدد الحالات المحتملة لإنجاز ما.
عمليات التعداد | |
---|---|
HIDDEN |
الإنجاز مخفي. |
REVEALED |
يتم كشف الإنجاز. |
UNLOCKED |
إنجاز مفتوح. |