Method: metagame.listCategoriesByPlayer

列出与 playerId 对应的播放器按类别汇总的播放数据。

HTTP 请求

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

路径参数

参数
playerId

string

玩家 ID。可以使用值 me 来代替经过身份验证的玩家的 ID。
collection

enum (Collection)

要返回其数据的类别集合。

查询参数

参数
language

string

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

integer

响应中可返回的类别资源数量上限，用于分页。对于任何响应，返回的类别资源的实际数量都可能少于指定的 maxResults。
pageToken

string

上一个请求返回的令牌。

请求正文

请求正文必须为空。

响应正文

第三方列表元游戏类别响应。

如果成功，响应正文将包含结构如下的数据：

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

string

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

string

对应于下一页结果的令牌。
items[]

object (MetagameCategory)

包含使用情况数据的类别列表。

授权范围

需要以下 OAuth 范围之一：

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

有关详情，请参阅 OAuth 2.0 概览。

集合

定义要返回哪些类别的数据。

枚举
ALL 检索所有类别的数据。这是默认值。

MetagameCategory

与各个游戏类别相关的数据。

JSON 表示法 
{
  "kind": string,
  "category": string,
  "experiencePoints": string
}
字段
kind

string

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

string

类别名称。
experiencePoints

string (int64 format)

在此类别中获得的经验值。