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 按字母顺序检索与用户是好友的玩家列表。