נדרשת הרשאה
קבל את רשימת הנגנים המוסתרת באפליקציה הנתונה. השיטה הזו זמינה רק לחשבונות משתמש ב-Play Console.
בקשה
בקשת HTTP
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
פרמטרים
שם הפרמטר | Value | התיאור |
---|---|---|
פרמטרים של נתיב | ||
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 } ] }
שם הנכס | Value | התיאור | הערות |
---|---|---|---|
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 עבור השחקן. | |
items[].player.experienceInfo.currentExperiencePoints |
long |
המספר הנוכחי של נקודות ניסיון של השחקן. | |
items[].player.experienceInfo.lastLevelUpTimestampMillis |
long |
חותמת הזמן של ההתקדמות לשלב הבא של השחקן, באלפיות השנייה מאז תחילת מערכת Unix לפי שעון 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 |
תואר השחקן מקבל תגמול על פעילויות המשחק שלו. |