Players: list

注意：需要授權。

取得目前已驗證使用者的玩家集合。立即試用。

要求

HTTP 要求

GET https://www.googleapis.com/games/v1/players/me/players/collection

參數

參數名稱	值	說明
路徑參數
collection	string	正在擷取的玩家集合 可接受的值如下： 「connected」：(已不適用) 擷取其他玩家在依時間先後順序進行遊戲的進度清單。 "friends_all"：擷取按字母順序排列的使用者好友清單。 「playedWith」(已淘汰) 擷取您近期玩多人遊戲 (即時或回合製) 的玩家清單。 「played_with」(已淘汰) 擷取您近期玩多人遊戲 (即時或回合製) 的玩家清單。 「visible」：(已不適用：請使用 FRIENDS_ALL) 擷取使用者在社交關係圖表中，可查看這個遊戲的玩家清單。
選用查詢參數
language	string	此方法傳回的字串偏好語言。
maxResults	integer	回應中傳回的播放器資源數量上限，用於分頁。無論是哪種回應，實際傳回的玩家資源數量都可能少於指定的 maxResults。可接受的值為 1 到 50 (含首尾)。
pageToken	string	先前要求傳回的符記。

授權

此要求需要以下範圍的授權：

範圍
https://www.googleapis.com/auth/games

詳情請參閱驗證和授權頁面。

要求主體

請不要透過此方法提供請求主體。

回應

如果成功的話，這個方法會傳回回應內文，其結構如下：

{
  "kind": "games#playerListResponse",
  "nextPageToken": string,
  "items": [
    players Resource
  ]
}

屬性名稱	值	說明	Notes
kind	string	用於識別這項資源的類型。值一律為固定字串 games#playerListResponse。
nextPageToken	string	下一頁的結果對應符記。
items[]	list	玩家

試試看！

使用 APIs Explorer 針對即時資料呼叫這個方法，並查看回應。