需要授權
取得從指定應用程式隱藏的玩家清單。這個方法僅適用於您開發人員控制台的使用者帳戶。
要求
HTTP 要求
GET https://www.googleapis.com/games/v1management/applications/applicationId/players/hidden
參數
參數名稱 | 值 | 說明 |
---|---|---|
路徑參數 | ||
applicationId |
string |
Google Play 管理中心的應用程式 ID。 |
自選查詢參數 | ||
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 |
玩家的 ID。 | |
items[].player.displayName |
string |
播放器的顯示名稱。 | |
items[].player.avatarImageUrl |
string |
代表播放器的圖片基準網址。 | |
items[].player.lastPlayedWith |
nested object |
這個玩家上次透過目前驗證的玩家玩多人遊戲的時間詳細資料。對 PLAYED_WITH 玩家收藏成員填入資料。 | |
items[].player.lastPlayedWith.timeMillis |
long |
玩家上次玩遊戲的時間,以毫秒為單位自 Epoch 紀元時間 (世界標準時間) 起算。 | |
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 紀元 (世界標準時間) 開始計算。 | |
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 |
玩家的遊戲活動獎勵。 |