Google Play Game Services

שירות המשחקים של Google Play מאפשר למפתחים לשפר משחקים באמצעות לידרבורד ברשתות חברתיות, הישגים, מצב המשחק, כניסה באמצעות חשבון Google ועוד.

שירות: 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
הפונקציה מחזירה נתונים סטטיסטיים לגבי המעורבות וההוצאות באפליקציה הזו עבור המשתמש המאומת.