> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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」はエクスポート操作の一意識別子です。

<img src="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" alt="Export Players In A Segment" width="1618" height="786" data-path="images/playfab/data-analytics/acting-data/ExportPlayersInSegment.png" />

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

### ステップ 2

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

<img src="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" alt="Get Segment Export" width="1430" height="629" data-path="images/playfab/data-analytics/acting-data/GetSegmentExport.png" />

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

### ステップ 3

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

<img src="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" alt="Index File.png" width="1606" height="374" data-path="images/playfab/data-analytics/acting-data/IndexFile.png" />

### ステップ 4:

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

<img src="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" alt="Index ファイル URL から取得したプレイヤー プロファイル" width="1430" height="125" data-path="images/playfab/data-analytics/acting-data/PlayerProfilesRetrievedFromTheIndexFileURL.png" />


## Related topics

- [セグメントのプレイヤーをカウントするチュートリアル](/ja-jp/services/playfab/live-service-management/game-configuration/segmentation/segmentation-player-count.md)
- [プレイヤー カスタム プロパティによる高度なセグメント化](/ja-jp/services/playfab/live-service-management/game-configuration/segmentation/advanced-segmentation.md)
- [プレイヤーセグメント](/ja-jp/services/playfab/player-progression/player-data/player-segments.md)
- [プレイヤー セグメント全体への一括アクション](/ja-jp/services/playfab/data-analytics/acting-data/action-rules-bulk-actions-for-an-entire-player-segment.md)
- [Economy (Legacy) のプレイヤー セグメント向けカスタム ストア](/ja-jp/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)