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.

AchievementDefinition

كائن تعريف الإنجاز

تمثيل 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

عنوان URL للصورة لرمز الإنجاز الذي تم عرضه.
isRevealedIconUrlDefault

boolean

يشير هذا الرمز إلى ما إذا كانت صورة الرمز التي يتم عرضها هي صورة تلقائية أو مقدَّمة من اللعبة.
unlockedIconUrl

string

عنوان URL للصورة لرمز الإنجاز الذي تم فتح قفله.
isUnlockedIconUrlDefault

boolean

يشير هذا الرمز إلى ما إذا كانت صورة رمز فتح القفل التي يتم عرضها هي صورة تلقائية أو مقدَّمة من لعبة.
initialState

enum (InitialAchievementState)

الحالة الأولية للإنجاز.
experiencePoints

string (int64 format)

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

AchievementType

أنواع الإنجازات المحتملة.

عمليات التعداد
STANDARD الإنجاز إمّا مقفل أو مفتوح.
INCREMENTAL الإنجاز تدريجي.

InitialAchievementState

الحالات الأولية المحتملة لإنجاز ما.

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