playtest コマンドは、
パートナー センターでゲームのプレイテストを読み取り、作成、更新、公開、削除します。create、
update、publish、delete は、変更を行う前に確認を求めます。
create、update、publish、delete は試験段階 (Experimental) です。オプションと出力は変更または
削除される可能性があります。試験段階のコマンドを参照してください。
コマンド
引数とオプション
例
プレイテストを一覧表示し、1 つを取得して、2 つを比較します。プレイテストの読み取り
playtest list は playtests 配列を書き込みます。テーブルには PLAYTEST ID、NAME、STATUS、TYPE、
START、END の列があります。抜粋を次に示します。
playtest get は、サービスから返されたとおりにプレイテストを書き込みます。etag は
update --if-match に渡すバージョンで、audiences.audienceIds には参加できる対象ユーザーが一覧表示されます。テーブルには
FIELD と VALUE の行があります。
playtest diff は hasDiffData、current、compared を書き込みます。hasDiffData が false の場合、
比較するものはなく、compared は省略されます。テーブルには、異なるフィールドのみが FIELD、CURRENT、
COMPARED の列に表示されます。画像は比較されません。
プレイテストの作成
playtest create は非公開の下書きプレイテストを作成し、playtest get と同じ形式で書き込みます。
もう一度実行すると、別のプレイテストが作成されます。不要なプレイテストは
playtest delete で削除します。
作成のたびに冪等性キーが送信されます。--idempotency-key を渡さない場合、キーは新しい GUID になります。
キーが重複する作成では、そのキーで作成されたプレイテストが返され、異なるオプションは無視されます。
タイムアウト後など、結果が不明な場合、コマンドは終了コード 3 で終了し、同じキーで再試行する
コマンドを表示します。
--idempotency-key とそのキーを付けて
実行してください。終了日が過ぎているなどの理由で再試行が拒否された場合は、新しいキーでプレイテストを作成する前に
playtest list を確認してください。
パッケージ
プレイテストには、PC パッケージと本体パッケージを 1 つずつ設定できます。xbox package list から
プレイテストの準備ができているパッケージを選択し、その id をプラットフォームに対応するオプションに
渡します。
update では、省略したパッケージ オプションのパッケージは保持され、新しい ID を指定すると置き換えられ、"" を指定すると
削除されます。
プレイテストの更新
playtest update は渡したオプションのみを変更します。少なくとも 1 つのオプションが必要です。更新された
プレイテストを playtest get と同じ形式で書き込みます。パートナー センターで構成されたゲームのアートは保持されます。
プレイテストにリンクされているその他のアートは、プレースホルダーに置き換えられます。
他のユーザーの変更を上書きしないようにするには、playtest get から取得した etag を --if-match に渡します。
etag を囲む二重引用符は省略可能です。*、弱い (W/) etag、および etag のリストは
拒否されます。
3 で終了します。再試行する前に、playtest get でプレイテストを確認してください。
対象ユーザーの選択
対象ユーザーは、販売者がパートナー センターで管理する、テスターなどのプレイヤーのグループです。audience list から取得した id を --audience-id に渡します。複数指定するには繰り返します。
--audience-id を指定しない場合、create は対象ユーザーのないプレイテストを作成し、update は既存の対象ユーザーを保持します。
update では、渡した ID によってプレイテストのすべての対象ユーザーが置き換えられます。すべての対象ユーザーを削除するには、
"" のみを渡します。
"" を対象ユーザー ID と組み合わせることはできず、create では拒否されます。プレイテストを公開するには、
少なくとも 1 つの対象ユーザーが必要です。
プレイテストの公開
ゲームで XBOX サービスを使用する場合は、公開する前に XBOX サービスの構成と公表解禁を設定してください。 プレイテストで XBOX サービスを使用するを参照してください。412 で失敗し、何も変更されません。
確認を求める前に、コマンドは公表解禁日がプレイテストの終了日より後かどうかなど、ゲームの XBOX サービスのセットアップを
チェックし、確認が必要な項目を stderr に一覧表示します。これらのチェックは助言のみを目的としています。--confirm を指定すると、確認を求めずに公開されます。
その後、サービスが独自のチェックを実行します。いずれかのチェックによって公開がブロックされた場合、何もキューに登録されず、
コマンドは各チェックを stderr に一覧表示して終了コード 1 で終了します。エラーを修正して、もう一度公開してください。
年齢別レーティングがないためにブロックされたプレイテストでは、パートナー センターで年齢別レーティングのアンケートに回答する必要があります。
公開がキューに登録されると、コマンドはプレイテストが Scheduled、Live、または
PublishFailed になるまで待機し、playtest get と同じ形式で書き込みます。Ctrl+C を押すと待機は停止しますが、公開は
続行されます。--no-wait を指定すると、コマンドは公開がキューに登録された時点で publishJobId と warnings (ある場合) を
書き込みます。その後は playtest get で状況を確認してください。
プレイテストの削除
playtest delete は、最初に読み取ったバージョンのプレイテストを削除します。プレイテストが
Deleted になるか存在しなくなるまで待機し、その後 status を含むサービスの応答を書き込みます。Ctrl+C を押すと待機は停止しますが、
削除は続行されます。--no-wait を指定すると、削除がキューに登録された時点で応答を書き込みます。
412 の後は、削除が既にキューに登録されている可能性があるため、1 分待ってから playtest get で確認し、
その後でもう一度削除してください。
日付
--start と --end には、2026-11-01T09:00:00-07:00 や 2026-11-01T16:00:00Z などの ISO 8601 形式の日付と時刻を
指定できます。時刻のない日付は UTC の午前 0 時を意味し、オフセットのない時刻は
UTC として扱われます。更新で日付を 1 つだけ渡した場合、サービスはその日付をプレイテストのもう一方の日付と照らし合わせてチェックします。
エラー
上記の終了コードの表で別途示されている場合を除き、失敗は stderr に出力され、終了コード1 で終了します。create と
update は、結果が不明な場合に終了コード 3 で終了します。サービスから返された失敗には HTTP
状態が含まれます。--verbose を指定するとサービスの応答が追加されます。応答の code フィールドを次の表に示します。
その他の失敗では、コマンドはサービスのメッセージを表示します。429 は送信したリクエストが多すぎることを意味します。
もう一度試す前に、メッセージに示されている時間だけ待ってください。
