audience 명령은 판매자의 대상 그룹을
나열하고 가져오며, 알려진 사용자 대상 그룹을 생성하고, 대상 그룹의 이름을 바꾸거나 구성원을 대체합니다.
대상 그룹이 플레이테스트에 참여할 수 있게 하려면 playtest create 또는 playtest update에 해당
id를 전달하세요.
대상 그룹 선택을 참조하세요.
audience는 실험적 기능입니다. 명령, 옵션 및 출력이 변경되거나 제거될 수 있습니다.
실험적 명령을 참조하세요. 대상 그룹을 나열하고 가져오려면
해당 판매자에 대한 Partner Center의 고객 그룹 읽기 권한이 필요하고, 생성하고 업데이트하려면 쓰기
권한이 필요합니다.
명령
CLI는 대상 그룹을 삭제하거나 유형을 변경할 수 없습니다. 이 작업은 Partner Center에서 수행하세요.
인수 및 옵션
출력
audience get은 대상 그룹 하나를 씁니다.
audience list는 같은 개체를 members 없이 담은 audiences 배열을 쓰며, 대상 그룹이 없으면
{"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에 출력되며, 상관 관계 ID, HTTP 상태에 대한 안내, 그리고
있는 경우 서비스의 오류 세부 정보가 포함됩니다. --verbose는 서비스의 응답을 추가하며, 여기에는
구성원이 포함될 수 있습니다. 스크립트는 문구가 아니라 종료 코드에 따라 분기해야 합니다.
403은 권한이 없거나, 해당 판매자에 속하지 않거나, 판매자에 대해 플레이테스트가 활성화되지 않았음을
의미할 수 있습니다. list와 get에서는 거부가 대신 502로 나타날 수 있으므로 오류 세부 정보에서
원인을 확인하세요. 대상 그룹 생성 및 업데이트는 순차적으로 배포되고 있어 아직 사용할 수 없을 수
있습니다. 사용할 수 있게 될 때까지 create와 update는 아무것도 변경하지 않고 실패합니다.
