跳转到主要内容
game 命令可列出卖家的 Partner Center 游戏、按 Store ID、XBOX 游戏 ID 或名称查找游戏、创建游戏,以及检查其创建作业。 每个命令都作用于一个卖家,该卖家来自 --seller-id 或你已保存的卖家;请参阅 上下文。如果你属于多个卖家,请参阅 此已知问题:这些命令可能会使用其他卖家。

命令

参数

选项

game get 至少需要 title-id、--store-id 或 --keyword 中的一个。位置值始终是 XBOX 游戏 ID;如果它看起来像 Store ID,错误会建议改用带有 --store-id 的相同命令:

列出和查找

game list 返回卖家的整个目录,带有 --keyword 的 game get 会搜索整个目录。读取大型目录可能需要几分钟时间,该命令会在 stderr 上显示其 进度。没有分页选项;请使用 less 或 more 对输出进行分页。如果请求失败,该命令不会输出部分结果,并会将关联 ID 写入 stderr。每个请求在两分钟后超时;若要更改此值,请设置 XboxPartner:TimeoutSeconds(请参阅配置)。

输出

JSON 输出是一个 games 数组。每个游戏都有以下字段: game create 和 game job get 写入创建作业。游戏存在后,作业中会出现具有相同字段的 game 字段。

表格输出

list 和 get 接受 --output table,每个 XBOX 游戏 ID 一行,包含以下列: TITLE ID、STORE IDS、PRODUCT NAME、MSA APP ID 和 PACKAGE FAMILY NAME。游戏的 Store ID 和其他值共享该游戏的行,过长的值会被截断。create 和 job get 拒绝 --output table。

详细信息视图

--details 为每个游戏 ID 输出一个块,其中包含该 ID 下的每个游戏及其所有标识符(包括 SCID 和开发沙盒),且不会截断。缺少的值显示为 -。使用 --details 或 --output table 时,结果计数和持续时间会输出到 stderr。

创建游戏

game create 会在创建游戏之前进行询问;如果没有终端,则需要 --confirm。CLI 无法删除游戏。如果你属于多个卖家,请先查看 该已知问题:游戏可能会在其他卖家中创建。 该命令只发送一次请求,最多等待两分钟以完成创建作业,然后将作业写入 stdout。作业 ID、关联 ID 以及用于检查作业的命令会输出到 stderr。如果等待先结束,作业会继续运行:请使用 game job get 检查它,不要再次创建游戏。 如果请求失败,stderr 会说明是否可能已创建游戏:
  • 当请求未发送或服务拒绝了请求(例如对于游戏无法使用的沙盒返回 400)时,未创建任何游戏。请解决问题,然后再次运行该命令。
  • 在出现服务器错误、超时或连接丢失后,结果未知。在重试之前,请使用 stderr 上输出的命令检查 game list。

检查创建作业

job get 只执行读取,因此你可以根据需要随时运行它。已成功的作业仍可能在其 errors 字段中报告问题。

退出代码

不要根据退出代码来决定是否再次运行 create。如果 stderr 说明未创建任何游戏,请解决错误并再次运行;否则,请使用其输出的 game job get 或 game list 命令进行检查。

端到端示例

保存一次卖家,然后创建游戏,该命令会使用此卖家:
如果等待在作业完成之前结束,请检查作业,而不是再次创建游戏。请使用 game create 在 stderr 上输出的作业 ID:
作业成功后,查找该游戏:
最后修改于 2026年11月19日