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 إنجاز مفتوح.