audience 命令可列出及取得賣方的對象、建立已知使用者對象,以及重新命名對象或取代其成員。若要讓對象加入試玩測試,請將其 id 傳遞給 playtest create 或 playtest update;請參閱選擇對象。
audience 為實驗性功能:其命令、選項和輸出可能會變更或移除。請參閱實驗性命令。列出及取得對象需要具備該賣方的 Partner Center 客戶群組讀取權限,而建立及更新對象則需要寫入權限。
命令
CLI 無法刪除對象或變更其類型;請在 Partner Center 中執行這些操作。
引數和選項
輸出
audience get 會寫入一個對象:
audience list 會寫入由相同物件組成的 audiences 陣列 (不含 members),沒有任何對象時則寫入 {"audiences":[]}。create 和 update 會以與 get 相同的方式寫入對象。
使用 --output table 時,每個命令都會顯示 ID、NAME 和 TYPE 欄,其中 TYPE 為 groupType。成員只會出現在 JSON 輸出中。
建立對象
--members-file 時,對象沒有任何成員。每次執行都會建立新的對象,即使已有同名的對象也一樣。
更新對象
傳遞--name、--members-file 或兩者;未指定的部分會保留。下列命令會重新命名對象:
testers.txt 中的位址取代其成員:
成員檔案
成員檔案是 UTF-8 文字,每行一個電子郵件地址,最多 1000 個成員:結束代碼
create 和 update 只會傳送一次要求。結束代碼為 3 之後,請先檢查再重新執行命令:
- 在
create之後,執行 stderr 所顯示的xbox audience list --name命令。找到相符項目只能作為參考,因為名稱不必是唯一的,而再次執行create可能會建立第二個對象。 - 在
update之後,執行xbox audience get <audience-id>以檢查其名稱和成員。
錯誤
無論--output 為何,錯誤都會以文字形式傳送到 stderr,其中包含相互關聯識別碼、針對 HTTP 狀態的指引,以及服務的錯誤詳細資料 (如果有的話)。--verbose 會加入服務的回應,其中可能包含成員。指令碼應根據結束代碼而非文字內容來分支。
403 可能表示缺少權限、您不屬於該賣方,或該賣方未啟用試玩測試。在 list 和 get 上,拒絕可能會改以 502 呈現;請檢查錯誤詳細資料以了解原因。建立及更新對象的功能正在逐步推出,您可能尚無法使用;在推出之前,create 和 update 會失敗,且不會變更任何內容。
