שירות המשחקים של Google Play מאפשר למפתחים לשפר משחקים באמצעות לידרבורד ברשתות חברתיות, הישגים, מצב המשחק, כניסה באמצעות חשבון Google ועוד.
- משאב REST: אסימוני גישה
- משאבים ל-REST: הגדרות הישג
- משאב REST: הישגים
- משאב REST: אפליקציות
- משאב REST: אירועים
- משאב REST: לוחות לידרבורד
- משאב REST: מטא-משחק
- משאב REST: נגנים
- משאב REST: ריקול
- משאב REST: גרסאות קודמות
- משאב REST: ציונים
- משאב REST: קובצי snapshot
- משאב REST: נתונים סטטיסטיים
שירות: Games.googleapis.com
כדי להתקשר לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה שלכם צריכה להשתמש בספריות משלכם כדי לקרוא לשירות הזה, עליכם להשתמש במידע הבא בזמן שליחת בקשות ה-API.
מסמך Discovery
מסמך Discovery הוא מפרט קריא למחשבים לתיאור ולצריכה של ממשקי API ל-REST. אפשר להשתמש בו כדי ליצור ספריות לקוח, יישומי פלאגין של סביבת פיתוח משולבת (IDE) וכלים אחרים שיוצרים אינטראקציה עם Google APIs. שירות אחד עשוי לספק כמה מסמכי גילוי. השירות הזה מספק את מסמך הגילוי הבא:
נקודת קצה (endpoint) של שירות
נקודת קצה (endpoint) של שירות היא כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. לשירות אחד יכולות להיות כמה נקודות קצה (endpoint) של שירות. השירות הזה כולל את נקודת הקצה הבאה של השירות, וכל מזהי ה-URI שבהמשך הם יחסיים לנקודת הקצה הזו של השירות:
https://games.googleapis.com
משאב REST: accesstokens
שיטות | |
---|---|
generatePlayGroupingApiToken |
POST /games/v1/accesstokens/generatePlayGroupingApiToken יוצרת אסימון של Play Grouping API בשביל המשתמש ב-PGS שמזוהה באמצעות פרטי הכניסה המצורפים. |
generateRecallPlayGroupingApiToken |
POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken יוצר אסימון של Play Grouping API בשביל המשתמש ב-PGS שמזוהה לפי מזהה הסשן של Recall שצוין בבקשה. |
REST Resource: achievementDefinitions
שיטות | |
---|---|
list |
GET /games/v1/achievements רשימה של כל הגדרות ההישגים של האפליקציה שלכם. |
משאב REST: achievements
שיטות | |
---|---|
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} אחזור המטא-נתונים של ה-Leaderboard עם המזהה הנתון. |
list |
GET /games/v1/leaderboards מפרט את כל המטא-נתונים של הלידרבורד של האפליקציה שלך. |
משאב REST: metagame
שיטות | |
---|---|
getMetagameConfig |
GET /games/v1/metagameConfig החזרת נתוני התצורה של המטא-משחק עבור אפליקציית הקריאה. |
listCategoriesByPlayer |
GET /games/v1/players/{playerId}/categories/{collection} הצגת רשימה של נתוני הפעלה שנצברו לכל קטגוריה של הנגן התואם ל- playerId . |
משאב REST: שחקנים
שיטות | |
---|---|
get |
GET /games/v1/players/{playerId} מאחזר את משאב Player עם המזהה הנתון. |
getMultipleApplicationPlayerIds |
GET /games/v1/players/me/multipleApplicationPlayerIds קבלת מזהי הנגן של האפליקציות של השחקן המאומת בכל המשחקים המבוקשים על ידי אותו מפתח כמו אפליקציית הקריאה. |
getScopedPlayerIds |
GET /games/v1/players/me/scopedIds אחזור של מזהי נגנים בהיקף של משתמשים מאומתים נוכחיים. |
list |
GET /games/v1/players/me/players/{collection} קבלת אוסף הנגנים של המשתמש המאומת. |
משאב REST: recall
שיטות | |
---|---|
gamesPlayerTokens |
GET /games/v1/recall/gamesPlayerTokens/{sessionId} מאחזרים את אסימוני Recall מכל המשחקים המבוקשים שמשויכים לנגן PGS שמקודד במזהה סשן הריקול שסופק. |
lastTokenFromAllDeveloperGames |
GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId} מאחזרים את אסימון הריקול האחרון מכל משחקי הפיתוח המשויך לנגן PGS המקודד במזהה סשן הריקול שסופק. |
linkPersona |
POST /games/v1/recall:linkPersona שיוך חשבון המשתמש של הנגן ב-PGS שמקודד במזהה סשן הריקול שסופק לחשבון מתוך המשחק |
resetPersona |
POST /games/v1/recall:resetPersona מוחקים את כל אסימוני Recall שמקשרים את הפרסונה הנתונה לכל שחקן (עם או בלי פרופיל). |
retrieveTokens |
GET /games/v1/recall/tokens/{sessionId} אחזור כל אסימוני Recall המשויכים לנגן PGS שמקודדים במזהה סשן הריקול שסופק. |
unlinkPersona |
POST /games/v1/recall:unlinkPersona מחיקת אסימון ריקול שמקשר את חשבון המשתמש של השחקן ב-PGS שזוהה בסשן Recall לחשבון בתוך המשחק שמזוהה על ידי ה'פרסונה' או לפי ערך האסימון. |
משאב 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} אחזור המטא-נתונים של מזהה תמונת מצב נתון. |
list |
GET /games/v1/players/{playerId}/snapshots מאחזר רשימה של תמונות מצב שנוצרו על ידי האפליקציה עבור הנגן התואם למזהה הנגן. |
משאב REST: stats
שיטות | |
---|---|
get |
GET /games/v1/stats הפונקציה מחזירה נתונים סטטיסטיים לגבי המעורבות וההוצאות באפליקציה הזו עבור המשתמש המאומת. |