方法:players.list

获取当前认证用户的玩家集合。

HTTP 请求

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

路径参数

参数
collection

枚举 (Collection)

要检索的玩家集合

查询参数

参数
language

字符串

此方法返回的字符串的首选语言。

maxResults

整数

响应中返回的玩家资源的最大数量,用于分页。对于任何响应,返回的玩家资源实际数量可能小于指定的 maxResults

pageToken

字符串

上一个请求返回的令牌。

请求正文

请求正文必须为空。

响应正文

第三方玩家列表响应。

如果成功,响应正文包含以下结构的数据

JSON 表示
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (Player)
    }
  ]
}
字段
kind

字符串

唯一标识此资源的类型。值始终是固定字符串 games#playerListResponse

nextPageToken

字符串

对应下一页结果的令牌。

items[]

对象 (Player)

玩家。

授权范围

需要以下任一 OAuth 范围

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

有关更多信息,请参阅OAuth 2.0 概览

Collection

枚举
CONNECTED

按时间倒序检索同时玩此游戏的玩家列表。

VISIBLE

检索用户社交图谱中对此游戏可见的玩家列表。

FRIENDS_ALL 按字母顺序检索用户好友列表。