Method: accounts.gamecenters.games.list

列出指定游戏中心内的游戏。

HTTP 请求

GET https://gamesnackspartner.googleapis.com/v1/{parent=accounts/*/gamecenters/*}/games

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必填。相应游戏集合所属的游戏中心。格式:accounts/{account}/gamecenters/{gamecenter}

请求正文

请求正文必须为空。

响应正文

游戏列表 RPC 的响应定义。

如果成功,响应正文将包含采用如下结构的数据:

JSON 表示法
{
  "games": [
    {
      object (Game)
    }
  ]
}
字段
games[]

object (Game)

列表响应中返回的游戏。

Game

游戏的表示形式。

JSON 表示法
{
  "name": string,
  "orientation": enum (Orientation),
  "genres": [
    enum (Genre)
  ],
  "displayName": string,
  "version": string,
  "description": string,
  "embedUri": string,
  "staticContent": {
    object (StaticContent)
  },
  "publishTime": string
}
字段
name

string

必填。游戏名称。格式:accounts/{account}/gamecenters/{gamecenter}/games/{game}

orientation

enum (Orientation)

游戏支持的屏幕方向。

genres[]

enum (Genre)

用于对游戏进行分类的类型列表。

displayName

string

开发者提供的游戏名称。

version

string

开发者提供的游戏版本,例如 v0.9.1

description

string

开发者提供的游戏说明。

embedUri

string

GameCenter URI,用于嵌入指定游戏中心的游戏。

staticContent

object (StaticContent)

游戏的图片和视频。

publishTime

string (Timestamp format)

游戏的首次发布时间。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

StaticContent

游戏静态内容(如图片和视频)的表示形式。

JSON 表示法
{
  "icons": [
    {
      object (Image)
    }
  ],
  "horizontalBanners": [
    {
      object (Image)
    }
  ],
  "verticalBanners": [
    {
      object (Image)
    }
  ],
  "trailers": [
    {
      object (Video)
    }
  ]
}
字段
icons[]

object (Image)

用于表示游戏的图标。多个值代表不同的尺寸。

horizontalBanners[]

object (Image)

游戏的横幅。图片的宽度应大于高度。

verticalBanners[]

object (Image)

游戏的竖幅。图片的高度应大于宽度。

trailers[]

object (Video)

游戏的预告片。

Image

图片的表示形式。

JSON 表示法
{
  "size": {
    object (Size)
  },
  "uri": string
}
字段
size

object (Size)

图片的尺寸。

uri

string

图片的 URI。图像可以是位图(如 PNG)或矢量(如 SVG)格式。

Size

图片尺寸的表示形式。

JSON 表示法
{
  "widthPixels": string,
  "heightPixels": string
}
字段
widthPixels

string (int64 format)

图片的宽度(以像素为单位)。

heightPixels

string (int64 format)

图片的高度(以像素为单位)。

Video

视频的表示形式。

JSON 表示法
{
  "uri": string,
  "size": {
    object (Size)
  }
}
字段
uri

string

视频的 URI。视频可以是 MP4 格式。

size

object (Size)

视频的尺寸。

Size

视频尺寸的表示形式。

JSON 表示法
{
  "widthPixels": string,
  "heightPixels": string
}
字段
widthPixels

string (int64 format)

视频的宽度(以像素为单位)。

heightPixels

string (int64 format)

视频的高度(以像素为单位)。

Orientation

游戏支持的屏幕方向。

枚举
ORIENTATION_UNSPECIFIED 默认值,请勿使用。
ANY 游戏支持横屏模式和竖屏模式。
LANDSCAPE 游戏支持横屏模式。
PORTRAIT 游戏支持竖屏模式。

Genre

用于对游戏进行分类的游戏类别。

枚举
GENRE_UNSPECIFIED 默认值,请勿使用。
ACTION 注重战斗和反应能力。
ADVENTURE 侧重于探索、故事和解谜。
ARCADE 注重快节奏的动作、简单的操控和不断升级的难度。
BOARD 按照特定规则操纵棋盘上的棋子。
CARD 以一副专门的卡牌作为游戏中的主要工具。
CASINO 以模拟传统赌场体验为特色。
CASUAL 侧重于提供直观且容易上手的游戏玩法。
EDUCATIONAL 旨在通过引人入胜的游戏玩法传授技能或概念。
MUSIC 侧重于游戏中的音乐互动。
PUZZLE 挑战玩家的问题解决能力。
RACING 玩家要控制车辆并争取率先到达终点。
ROLE_PLAYING 玩家可在奇幻或科幻世界中做出选择来决定故事情节走向。
SIMULATION 模拟真实世界的活动或场景。
SPORTS 以逼真的游戏玩法再现真实世界中的体育运动。
STRATEGY 侧重于规划、战术和资源管理。
TRIVIA 通过各种主题的问题来测试玩家的知识。
WORD 侧重于词汇、组词和拼写。