> ## 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 (GetPlayersInSegment 的較新替代方案) 從區段匯出 PlayFab 玩家設定檔。

# 匯出區段的玩家

本教學課程將逐步引導您使用 ExportPlayersInSegment API 和 GetSegmentExport API 匯出區段中的玩家設定檔。這些 API 是 GetPlayersInSegment API 較新且更好的版本。

### 步驟 1

將區段識別碼作為承載，向 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="匯出區段中的玩家" width="1618" height="786" data-path="images/playfab/data-analytics/acting-data/ExportPlayersInSegment.png" />

<Note>
  此 API 需要「X-SecretKey」標頭，其值為遊戲秘密金鑰。「Content-Type」標頭應設定為「application/json」
</Note>

### 步驟 2

將上述 API 呼叫中收到的 ExportId 作為承載，向 GetSegmentExport API 傳送 POST 要求。回應中包含匯出作業的「State」。如果匯出的狀態為「Complete」，則回應會包含可下載索引檔案的「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="取得區段匯出" width="1430" height="629" data-path="images/playfab/data-analytics/acting-data/GetSegmentExport.png" />

<Note>
  此 API 需要「X-SecretKey」標頭，其值為遊戲秘密金鑰。「Content-Type」標頭應設定為「application/json」
</Note>

### 步驟 3

從 IndexUrl 下載索引檔案。索引檔案中的每一行都是一個 URL，可從中下載區段中玩家設定檔的一個片段。接下來您可以看到索引檔案的範例。此索引檔案中有 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="索引檔案.png" width="1606" height="374" data-path="images/playfab/data-analytics/acting-data/IndexFile.png" />

### 步驟 4：

逐一處理索引檔案中的各行，從每個 URL 下載玩家設定檔。玩家設定檔檔案使用 tsv 格式。例如，從上述索引檔案中第一個 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="從索引檔案 URL 擷取的玩家設定檔" width="1430" height="125" data-path="images/playfab/data-analytics/acting-data/PlayerProfilesRetrievedFromTheIndexFileURL.png" />


## Related topics

- [計算區段玩家數的教學課程](/zh-TW/services/playfab/live-service-management/game-configuration/segmentation/segmentation-player-count.md)
- [匯出區段中的玩家](/zh-TW/services/playfab/api-references/rest/server/play-stream/export-players-in-segment.md)
- [針對整個玩家區段的大量動作](/zh-TW/services/playfab/data-analytics/acting-data/action-rules-bulk-actions-for-an-entire-player-segment.md)
- [玩家區段](/zh-TW/services/playfab/player-progression/player-data/player-segments.md)
- [Economy (舊版) 中適用於玩家區段的自訂商店](/zh-TW/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)