セグメントのプレイヤーをエクスポートする
このチュートリアルでは、ExportPlayersInSegment API と GetSegmentExport API を使用して、セグメント内のプレイヤー プロファイルをエクスポートするのに必要な手順を説明します。これらの API は、GetPlayersInSegment API のより新しく優れたバージョンです。ステップ 1
Segment ID をペイロードとして ExportPlayersInSegment API に POST リクエストを送信します。応答の「ExportId」はエクスポート操作の一意識別子です。
この API は、値が Title Secret キーである「X-SecretKey」ヘッダーを必要とします。「Content-Type」ヘッダーは「application/json」に設定する必要があります
ステップ 2
上記の API 呼び出しで受信した ExportId をペイロードとして GetSegmentExport API に POST リクエストを送信します。応答にはエクスポート操作の「State」があります。エクスポートのステータスが「Complete」の場合、応答には Index ファイルをダウンロードできる「IndexUrl」が含まれます。
この API は、値が Title Secret キーである「X-SecretKey」ヘッダーを必要とします。「Content-Type」ヘッダーは「application/json」に設定する必要があります
ステップ 3
IndexUrl から Index ファイルをダウンロードします。Index ファイルは、各行が Segment 内のプレイヤー プロファイルの断片をダウンロードできる URL であるファイルです。次に Index ファイルの例を示します。Index ファイルには 2 つの URL (エクスポート断片) があります。
ステップ 4:
Index ファイルの行を反復して、各 URL からプレイヤー プロファイルをダウンロードします。プレイヤー プロファイル ファイルは tsv 形式を使用します。たとえば、上記の Index ファイルの最初の URL からダウンロードされたプレイヤー プロファイルは以下のとおりです:
