Method: achievementDefinitions.list

تمام تعاریف دستاورد را برای برنامه شما فهرست می کند.

درخواست HTTP

GET https://games.googleapis.com/games/v1/achievements

پارامترهای پرس و جو

پارامترها
language

string

زبان ترجیحی برای استفاده برای رشته های برگردانده شده توسط این روش.

maxResults

integer

حداکثر تعداد منابع دستاورد برای بازگشت در پاسخ، استفاده شده برای صفحه بندی. برای هر پاسخی، ممکن است تعداد واقعی منابع دستاوردی که برگردانده شده اند کمتر از maxResults مشخص شده باشد.

pageToken

string

توکن با درخواست قبلی بازگردانده شد.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

فهرستی از اشیاء تعریف دستاورد.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (AchievementDefinition)
    }
  ]
}
فیلدها
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#achievementDefinitionsListResponse .

nextPageToken

string

نشانه مربوط به صفحه بعدی نتایج.

items[]

object ( AchievementDefinition )

تعاریف دستاورد

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

تعریف دستاورد

یک هدف تعریف دستاورد.

نمایندگی JSON
{
  "kind": string,
  "id": string,
  "name": string,
  "description": string,
  "achievementType": enum (AchievementType),
  "totalSteps": integer,
  "formattedTotalSteps": string,
  "revealedIconUrl": string,
  "isRevealedIconUrlDefault": boolean,
  "unlockedIconUrl": string,
  "isUnlockedIconUrlDefault": boolean,
  "initialState": enum (InitialAchievementState),
  "experiencePoints": string
}
فیلدها
kind

string

منحصر به فرد نوع این منبع را شناسایی می کند. ارزش همیشه games#achievementDefinition است.

id

string

شناسه دستاورد.

name

string

نام دستاورد.

description

string

شرح دستاورد.

achievementType

enum ( AchievementType )

نوع دستاورد.

totalSteps

integer

کل مراحل برای یک دستاورد افزایشی.

formattedTotalSteps

string

کل مراحل برای یک دستاورد افزایشی به عنوان یک رشته.

revealedIconUrl

string

نشانی وب تصویر برای نماد دستاورد فاش شده.

isRevealedIconUrlDefault

boolean

نشان می دهد که آیا تصویر نشان داده شده نشان داده شده یک تصویر پیش فرض است یا توسط بازی ارائه شده است.

unlockedIconUrl

string

نشانی وب تصویر برای نماد دستاورد باز شده.

isUnlockedIconUrlDefault

boolean

نشان می دهد که آیا تصویر نماد بازگردانده شده یک تصویر پیش فرض است یا توسط بازی ارائه شده است.

initialState

enum ( InitialAchievementState )

وضعیت اولیه دستاورد.

experiencePoints

string ( int64 format)

امتیازهایی را تجربه کنید که هنگام باز کردن قفل این دستاورد به دست خواهید آورد.

نوع دستاورد

انواع دستاوردهای احتمالی

Enums
STANDARD دستاورد یا قفل یا باز است.
INCREMENTAL دستاورد افزایشی است.

InitialAchievementState

حالات اولیه احتمالی یک دستاورد

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