- בקשת HTTP
- פרמטרים של נתיב
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- מדינה (State)
- PlayerAchievement
- מדינה (State)
- רוצים לנסות?
רשימה של ההתקדמות בכל ההישגים של האפליקציה בנגן המאומת הנוכחי.
בקשת HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/achievements
פרמטרים של נתיב
פרמטרים | |
---|---|
playerId |
מזהה נגן. ניתן להשתמש בערך של |
פרמטרים של שאילתה
פרמטרים | |
---|---|
language |
השפה המועדפת לשימוש למחרוזות שמוחזרות בשיטה הזו. |
maxResults |
המספר המקסימלי של משאבי הישגים שצריך להחזיר בתשובה, המשמש לחלוקה לדפים. בכל תגובה, המספר של משאבי ההישגים שמוחזרים בפועל עשוי להיות קטן מהערך שצוין ב- |
pageToken |
האסימון שהוחזר בעקבות הבקשה הקודמת. |
state |
מנחה את השרת להחזיר רק הישגים במצב שצוין. אם לא מציינים את הפרמטר הזה, כל ההישגים מוחזרים. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
רשימה של הישגים.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"kind": string,
"nextPageToken": string,
"items": [
{
object ( |
שדות | |
---|---|
kind |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
nextPageToken |
אסימון שתואם לדף התוצאות הבא. |
items[] |
ההישגים. |
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
מדינה
טיפוסים בני מנייה (enum) | |
---|---|
ALL |
הצגת רשימה של כל ההישגים. (זוהי ברירת המחדל) |
HIDDEN |
הצגת רשימה של הישגים מוסתרים בלבד. |
REVEALED |
הצגת רשימה של רק הישגים שנחשפו. |
UNLOCKED |
הצגת רשימה רק של הישגים שלא נעולים. |
PlayerAchievement
אובייקט של הישג.
ייצוג JSON |
---|
{
"kind": string,
"id": string,
"currentSteps": integer,
"formattedCurrentStepsString": string,
"achievementState": enum ( |
שדות | |
---|---|
kind |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
id |
מזהה ההישג. |
currentSteps |
השלבים הנוכחיים להישג מצטבר. |
formattedCurrentStepsString |
השלבים הנוכחיים להישג מצטבר כמחרוזת. |
achievementState |
מצב ההישג. |
lastUpdatedTimestamp |
חותמת הזמן של השינוי האחרון במצב של ההישג הזה. |
experiencePoints |
נקודות ניסיון שנצברו עבור ההישג. השדה הזה חסר בהישגים שעדיין לא נפתחו ו-0 להישגים שבודקים פותחים אבל לא פורסמו. |
מדינה
מגדיר מצבים אפשריים של הישג.
טיפוסים בני מנייה (enum) | |
---|---|
HIDDEN |
ההישג מוסתר. |
REVEALED |
ההישג ייחשף. |
UNLOCKED |
ההישג בוטלה. |