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 概览。

Collection

定义要返回数据的类别。

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

MetagameCategory

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

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

string

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

string

类别名称。
experiencePoints

string (int64 format)

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