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