세그먼트에서 플레이어 내보내기

이 자습서에서는 ExportPlayersInSegment API 및 GetSegmentExport API를 사용하여 세그먼트의 플레이어 프로필을 내보내는 데 필요한 단계를 안내합니다. 해당 API는 GetPlayersInSegment API가 향상된 최신 버전입니다.

1단계

세그먼트 ID가 있는 POST 요청을 ExportPlayersInSegment API에 대한 페이로드로 보냅니다. 응답의 'ExportId'는 내보내기 작업의 고유 식별자입니다.

참고 항목

API에는 타이틀 비밀 키 값이 있는 'X-SecretKey' 헤더가 필요합니다. 'Content-Type' 헤더는 'application/json'으로 설정해야 합니다.

2단계

위의 API 호출에서 받은 ExportId를 페이로드로 사용하여 GetSegmentExport API에 POST 요청을 보냅니다. 응답에는 내보내기 작업의 '상태'가 있습니다. 내보내기 상태가 '완료'이면 응답에 인덱스 파일을 다운로드할 수 있는 'IndexUrl'이 포함됩니다.

참고 항목

API에는 타이틀 비밀 키 값이 있는 'X-SecretKey' 헤더가 필요합니다. 'Content-Type' 헤더는 'application/json'으로 설정해야 합니다.

3단계

IndexUrl에서 인덱스 파일을 다운로드합니다. 인덱스 파일은 세그먼트의 플레이어 프로필 조각을 다운로드할 수 있는 각 줄이 URL인 파일입니다. 다음으로 인덱스 파일의 예를 찾을 수 있습니다. 인덱스 파일에는 2개의 URL(내보내기 조각)이 있습니다.

4단계:

인덱스 파일의 줄을 반복하여 각 URL에서 플레이어 프로필을 다운로드합니다. 플레이어 프로필 파일은 tsv 형식을 사용합니다. 예를 들어, 위 Index 파일의 첫 번째 URL에서 다운로드한 플레이어 프로필은 다음과 같습니다.