Method: achievements.list

تعرض هذه البطاقة مستوى التقدم المحرز لكل إنجازات تطبيقك للمشغل الذي تمت مصادقته حاليًا.

طلب HTTP

GET https://games.googleapis.com/games/v1/players/{playerId}/achievements

مَعلمات المسار

المَعلمات
playerId

string

رقم تعريف لاعب. يمكن استخدام قيمة me بدلاً من معرّف المشغّل الذي تمت مصادقته.

معلمات طلب البحث

المَعلمات
language

string

اللغة المفضلة للاستخدام للسلاسل التي تعرضها هذه الطريقة.
maxResults

integer

الحد الأقصى لعدد موارد الإنجاز المطلوب عرضها في الإجابة، وتُستخدم في التقسيم على صفحات. بالنسبة إلى أي استجابة، قد يكون العدد الفعلي لموارد الإنجاز المعروضة أقل من maxResults المحدَّد.
pageToken

string

الرمز المميّز الذي عرضه الطلب السابق
state

enum (State)

لتوجيه الخادم إلى عرض الإنجازات ذات الحالة المحددة فقط. في حال عدم تحديد هذه المَعلمة، يتم عرض جميع الإنجازات.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

قائمة بكائنات الإنجازات.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (PlayerAchievement)
    }
  ]
}
الحقول
kind

string

يحدِّد نوع هذا المورد بشكلٍ فريد. القيمة هي دائمًا السلسلة الثابتة games#playerAchievementListResponse.
nextPageToken

string

رمز مميز يقابل الصفحة التالية من النتائج
items[]

object (PlayerAchievement)

الإنجازات.

نطاقات التفويض

يتطلب استخدام أحد نطاقات 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 (State),
  "lastUpdatedTimestamp": string,
  "experiencePoints": string
}
الحقول
kind

string

يحدِّد نوع هذا المورد بشكلٍ فريد. القيمة هي دائمًا السلسلة الثابتة games#playerAchievement.
id

string

رقم تعريف الإنجاز.
currentSteps

integer

الخطوات الحالية لتحقيق إنجاز تدريجي.
formattedCurrentStepsString

string

الخطوات الحالية لإنجاز تزايدي كسلسلة.
achievementState

enum (State)

حالة الإنجاز.
lastUpdatedTimestamp

string (int64 format)

الطابع الزمني لآخر تعديل تم إجراؤه على حالة هذا الإنجاز.
experiencePoints

string (int64 format)

مكافآت الخبرة المكتسبة مقابل الإنجاز لا يتوفر هذا الحقل للإنجازات التي لم يتم فتحها بعد و0 للإنجازات التي حصل عليها المختبِرون ولم يتم نشرها.

الحالة

تحدد الحالات المحتملة للإنجاز.

عمليات التعداد
HIDDEN الإنجاز مخفي.
REVEALED يتم الكشف عن الإنجاز.
UNLOCKED فتح إنجاز