נדרשת הרשאה
קבלת רשימת הנגנים שמוסתרת מהאפליקציה הנתונה. השיטה הזו זמינה רק לחשבונות משתמשים ב-Developer Console.
בקשה
בקשת HTTP
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
פרמטרים
שם הפרמטר | ערך | תיאור |
---|---|---|
פרמטרים של נתיב | ||
applicationId |
string |
מזהה האפליקציה מ-Google Play Console. |
פרמטרים אופציונליים של שאילתה | ||
maxResults |
integer |
המספר המקסימלי של משאבי הנגן שאפשר להחזיר בתשובה, המשמש לחלוקה לדפים. בכל תגובה, המספר של משאבי השחקנים שמוחזרים בפועל עשוי להיות קטן מהערך שצוין ב-maxResults .
הערכים הקבילים הם 1 עד 15 , כולל.
|
pageToken |
string |
האסימון שהוחזר בעקבות הבקשה הקודמת. |
אישור
הבקשה הזו מחייבת הרשאה עם ההיקף הבא (מידע נוסף על אימות והרשאה).
היקף |
---|
https://www.googleapis.com/auth/games |
גוף הבקשה
אל תספקו גוף בקשה בשיטה הזו.
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה גוף תגובה עם המבנה הבא:
{ "kind": "gamesManagement#hiddenPlayerList", "nextPageToken": string, "items": [ { "kind": "gamesManagement#hiddenPlayer", "player": { "kind": "gamesManagement#player", "playerId": string, "displayName": string, "avatarImageUrl": string, "lastPlayedWith": { "timeMillis": long, "autoMatched": boolean }, "name": { "familyName": string, "givenName": string }, "experienceInfo": { "currentExperiencePoints": long, "lastLevelUpTimestampMillis": long, "currentLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long }, "nextLevel": { "level": integer, "minExperiencePoints": long, "maxExperiencePoints": long } }, "title": string }, "hiddenTimeMillis": long } ] }
שם הנכס | ערך | תיאור | הערות |
---|---|---|---|
kind |
string |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה gamesManagement#hiddenPlayerList . |
|
nextPageToken |
string |
אסימון החלוקה לדפים של דף התוצאות הבא. | |
items[] |
list |
השחקנים. | |
items[].kind |
string |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה gamesManagement#hiddenPlayer . |
|
items[].player |
nested object |
פרטי הנגן. | |
items[].player.kind |
string |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה gamesManagement#player . |
|
items[].player.playerId |
string |
מזהה השחקן. | |
items[].player.displayName |
string |
השם שיוצג עבור הנגן. | |
items[].player.avatarImageUrl |
string |
כתובת ה-URL הבסיסית של התמונה שמייצגת את הנגן. | |
items[].player.lastPlayedWith |
nested object |
פרטים על הפעם האחרונה שבה שחקן זה שיחק במשחק רב-משתתפים עם השחקן המאומת. מאוכלס עבור חברים באוסף שחקנים PLAYED_WITH. | |
items[].player.lastPlayedWith.timeMillis |
long |
הפעם האחרונה שבה השחקן שיחק במשחק באלפיות השנייה מאז נקודת ההתחלה של שעון UTC. | |
items[].player.lastPlayedWith.autoMatched |
boolean |
הערך הוא True אם הנגן הותאם באופן אוטומטי למשתמש המאומת הנוכחי. | |
items[].player.name |
object |
ייצוג אובייקט של הרכיבים הבודדים בשם השחקן. יכול להיות שהשדות האלה לא יהיו זמינים בחלק מהנגנים. | |
items[].player.name.familyName |
string |
שם המשפחה של השחקן הזה. במקומות מסוימים, הוא נקרא שם המשפחה. | |
items[].player.name.givenName |
string |
השם הפרטי של השחקן הזה. במקומות מסוימים, זה נקרא השם הפרטי. | |
items[].player.experienceInfo |
nested object |
אובייקט שמייצג את המידע על חוויית המשחק ב-Play Games של הנגן. | |
items[].player.experienceInfo.currentExperiencePoints |
long |
המספר הנוכחי של נקודות הניסיון של השחקן. | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
חותמת הזמן שבה השחקן התקדם לשלב הבא, באלפיות השנייה מאז תאריך יוניקס (Unix epoch) לפי שעון UTC. | |
items[].player.experienceInfo.currentLevel |
nested object |
הרמה הנוכחית של הנגן. | |
items[].player.experienceInfo.currentLevel.level |
integer |
הרמה שבה נמצא המשתמש. | |
items[].player.experienceInfo.currentLevel.minExperiencePoints |
long |
נקודות הניסיון המינימליות לרמה הזו. | |
items[].player.experienceInfo.currentLevel.maxExperiencePoints |
long |
מספר נקודות הניסיון המקסימלי לרמה הזו. | |
items[].player.experienceInfo.nextLevel |
nested object |
הרמה הבאה של הנגן. אם הרמה הנוכחית היא הרמה המקסימלית, היא צריכה להיות זהה לרמה הנוכחית. | |
items[].player.experienceInfo.nextLevel.level |
integer |
הרמה שבה נמצא המשתמש. | |
items[].player.experienceInfo.nextLevel.minExperiencePoints |
long |
נקודות הניסיון המינימליות לרמה הזו. | |
items[].player.experienceInfo.nextLevel.maxExperiencePoints |
long |
מספר נקודות הניסיון המקסימלי לרמה הזו. | |
items[].player.title |
string |
השם של השחקן מתגמל על הפעילויות שלו במשחק. |