- בקשת HTTP
- פרמטרים של שאילתה
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- AchievementDefinition
- AchievementType
- InitialAchievementState
- רוצים לנסות?
רשימה של כל הגדרות ההישגים של האפליקציה שלכם.
בקשת HTTP
GET https://games.googleapis.com/games/v1/achievements
פרמטרים של שאילתה
פרמטרים | |
---|---|
language |
השפה המועדפת לשימוש למחרוזות שמוחזרות בשיטה הזו. |
maxResults |
המספר המקסימלי של משאבי הישגים שצריך להחזיר בתשובה, המשמש לחלוקה לדפים. בכל תגובה, המספר של משאבי ההישגים שמוחזרים בפועל עשוי להיות קטן מהערך שצוין ב- |
pageToken |
האסימון שהוחזר בעקבות הבקשה הקודמת. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
רשימה של אובייקטים בהגדרת הישגים.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג 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.
AchievementDefinition
אובייקט של הגדרת הישג.
ייצוג JSON |
---|
{ "kind": string, "id": string, "name": string, "description": string, "achievementType": enum ( |
שדות | |
---|---|
kind |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
id |
מזהה ההישג. |
name |
שם ההישג. |
description |
תיאור ההישג. |
achievementType |
סוג ההישג. |
totalSteps |
סך כל השלבים להישג מצטבר. |
formattedTotalSteps |
סך כל השלבים להישג מצטבר כמחרוזת. |
revealedIconUrl |
כתובת ה-URL של התמונה של סמל ההישג שנחשף. |
isRevealedIconUrlDefault |
מציין אם תמונת הסמל שנחשפת שהוחזרה היא תמונת ברירת מחדל או מסופקת על ידי המשחק. |
unlockedIconUrl |
כתובת ה-URL של התמונה לסמל של הישג פתוח. |
isUnlockedIconUrlDefault |
מציין אם תמונת הסמל לביטול הנעילה שהוחזרה היא תמונת ברירת מחדל או שהיא סופקה על ידי המשחק. |
initialState |
המצב הראשוני של ההישג. |
experiencePoints |
נקודות ניסיון מצטבר שיצברו לאחר ביטול הנעילה של ההישג הזה. |
AchievementType
סוגי הישגים אפשריים.
טיפוסים בני מנייה (enum) | |
---|---|
STANDARD |
ההישג נעול או לא נעול. |
INCREMENTAL |
ההישג הוא מצטבר. |
InitialAchievementState
מצבים ראשוניים אפשריים של הישג.
טיפוסים בני מנייה (enum) | |
---|---|
HIDDEN |
ההישג מוסתר. |
REVEALED |
ההישג ייחשף. |
UNLOCKED |
ההישג בוטלה. |