> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# セグメント内のプレイヤーをエクスポートするチュートリアル

> ExportPlayersInSegment および GetSegmentExport API を使用して、セグメントから PlayFab プレイヤー プロファイルをエクスポートします。これらは GetPlayersInSegment の新しい代替 API です。

# セグメントのプレイヤーをエクスポートする

このチュートリアルでは、ExportPlayersInSegment API と GetSegmentExport API を使用して、セグメント内のプレイヤー プロファイルをエクスポートするのに必要な手順を説明します。これらの API は、GetPlayersInSegment API のより新しく優れたバージョンです。

### ステップ 1

Segment ID をペイロードとして ExportPlayersInSegment API に POST リクエストを送信します。応答の「ExportId」はエクスポート操作の一意識別子です。

![Export Players In A Segment](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/ExportPlayersInSegment.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=0f535cbc01662f81a695bf25de88b330)

> [!NOTE]
>
> この API は、値が Title Secret キーである「X-SecretKey」ヘッダーを必要とします。「Content-Type」ヘッダーは「application/json」に設定する必要があります

### ステップ 2

上記の API 呼び出しで受信した ExportId をペイロードとして GetSegmentExport API に POST リクエストを送信します。応答にはエクスポート操作の「State」があります。エクスポートのステータスが「Complete」の場合、応答には Index ファイルをダウンロードできる「IndexUrl」が含まれます。

![Get Segment Export](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/GetSegmentExport.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=4aa11d28756553e3af3c78c76124adb0)

> [!NOTE]
>
> この API は、値が Title Secret キーである「X-SecretKey」ヘッダーを必要とします。「Content-Type」ヘッダーは「application/json」に設定する必要があります

### ステップ 3

IndexUrl から Index ファイルをダウンロードします。Index ファイルは、各行が Segment 内のプレイヤー プロファイルの断片をダウンロードできる URL であるファイルです。次に Index ファイルの例を示します。Index ファイルには 2 つの URL (エクスポート断片) があります。

![Index File.png](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/IndexFile.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=0de6e8a4519b5ded129f982e779f44d3)

### ステップ 4:

Index ファイルの行を反復して、各 URL からプレイヤー プロファイルをダウンロードします。プレイヤー プロファイル ファイルは tsv 形式を使用します。たとえば、上記の Index ファイルの最初の URL からダウンロードされたプレイヤー プロファイルは以下のとおりです:

![Index ファイル URL から取得したプレイヤー プロファイル](https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/PlayerProfilesRetrievedFromTheIndexFileURL.png?fit=max\&auto=format\&n=IwSYTY5BEqd_x-HK\&q=85\&s=ddd0cccdadb1aa046e579e594ec6eafb)


## Related topics

- [セグメントのプレイヤーをカウントするチュートリアル](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/segmentation/segmentation-player-count.md)
- [セグメント内のプレイヤーのエクスポート](https://docs.xbox.com/ja-jp/services/playfab/api-references/rest/server/play-stream/export-players-in-segment.md)
- [プレイヤー カスタム プロパティによる高度なセグメント化](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/segmentation/advanced-segmentation.md)
- [プレイヤー セグメント](https://docs.xbox.com/ja-jp/services/playfab/player-progression/player-data/player-segments.md)
- [プレイヤー セグメント全体に対する一括アクション](https://docs.xbox.com/ja-jp/services/playfab/data-analytics/acting-data/action-rules-bulk-actions-for-an-entire-player-segment.md)