> ## 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.

# PlayFab Game Manager 中的 API 功能設定

> 在 PlayFab Game Manager 中設定 API 功能設定，包括自訂資料的 JSON 驗證、隱私權選項及其他遊戲層級的 API 行為。

PlayFab Game Manager 中的 API 功能是一些用於管理遊戲 PlayFab API 行為的選項。這些選項為您提供管理存取、隱私權及其他功能的工具。

若要找到設定這些選項的畫面：

* 前往 **Game Manager**。
* 從左側功能表選取 **Settings**。
* 選取 **API Features** 索引標籤。

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/gamemanager/tutorials/game-manager-settings-api-features-full.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=ff65da3a46374af1c80aa9f84952074b" alt="Game Manager - Settings - API 功能" width="1269" height="1255" data-path="images/playfab/live-service-management/gamemanager/tutorials/game-manager-settings-api-features-full.png" />

其中有些核取方塊一目了然，有些則不然。在本教學課程中，我們將詳細說明其中幾個。

<Note>
  本教學課程中的數個螢幕擷取畫面和示範都使用 [Postman](/zh-TW/services/playfab/sdks/postman/postman-quickstart)。
</Note>

## 要求自訂資料值必須為有效的 JSON

遭到入侵的用戶端可能會為遊戲帶來一些\_嚴重\_的問題。張貼格式不正確資料的惡意 API 呼叫端，可能會為開發人員產生雜訊、錯誤和問題。資料格式不正確的玩家通常需要手動介入清理。

要求自訂資料值必須為有效的 JSON，會在資料儲存至資料庫\_之前\_執行基本的內容類型驗證。及早發現這些問題可防止問題持續存在，並阻止駭客干擾正常開發。

設定此旗標時，會強制用戶端為其自訂資料的每個索引鍵傳入有效的 JSON。單靠簡單的 JSON 驗證並無法防止\_所有\_問題，但有助於剔除一些不良行為。

勾選此選項會要求在所有自訂資料 (包括玩家、發行者、角色、遊戲和項目資料) 中儲存的每個索引鍵都必須是有效的 JSON。

<Note>
  此旗標可以隨時\_開啟\_或\_關閉\_。但它\_不\_具追溯力。因此現有的值\_不會\_受到影響。*只有新寫入的值才會經過驗證。*
</Note>

如果您嘗試傳遞無效的 JSON 作為值，它會以 `HTTP Status Code 400 "Bad Request"` 拒絕要求。

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/gamemanager/tutorials/postman-sending-invalid-json.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=f36cfcd0c8e160dfdac63e529c3a5b9e" alt="Postman - 傳送無效的 JSON" width="1355" height="1152" data-path="images/playfab/live-service-management/gamemanager/tutorials/postman-sending-invalid-json.png" />

## 停用所有 API 要求存取

出乎意料的是，停用遊戲的所有 API 存取可能會很有用。

例如，如果您正在執行需要停機的敏感移轉，零星的 API 要求可能會造成嚴重中斷。如果您要讓遊戲退役，這可以保證您的遊戲確實已關閉。

<Warning>
  請記住，勾選此核取方塊將會**確實讓您的遊戲無法運作**，因此請謹慎使用！
</Warning>

一旦您決定需要關閉 API 存取並勾選此方塊，所有 API 要求都會在幾分鐘內開始失敗。

PlayFab 會傳回 `HTTP Status Code 400 "Bad Request"`，表示遊戲已停用此類使用。

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/gamemanager/tutorials/postman-accessing-a-disabled-api.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=5699272b227f83fc32e34ec6f7ac7eb0" alt="Postman - 存取已停用的 API" width="1368" height="1020" data-path="images/playfab/live-service-management/gamemanager/tutorials/postman-accessing-a-disabled-api.png" />

這些 `HTTP Status Code 400` 回應會持續存在，直到您取消勾選此方塊為止。同樣地，取消勾選可能需要幾分鐘才會生效。

## 啟用玩家 IP 位址模糊處理

對許多工作室而言，擁有**個人識別資訊** (**PII**) 是最好避免的責任。一種常見 (且實用) 的 **PII** 形式就是 **IP 位址**。

IP 位址有多種用途，包括地理位置。不過，\_完全\_精確的 IP 通常被視為 PII。

PlayFab 可以透過模糊處理部分 IP 位址來協助限制這一點。現在，只要勾選一個方塊，您就可以停止收集此敏感資料。

勾選此方塊後，PlayFab 一律會將玩家 IP 的最後一個八位元記錄為 **0**。您可以在 **Players** 索引標籤中檢查玩家的登入歷程記錄，以驗證此功能是否正常運作。

您應該會看到每個 IP 都以 **.0** 結尾。在啟用 IP 位址模糊處理之前記錄的任何 IP 都會保留其完整詳細資料。因此，如果您的遊戲對 PII 敏感，請在推出之前設定此核取方塊。

<Note>
  啟用模糊處理會影響使用 IP 位址的\_其他\_功能。最直接受到影響的三項功能是以 IP 為基礎的地理位置、IP 封鎖，以及指定 IP 位址的玩家封鎖。
</Note>

PlayFab 會在登入時自動執行以 IP 為基礎的地理位置判定。這有助於您自動判斷玩家來自世界上的哪個地方。

不過，使用模糊處理的 IP 時，您可能會遇到準確度降低的情況，\_尤其\_是在城市層級。這是刻意的，因為模糊處理 IP 的目標是避免記錄 PII，包括確切位置。

此外，模糊處理 IP 可能會影響 [IP 封鎖](/zh-TW/services/playfab/player-progression/player-data/ip-bans)。發出 IP 封鎖通常比一次封鎖一個帳戶更實際，因為不良行為者可以直接建立新帳戶。

封鎖 IP 可防止不良行為者從相同的網際網路連線建立新帳戶。在許多情況下，這是一個有效的工具。

不過，使用模糊處理的 IP 時，封鎖確切的 IP 將無法運作。相反地，您必須封鎖最後一個八位元為 **.0** 的 IP。請記住，這實際上會封鎖\_整個 IP 範圍\_。

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/gamemanager/tutorials/game-manager-ipbans-obfuscated-ip-ban.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=efc08197810551e86f8922aa35b53f74" alt="Game Manager - IP 封鎖 - 新增封鎖" width="823" height="728" data-path="images/playfab/live-service-management/gamemanager/tutorials/game-manager-ipbans-obfuscated-ip-ban.png" />

若要明確指定範圍，請輸入對等的 CIDR 範圍，而不是依賴以 **.0** 結尾的模糊處理位址，如下所示。這兩種封鎖在功能上是相同的。

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/gamemanager/tutorials/game-manager-ipbans-range-ban.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=80c74e8f043eed7f9933c7bcadfc8036" alt="Game Manager - IP 封鎖 - 範圍封鎖" width="943" height="725" data-path="images/playfab/live-service-management/gamemanager/tutorials/game-manager-ipbans-range-ban.png" />

這仍會封鎖不良行為者，但具有類似 IP 位址的其他無辜玩家可能會受到影響。此外，針對特定、未模糊處理之 IP 位址的現有封鎖將不再有效。


## Related topics

- [PlayFab 即時服務管理文件](/zh-TW/services/playfab/live-service-management/index.md)
- [TAK 編輯器設定](/zh-TW/build/core-features/common/game-streaming/tak-editor/game-streaming-tak-editor-setup.md)
- [Game Manager 參考](/zh-TW/services/playfab/live-service-management/gamemanager/reference.md)
- [title_api_settings_changed](/zh-TW/services/playfab/api-references/events/ApiAccessPolicy/title-api-settings-changed.md)
- [MicrosoftGame.config 其他參考](/zh-TW/reference/system/microsoftgameconfig/microsoftgameconfig-schema.md)