> ## 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 のアカウント API とデータ API からエンティティ API へ、タイトル、プレイヤー、キャラクターのデータを移行する方法。用語やアクセス パターンの変更を含みます。

エンティティ API は、現在のアカウントおよびデータ システムの問題点を緩和するために設計された、新しいアクセス パターンを導入します。

ここで紹介する情報は、タイトル、プレイヤー、またはキャラクターの情報のデータ管理を実装するために、以前に次のメソッドを使用していた場合に役立ちます。

**タイトル** アクセス:

* client/[GetTitleData](xref:titleid.playfabapi.com.client.title-widedatamanagement.gettitledata)
* admin/[GetTitleData](xref:titleid.playfabapi.com.admin.title-widedatamanagement.gettitledata)
* server/[GetTitleData](xref:titleid.playfabapi.com.server.title-widedatamanagement.gettitledata)

**プレイヤー** アクセス:

* client/[GetUserReadOnlyData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserreadonlydata)
* client/[UpdateUserData](xref:titleid.playfabapi.com.client.playerdatamanagement.updateuserdata)
* client/[UpdateUserPublisherData](xref:titleid.playfabapi.com.client.playerdatamanagement.updateuserpublisherdata)

**キャラクター** アクセス:

* client/[GetCharacterData](xref:titleid.playfabapi.com.client.characterdata.getcharacterdata)
* client/[UpdateCharacterData](xref:titleid.playfabapi.com.client.characterdata.updatecharacterdata)

エンティティ API を使用すると、単一のメソッドを呼び出して、タイトル、プレイヤー、キャラクターの各エンティティ タイプのデータ値を保存できます。API は、現在のカスタム データのシステム動作を複製し拡張したアクセス ルールを、より優れたインターフェイスで提供します。

一部の点では、これらの変更は下位互換性がありません。ただし、既存の API の動作を変更することなく、エンティティ API への呼び出しを追加できます。

## 用語

次の表は、エンティティ API に関連する用語の改訂内容を示しています。

| 用語                          | 説明                                                                                                                                                                                                                                                                                                                                                                                   |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **title**                   | この概念は変わりません。タイトルには、すべてのプレイヤーが利用できるグローバル情報を含めることができます。これは [TitleData](xref:titleid.playfabapi.com.client.title-widedatamanagement.gettitledata) に似ています。ゲーム/アプリケーションのタイトル ID (`TitleId`) で識別されます。                                                                                                                                                                                      |
| **master\_player\_account** | このエンティティ タイプを使用すると、スタジオ内の複数のゲーム間でプレイヤーに関する情報を共有できます。これは [UserPublisherData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserpublisherdata) に似ています。プレイヤーのプレイヤー ID (`PlayFabId`) で識別されます。これは、ログインの一部として、またはプレイヤー アカウントのアカウント情報を取得する呼び出し (たとえば、PlayFab Client API の [GetAccountInfo](xref:titleid.playfabapi.com.client.accountmanagement.getaccountinfo)) から返されます。      |
| **title\_player\_account**  | この概念は、既存の API メソッドの user/player に基づいています。各プレイヤーは、現在のタイトルに関する情報を保持できます。これは [GetUserData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserdata) メソッドに似ています。これは、`LoginTitlePlayerAccountEntity` を `True` として指定する任意のログインの [EntityKey](xref:titleid.playfabapi.com.authentication.authentication.getentitytoken#entitykey) オブジェクトから返されるエンティティ ID (`EntityKey.Id`) で識別されます。 |
| **character**               | この概念は変わりません。プレイヤーはキャラクターを所有することができ、それぞれに情報を保持できます。これは [CharacterData](xref:titleid.playfabapi.com.client.characterdata.getcharacterdata) に似ています。キャラクターのキャラクター ID (`CharacterId`) で識別されます。                                                                                                                                                                                            |
| **PlayFabId**               | 以前は、この用語は `master_player_account` と `title_player_account` の両方の概念をカバーしていました。これらの概念を分離することで、機能が簡素化され明確になります。プレイヤーは同じスタジオ内の複数のタイトルとやり取りできるため、各タイトルで異なる `title_player_account` として固有の情報を持つ一方で、スタジオのオーナーは、そのプレイヤーをタイトル間で共有されるデータを持つ単一の `master_player_account` エンティティとしても識別する必要があります。これにより、ゲームのクロス プロモーションや、プレイヤーへのクロス ゲーム報酬の付与などが可能になります。                                               |

## 関連項目

* PlayFab ブログの [Introducing Entities, Objects and Files](https://blog.playfab.com/blog/introducing-entities-objects-and-files)。
* [エンティティ クイックスタート](/services/playfab/live-service-management/game-configuration/entities/quickstart)


## Related topics

- [エンティティ クイックスタート](/ja-jp/services/playfab/live-service-management/game-configuration/entities/quickstart.md)
- [エンティティハンドル](/ja-jp/services/playfab/sdks/c/entity-handles.md)
- [エンティティ ファイル](/ja-jp/services/playfab/live-service-management/game-configuration/entities/entity-files.md)
- [エンティティ グループ](/ja-jp/services/playfab/community/associations/groups/quickstart.md)
- [エンティティ プログラミング モデル](/ja-jp/services/playfab/live-service-management/game-configuration/entities/index.md)
