Google Play Game Services

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

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