Applications: listHidden

נדרשת הרשאה

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