세그먼트의 플레이어 내보내기
이 자습서는 ExportPlayersInSegment API와 GetSegmentExport API를 사용하여 세그먼트의 플레이어 프로필을 내보내는 데 필요한 단계를 안내합니다. 이 API는 GetPlayersInSegment API의 더 새롭고 개선된 버전입니다.1단계
페이로드로 세그먼트 ID를 사용하여 ExportPlayersInSegment API에 POST 요청을 보냅니다. 응답의 ‘ExportId‘는 내보내기 작업의 고유 식별자입니다.
이 API에는 값이 타이틀 비밀 키인 ‘X-SecretKey’ 헤더가 필요합니다. ‘Content-Type’ 헤더는 ‘application/json’으로 설정되어야 합니다.
2단계
위 API 호출에서 받은 ExportId를 페이로드로 사용하여 GetSegmentExport API에 POST 요청을 보냅니다. 응답에는 내보내기 작업의 ‘State’가 있습니다. 내보내기 상태가 ‘Complete’인 경우, 응답에는 인덱스 파일을 다운로드할 수 있는 ‘IndexUrl’이 포함됩니다.
이 API에는 값이 타이틀 비밀 키인 ‘X-SecretKey’ 헤더가 필요합니다. ‘Content-Type’ 헤더는 ‘application/json’으로 설정되어야 합니다.
3단계
IndexUrl에서 인덱스 파일을 다운로드합니다. 인덱스 파일은 각 줄이 세그먼트의 플레이어 프로필 조각을 다운로드할 수 있는 URL인 파일입니다. 다음은 인덱스 파일의 예입니다. 인덱스 파일에는 2개의 URL(내보내기 조각)이 있습니다.
4단계:
인덱스 파일의 각 줄을 반복하여 각 URL에서 플레이어 프로필을 다운로드합니다. 플레이어 프로필 파일은 tsv 형식을 사용합니다. 예를 들어, 위 인덱스 파일의 첫 번째 URL에서 다운로드한 플레이어 프로필은 다음과 같습니다: