> ## 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 のプレイヤー データ (内部、読み取り専用、タイトル データを含み、進行度管理に利用) について解説します。

プレイヤー データは、プレイヤー エンティティ (`title_player_account`、`master_player_account`、`character`) にスコープされたプレイヤーごとのストレージです。ゲームの進行度、設定、その他個々のプレイヤーに紐づく情報を保存する用途で使用します。

プレイヤー データは PlayFab の複数のストレージ機能の 1 つで、それぞれ異なるエンティティ タイプにスコープされます。比較については [Entity Objects](/services/playfab/live-service-management/game-configuration/entities/entity-objects#related-features) をご覧ください。

## ストレージ オプション

PlayFab はプレイヤー データを保存する 2 つの方法を提供します。

* [Entities](/services/playfab/live-service-management/game-configuration/entities): プレイヤー、キャラクター、グループ全体でオブジェクトやファイルにデータを保存できます。
* [プレイヤー データ / UserData](/services/playfab/player-progression/player-data/quickstart): プレイヤーごとにキーと値のペア データを保存できます。

最も柔軟で最高のパフォーマンスを実現するため、*すべての* 新しいタイトルでは [Entity オブジェクト](/services/playfab/live-service-management/game-configuration/entities/entity-objects) の使用を推奨します。

PlayFab の API では、関数名に **UserData** という語を使用します。**Game Manager** では、この概念は **Player Data** と表現されます。両者は同じで、相互に置き換え可能です。

プレイヤー データには 3 種類のアクセス モードがあります。

* Client: タイトル クライアントから読み取りおよび更新できるプレイヤー データです。クライアント API [UpdateUserData](xref:titleid.playfabapi.com.client.playerdatamanagement.updateuserdata) で作成、更新、削除を行い、[GetUserData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserdata) でプレイヤーのデータを読み取ります。
* Read Only: サーバーによって作成または更新されるプレイヤー データです。タイトル クライアントは読み取り可能ですが、更新はできません。サーバー API [UpdateUserReadOnlyData](xref:titleid.playfabapi.com.server.playerdatamanagement.updateuserreadonlydata) で作成、更新、削除を行い、クライアント API [GetUserReadOnlyData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserreadonlydata) でプレイヤーのタイトル固有データを読み取ります。このデータはプレイヤーに公開されますが、変更できるのはサーバーのみです。
* Internal: サーバーからのみアクセスできるプレイヤー データです。サーバー API [UpdateUserInternalData](xref:titleid.playfabapi.com.server.playerdatamanagement.updateuserinternaldata) で作成、更新、削除を行い、[GetUserInternalData](xref:titleid.playfabapi.com.server.playerdatamanagement.getuserinternaldata) でプレイヤーのタイトル固有データを読み取ります。このデータはサーバー専用で、クライアントからは参照できません。

プレイヤー データを使用する際、クライアント API から利用できるのは User Data と User Read Only Data のみです。他のプレイヤーが読み取れるプレイヤー データを持たせたい場合は、データ書き込み時に `Permission` の値を `Public` に設定する必要があります。

## プレイヤー データとプレイヤー パブリッシャー データ

[プレイヤー データ](/services/playfab/player-progression/player-data/quickstart) は、ゲーム タイトルに固有のプレイヤー情報です。プレイヤーがダンジョン内のどこにいるかなど、タイトル固有の情報を保存する用途で使用します。

プレイヤー パブリッシャー データは、プレイヤー アカウント *と* タイトルの組み合わせではなく、プレイヤー アカウントに関連付けられるデータです。スタジオ内のすべてのタイトルに関連するプレイヤー情報を保存するために使用されます (クロス タイトルの報酬のために、タイトル固有の情報を含めることも可能です)。

PlayFab では、スタジオ内のすべてのタイトルは既定で Publisher ID を共有し、その ID がこの関係を定義します。プレイヤー アカウントはパブリッシャー層に存在し、同じ Publisher ID を持つすべてのタイトル間で共有されます (加えて、タイトルごとに個別のプレイヤー データを持ちます)。

1 つのスタジオ内のタイトルで異なる Publisher ID を持たせたい場合、あるいは異なるスタジオ間のタイトルで同じ Publisher ID を共有したい場合は、[PlayFab コミュニティ フォーラム](https://community.playfab.com/) でチケットを起票してください。**Developer Success** チームがサポートします。

<Note>
  *プレイヤー* パブリッシャー データを、すべてのタイトルで共有されるキーと値のペア データである [パブリッシャー データ](/services/playfab/live-service-management/game-configuration/titledata/using-publisher-data) (プレイヤーごとの *データではありません*) と混同しないようにしてください。
</Note>

プレイヤー パブリッシャー データの使用方法は、プレイヤー データとほぼ同一です。*どちらも* 文字列を JSON blob (または任意の文字列値) にマッピングする辞書です。

詳細については、[複数タイトルのプレイを対象に報酬を付与するためにプレイヤー パブリッシャー データを利用する方法](/services/playfab/player-progression/player-data/using-player-publisher-data) をご覧ください。


## Related topics

- [プレイヤー データ](/ja-jp/services/playfab/player-progression/player-data/index.md)
- [PlayFab プレイヤー進行ドキュメント](/ja-jp/services/playfab/player-progression/index.md)
- [XBOX services の概要](/ja-jp/services/xbox-services/fundamentals/live-xbl-overview.md)
- [PlayFab GDPR - プレイヤー データの削除](/ja-jp/services/playfab/data-analytics/privacy-compliance/gdpr-deleting-player-data.md)
- [XBOX プレイヤー データの概要](/ja-jp/services/xbox-services/player-data/live-playerdata-overview.md)
