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 הגעת להישג.