Applications: listHidden

נדרשת הרשאה

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