- בקשת 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
סוגי הישגים אפשריים.
טיפוסים בני מנייה (enums) | |
---|---|
STANDARD |
ההישג נעול או לא נעול. |
INCREMENTAL |
ההישג הוא מצטבר. |
InitialAchievementState
מצבים ראשוניים אפשריים של הישג.
טיפוסים בני מנייה (enums) | |
---|---|
HIDDEN |
ההישג מוסתר. |
REVEALED |
ההישג נחשף. |
UNLOCKED |
הגעת להישג. |