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

# プレイヤー カスタム プロパティ

> PlayFab プレイヤー カスタム プロパティの概要: title_player_account エンティティに文字列、数値、ブール、または datetime データを保存するキー値ペアとその制限。

> [!NOTE]
>
> プレイヤー カスタム プロパティ機能はパブリック プレビュー中です。中核となる機能は整っていますが、フィードバックと使用パターンに基づいて体験を洗練させているところです。

カスタム プロパティは、プレイヤーに関する追加情報を保存するキー値データ ペアです。これらのデータ ペアのタイプには、文字列、数値、ブール、または datetime を指定できます。

カスタム プロパティとその値は、表示名、統計、タグなどの他のプレイヤー情報と共に保存されます。

> [!NOTE]
>
> カスタム プロパティは title\_player\_account エンティティでのみサポートされます。

## カスタム プロパティの構成

カスタム プロパティは、次のようにさまざまな方法で設定できます:

* プレイヤーのプロパティを更新する **UpdatePlayerCustomProperties** アクションを使用します。
* **DeletePlayerCustomProperties** アクションを使用して、カスタム プロパティを削除することもできます。
* また、Game Manager UI 経由で単一プレイヤーのプロパティを変更することもできます。

## 制限

カスタム プロパティに関する制限の一部を次に示します:

* プロパティ名は文字列型で、最大 36 文字である必要があります
* プロパティ名は大文字と小文字が区別されます。たとえば、prop と PROP は異なる名前です
* 文字列値は最大 36 文字です
* サポートされる数値は倍精度浮動小数点 (IEEE 754 標準) です
* Datetime の文字列値は ISO 8601 形式を使用する必要があり、すべての比較は UTC に対して行われます
* プレイヤーごとに一意のカスタム プロパティは 5 つまでにできます (各プレイヤーが正確に同じ 5 つのプロパティ名を持つ必要はありません)

## メリット

カスタム プロパティは強力で、同じプレイヤーに関連する複数の既存の PlayStream イベントを関連付けるコードレス開発を可能にし、イベント間で状態を追跡できるようになります。


## Related topics

- [プレイヤー カスタム プロパティのクイックスタート](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)
- [プレイヤー カスタム プロパティの取得](https://docs.xbox.com/ja-jp/services/playfab/api-references/rest/client/player-data-management/get-player-custom-property.md)
- [プレイヤー カスタム プロパティの削除](https://docs.xbox.com/ja-jp/services/playfab/api-references/rest/client/player-data-management/delete-player-custom-properties.md)
- [プレイヤー カスタム プロパティの一覧表示](https://docs.xbox.com/ja-jp/services/playfab/api-references/rest/admin/player-data-management/list-player-custom-properties.md)