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 مراجعه کنید.

حالت

Enums
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 برای دستاوردهایی که توسط آزمایش کنندگان باز شده اما منتشر نشده اند وجود ندارد.

حالت

حالات احتمالی یک دستاورد را تعریف می کند.

Enums
HIDDEN دستاورد پنهان است.
REVEALED دستاورد آشکار می شود.
UNLOCKED قفل دستاورد باز شده است.