- בקשת HTTP
- פרמטרים של נתיב
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי הרשאות
- מדינה
- PlayerAchievement
- מדינה
- רוצים לנסות?
מציג את ההתקדמות של כל ההישגים של האפליקציה עבור הנגן המאומת הנוכחי.
בקשת 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.
ארץ
טיפוסים בני מנייה (enums) | |
---|---|
ALL |
הצגת כל ההישגים. (זוהי ברירת המחדל) |
HIDDEN |
הצגת רשימה של הישגים מוסתרים בלבד. |
REVEALED |
רשימה של הישגים שנחשפו בלבד. |
UNLOCKED |
רשימה של הישגים שנעילתם בוטלה. |
PlayerAchievement
אובייקט של הישג.
ייצוג JSON |
---|
{
"kind": string,
"id": string,
"currentSteps": integer,
"formattedCurrentStepsString": string,
"achievementState": enum ( |
שדות | |
---|---|
kind |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
id |
מזהה ההישג. |
currentSteps |
השלבים הנוכחיים להישג מצטבר. |
formattedCurrentStepsString |
השלבים הנוכחיים להישג מצטבר כמחרוזת. |
achievementState |
מצב ההישג. |
lastUpdatedTimestamp |
חותמת הזמן של השינוי האחרון במצב של הישג זה. |
experiencePoints |
נקודות ניסיון שנצברות על ההישג. השדה הזה חסר להישגים שעדיין לא נפתחו, ו-0 להישגים שביטלו את נעילתם על ידי בודקים אבל שהפרסום שלהם בוטל. |
ארץ
הגדרת מצבים אפשריים של הישג.
טיפוסים בני מנייה (enums) | |
---|---|
HIDDEN |
ההישג מוסתר. |
REVEALED |
ההישג נחשף. |
UNLOCKED |
הגעת להישג. |