需要授權
取得在特定應用程式中隱藏的玩家清單。這種方法僅適用於 Play 管理中心的使用者帳戶。
要求
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 紀元 (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 |
獎勵玩家的遊戲活動提供獎勵。 |