跳轉到主要內容
game 命令可列出賣方的 Partner Center 遊戲、依 Store ID、XBOX 遊戲識別碼或名稱查閱遊戲、建立遊戲,以及檢查其建立作業。 每個命令都會作用於一個賣方,該賣方來自 --seller-id 或您已儲存的賣方;請參閱內容。如果您屬於多個賣方,請參閱此已知問題:這些命令可能會使用另一個賣方。

命令

引數

選項

game get 至少需要 title-id、--store-id 或 --keyword 其中之一。位置值一律為 XBOX 遊戲識別碼;當它看起來像 Store ID 時,錯誤會建議使用搭配 --store-id 的相同命令:

列出和查閱

game list 會傳回賣方的整個目錄,而搭配 --keyword 的 game get 會搜尋整個目錄。讀取大型目錄可能需要幾分鐘,命令會在 stderr 上顯示其進度。沒有分頁選項;請使用 less 或 more 將輸出分頁。如果要求失敗,命令不會列印部分結果,並會將相互關聯識別碼寫入 stderr。每個要求會在兩分鐘後逾時;若要變更此值,請設定 XboxPartner:TimeoutSeconds (請參閱組態)。

輸出

JSON 輸出是一個 games 陣列。每個遊戲都有下列欄位: game create 和 game job get 會寫入建立作業。遊戲建立之後,就會出現具有相同欄位的 game 欄位。

表格輸出

list 和 get 接受 --output table,每個 XBOX 遊戲識別碼一列,並包含下列欄:TITLE ID、STORE IDS、PRODUCT NAME、MSA APP ID 和 PACKAGE FAMILY NAME。遊戲的 Store ID 和其他值會共用同一列,過長的值會被截斷。create 和 job get 會拒絕 --output table。

詳細資料檢視

--details 會為每個遊戲識別碼列印一個區塊,其中包含其下的每個遊戲及其所有識別碼 (包括 SCID 和開發沙箱),且不會截斷。遺漏的值會顯示為 -。使用 --details 或 --output table 時,結果計數和持續時間會傳送到 stderr。

建立遊戲

game create 在建立遊戲之前會先詢問;沒有終端機時,需要 --confirm。CLI 無法刪除遊戲。如果您屬於多個賣方,請先查看此已知問題:遊戲可能會建立在另一個賣方中。 命令只會傳送一次要求、最多等候建立作業兩分鐘,並將作業寫入 stdout。作業 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日