メインコンテンツへスキップ
対象ユーザーは、テスターなど、販売者がコンテンツの対象にできるプレイヤーまたはデバイスの名前付きグループです。 パートナー センターでは、これを顧客グループと呼びます。audience コマンドは、販売者の対象ユーザーを一覧表示および 取得し、既知のユーザーの対象ユーザーを作成し、対象ユーザーの名前を変更したりメンバーを置き換えたりします。対象ユーザーが プレイテストに参加できるようにするには、その id を playtest create または playtest update に渡します。 対象ユーザーの選択を参照してください。 audience は試験段階 (Experimental) です。コマンド、オプション、出力は変更または削除される可能性があります。 試験段階のコマンドを参照してください。対象ユーザーの一覧表示と取得には、 販売者に対するパートナー センターの顧客グループの読み取り権限が必要であり、作成と更新には書き込み権限が 必要です。

コマンド

CLI では、対象ユーザーを削除したり、種類を変更したりすることはできません。これらはパートナー センターで行ってください。

引数とオプション

出力

audience get は対象ユーザーを 1 つ書き込みます。
audience list は、同じオブジェクトから members を除いた audiences 配列を書き込み、対象ユーザーがない場合は {"audiences":[]} を書き込みます。create と update は、get と同じように対象ユーザーを書き込みます。 --output table を指定すると、すべてのコマンドで ID、NAME、TYPE の列が表示されます。TYPE は groupType です。メンバーは JSON 出力にのみ含まれます。

対象ユーザーの作成

--members-file を指定しない場合、対象ユーザーにメンバーはいません。同じ名前の対象ユーザーが存在する場合でも、 実行するたびに新しい対象ユーザーが作成されます。

対象ユーザーの更新

--name、--members-file、またはその両方を渡します。省略したものは保持されます。次の例では、対象ユーザーの名前を変更します。
次の例では、メンバーを testers.txt のアドレスに置き換えます。
--members-file はメンバー リスト全体を置き換えます。ファイルに含まれていないメンバーは削除され、 空のファイルを指定するとすべてのメンバーが削除されます。メンバーを 1 人追加または削除するには、audience get でリストを読み取り、 変更してから、リスト全体を渡します。
更新は他の変更と照合されません。2 人が同時に対象ユーザーを更新した場合は、 最後の更新が優先されます。

メンバー ファイル

メンバー ファイルは、1 行に 1 つのメール アドレスを記述した UTF-8 テキストで、最大 1000 メンバーまで指定できます。
空白行と各行の前後のスペースは無視されます。サービスは各メンバーをチェックしますが、メンバーが保存されていても、 そのメンバーが対象ユーザー向けのコンテンツを表示できるアカウントに解決されるとは限りません。

終了コード

create と update は要求を 1 回だけ送信します。終了コード 3 の後は、コマンドを再実行する前に 確認してください。
  • create の後は、stderr に表示される xbox audience list --name コマンドを実行します。名前は一意である必要がないため、 一致したものはヒントにすぎません。また、create を再実行すると 2 つ目の対象ユーザーが作成される可能性があります。
  • update の後は、xbox audience get <audience-id> を実行して名前とメンバーを確認します。

エラー

エラーは --output の値にかかわらずテキストとして stderr に出力され、相関 ID、HTTP ステータスに応じたガイダンス、 およびサービスのエラーの詳細 (ある場合) が含まれます。--verbose を指定するとサービスの応答が追加され、 これにはメンバーが含まれる場合があります。スクリプトでは、文言ではなく終了コードで分岐してください。 403 は、権限がないこと、販売者に所属していないこと、または販売者に対してプレイテストが有効になっていないことを 示している可能性があります。list と get では、拒否が代わりに 502 として表示される場合があります。原因については エラーの詳細を確認してください。対象ユーザーの作成と更新は段階的にロールアウト中であり、まだ利用できない場合があります。 利用可能になるまでは、create と update は何も変更せずに失敗します。

例

対象ユーザーを一覧表示および取得します。
確認プロンプトなしで対象ユーザーを作成します。
対象ユーザーのメンバーを置き換え、結果を表として表示します。
最終更新日 2026年11月19日