שירות המשחקים Google Play מאפשר למפתחים לשפר משחקים באמצעות לוחות לידרבורד ברשתות חברתיות, הישגים, מצב המשחק, כניסה באמצעות חשבון Google ועוד.
- משאב REST: AchievementDefinitions
- משאב REST: הישגים
- משאב REST: אפליקציות
- משאב REST: אירועים
- משאב REST: Leaderboards
- משאב REST: מטא-משחק
- משאב REST: שחקנים
- משאב REST: ריקול
- משאב ל-REST: גרסאות קודמות
- משאב REST: ציונים
- משאב ל-REST: תמונות מצב
- משאב ל-REST: נתונים סטטיסטיים
שירות: Games.googleapis.com
כדי לקרוא לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה שלכם צריכה להשתמש בספריות משלכם כדי לקרוא לשירות הזה, תוכלו להשתמש בפרטים הבאים כשתשלחו את בקשות ה-API.
מסמך Discovery
מסמך Discovery הוא מפרט קריא למחשבים שמיועד לתיאור ולשימוש בממשקי API ל-REST. הוא משמש לבניית ספריות לקוח, יישומי פלאגין ל-IDE וכלים אחרים שיוצרים אינטראקציה עם Google APIs. שירות אחד יכול לספק כמה מסמכי גילוי. השירות הזה מספק את מסמך הגילוי הבא:
נקודת הקצה של השירות
נקודת קצה של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות ה-API. לשירות אחד יכולות להיות כמה נקודות קצה של שירות. לשירות הזה יש את נקודת הקצה הבאה של השירות, וכל מזהי ה-URI הבאים הם יחסיים לנקודת הקצה של השירות:
https://games.googleapis.com
משאב ל-REST: achievementDefinitions
שיטות | |
---|---|
list |
GET /games/v1/achievements רשימת כל הגדרות ההישגים לאפליקציה שלכם. |
משאב ל-REST: הישגים
שיטות | |
---|---|
increment |
POST /games/v1/achievements/{achievementId}/increment הוספת השלבים של ההישג לפי המזהה הנתון עבור הנגן המאומת הנוכחי. |
list |
GET /games/v1/players/{playerId}/achievements מציג את ההתקדמות של כל ההישגים של האפליקציה עבור הנגן המאומת הנוכחי. |
reveal |
POST /games/v1/achievements/{achievementId}/reveal מגדיר את מצב ההישג עם המזהה הנתון כ- REVEALED עבור הנגן המאומת הנוכחי. |
setStepsAtLeast |
POST /games/v1/achievements/{achievementId}/setStepsAtLeast מגדיר את השלבים לשחקן המאומת שאומת לצורך ביטול נעילה של הישג. |
unlock |
POST /games/v1/achievements/{achievementId}/unlock מבטל את נעילת ההישג הזה עבור השחקן המאומת הנוכחי. |
updateMultiple |
POST /games/v1/achievements/updateMultiple מעדכן מספר הישגים עבור השחקן המאומת הנוכחי. |
משאב REST: אפליקציות
שיטות | |
---|---|
get |
GET /games/v1/applications/{applicationId} אחזור המטא-נתונים של האפליקציה עם המזהה הנתון. |
getEndPoint |
POST /games/v1/applications/getEndPoint מחזירה כתובת URL לסוג נקודת הקצה המבוקש. |
played |
POST /games/v1/applications/played יש לציין שהמשתמש המאומת הנוכחי מפעיל את האפליקציה. |
verify |
GET /games/v1/applications/{applicationId}/verify מאמת שאסימון ההרשאה שסופק עם הבקשה הזו מיועד לאפליקציה עם המזהה שצוין, ומחזיר את המזהה של הנגן שעבורו הוענקה הבקשה. |
משאב REST: אירועים
שיטות | |
---|---|
listByPlayer |
GET /games/v1/events מחזירה רשימה שמראה את ההתקדמות הנוכחית באירועים באפליקציה הזו עבור המשתמש המאומת הנוכחי. |
listDefinitions |
הפונקציה GET /games/v1/eventDefinitions מחזירה רשימה של הגדרות האירועים באפליקציה הזו. |
record |
POST /games/v1/events מתעד קבוצה של שינויים למספר הפעמים שהתרחשו אירועים עבור המשתמש המאומת הנוכחי של האפליקציה הזו. |
משאב ל-REST: Leaderboards
שיטות | |
---|---|
get |
GET /games/v1/leaderboards/{leaderboardId} אחזור המטא-נתונים של לידרבורד עם המזהה הנתון. |
list |
GET /games/v1/leaderboards רשומים כל המטא-נתונים של לוחות הלידרבורד לאפליקציה שלכם. |
מקור מידע ל-REST: metagame
שיטות | |
---|---|
getMetagameConfig |
GET /games/v1/metagameConfig החזרת נתוני התצורה של המטא-משחק עבור אפליקציית הקריאה. |
listCategoriesByPlayer |
GET /games/v1/players/{playerId}/categories/{collection} הצגת רשימה של נתוני הפעלה נצברים לפי קטגוריה עבור השחקן התואם ל- playerId . |
משאב REST: players
שיטות | |
---|---|
get |
GET /games/v1/players/{playerId} אחזור משאב הנגן עם המזהה הנתון. |
getMultipleApplicationPlayerIds |
GET /games/v1/players/me/multipleApplicationPlayerIds קבלת מזהי נגן האפליקציה של השחקן המאומת הנוכחי בכל המשחקים המבוקשים על ידי אותו מפתח כמו אפליקציית הקריאה. |
getScopedPlayerIds |
GET /games/v1/players/me/scopedIds אחזור מזהי שחקנים בהיקף של המשתמש המאומת הנוכחי. |
list |
GET /games/v1/players/me/players/{collection} קבלת אוסף הנגנים עבור המשתמש המאומת הנוכחי. |
משאב REST: recall
שיטות | |
---|---|
linkPersona |
POST /games/v1/recall:linkPersona שיוך חשבון המשתמש של שחקן ה-PGS שקודד במזהה סשן הריקול שסופק לחשבון במשחק |
resetPersona |
POST /games/v1/recall:resetPersona מחיקת כל אסימוני Recall שמקשרים את הפרסונה הנתונה לכל שחקן (עם או בלי פרופיל). |
retrieveTokens |
GET /games/v1/recall/tokens/{sessionId} אחזור כל אסימוני הריקול המשויכים לחשבון המשתמש של נגן ה-PGS שקודדו במזהה הסשן שסופק. |
unlinkPersona |
POST /games/v1/recall:unlinkPersona מוחקים אסימון ריקול שמקשר את חשבון המשתמש של שחקן ה-PGS שזוהה בסשן הריקול לחשבון במשחק שמזוהה לפי 'פרסונה' או לפי ערך האסימון. |
משאב REST: גרסאות
שיטות | |
---|---|
check |
GET /games/v1/revisions/check הפונקציה בודקת אם לקוח המשחקים לא מעודכן. |
מקור מידע ל-REST: ציונים
שיטות | |
---|---|
get |
GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan} קבל ניקוד גבוה, כולל דירוגים, בלידרבורד של השחקן המאומת הנוכחי. |
list |
GET /games/v1/leaderboards/{leaderboardId}/scores/{collection} מציג את הניקוד בלידרבורד, מהקצה העליון. |
listWindow |
GET /games/v1/leaderboards/{leaderboardId}/window/{collection} פירוט התוצאות בלידרבורד מסביב (כולל) הניקוד של השחקן. |
submit |
POST /games/v1/leaderboards/{leaderboardId}/scores שליחת ניקוד ל-Leaderboard שצוין. |
submitMultiple |
POST /games/v1/leaderboards/scores שליחת מספר ניקוד ללידרבורד. |
משאב ל-REST: snapshots
שיטות | |
---|---|
get |
GET /games/v1/snapshots/{snapshotId} אחזור המטא-נתונים של מזהה קובץ snapshot נתון. |
list |
GET /games/v1/players/{playerId}/snapshots מאחזר רשימה של תמונות מצב שנוצרו על ידי האפליקציה שלך עבור הנגן התואם למזהה הנגן. |
מקור מידע ל-REST: נתונים סטטיסטיים
שיטות | |
---|---|
get |
GET /games/v1/stats מחזיר נתונים סטטיסטיים של מעורבות והוצאות באפליקציה הזו עבור המשתמש המאומת הנוכחי. |