Method: players.list

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

HTTP 要求

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

路徑參數

參數
collection

enum (Collection)

要擷取的玩家集合

查詢參數

參數
language

string

此方法傳回字串的偏好語言。
maxResults

integer

回應中傳回的玩家資源數量上限，用於分頁。針對任何回應，傳回的玩家資源實際數量可能少於指定的 maxResults。
pageToken

string

先前要求傳回的權杖。

要求主體

要求主體必須為空白。

回應主體

第三方播放器清單回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (Player)
    }
  ]
}
欄位
kind

string

專門用於識別這項資源的類型。值一律為固定字串 games#playerListResponse。
nextPageToken

string

與結果下一頁相對應的權杖。
items[]

object (Player)

玩家。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

詳情請參閱 OAuth 2.0 總覽。

集合

列舉
CONNECTED

擷取也在依時間排序的玩家名單。
VISIBLE

從玩家的社交圖表中擷取玩家清單。
FRIENDS_ALL 依字母順序擷取使用者好友的玩家名單。