方法: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 概述

集合

枚举
CONNECTED

按反时间顺序检索也在玩此游戏的玩家列表。

VISIBLE

检索用户社交网络中对本游戏可见的玩家列表。

FRIENDS_ALL 按字母顺序检索是用户朋友的玩家列表。