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 のアドレスに置き換えます。
メンバー ファイル
メンバー ファイルは、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 は何も変更せずに失敗します。
