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

# エンティティ API 再構成アップグレード チュートリアル

> 古い PlayFabEntityModel API グループを使用する PlayFab コードを新しい論理的なエンティティ API グループにアップグレードし、C# SDK 移行のウォークスルーを提供します。

## はじめに

Entity API グループにまとめられていた API を、[ドキュメント サイト](/services/playfab/api-references) や PlayFab SDK を通じて利用しやすくするために、一貫性のある論理的なグループに再構成しました。

その直接的な影響として、ゲーム内でエンティティ ベースの API を使用している場合、SDK をアップグレードする際にコードを更新する必要があります。

## 前提条件

このアップグレード ガイドが該当するには、次の条件が満たされている必要があります:

1. エンティティ ベースの PlayFab API を使用している。
2. 2018 年 8 月 9 日以降に公開された PlayFab SDK にアップグレードしている。

<Note>
  サービス レベルの変更は *ありません*。たとえば、古い SDK を使用している既存のタイトルは、変更なしで動作します。
</Note>

## アップグレード方法

この変更の根本的な影響は、次の図に示すように、`PlayFabEntityModel` API グループが論理的にまとめられた 6 つの異なる API グループに分離されたことです。

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/entities/tutorials/changes-to-playfabentitymodel-api-group.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=f40f3a4c1fd1d2721e3b6c1bfde121e9" alt="Changes to PlayFabEntityModel API group" width="460" height="558" data-path="images/playfab/live-service-management/game-configuration/entities/tutorials/changes-to-playfabentitymodel-api-group.png" />

**以前のエンティティ API** -> **新しい API** のマッピングの完全な一覧は、このチュートリアルの [付録 1](#appendix-1-old-to-new-api-mappings) にあります。

<Note>
  クラシック API のマッピングは影響を受け *ていません*。
</Note>

次のセクションでは、`PlayFabEntityAPIGroup` を使用する C# SDK を新しい API グループのセットにアップグレードする例を説明します。

## アップグレード例: C# SDK

アプリケーションをアップグレードするには、次の手順に従ってください。

**手順 1**: 以下に示すような `PlayFab.EntityModels` を参照する `using` ステートメントを変更します。

```csharp theme={null}
using PlayFab.EntityModels;
using PlayFab.DataModels;
```

Entity API グループ全体をインポートする代わりに、これらの API のうち、どれを取り込むかを細かく選択できるようになりました。

**手順 2**: 新しい API のより詳細なコーディング例と、以前どのように見えたかについてのコメントを以下に示します。

```csharp theme={null}
public async void Example()
{
       var logrequest = new PlayFab.ClientModels.LoginWithCustomIDRequest
       {
           CustomId = "TestExample",
           CreateAccount = true,
       };

       var loginResult = await PlayFab.PlayFabClientAPI.LoginWithCustomIDAsync(logrequest);
       var playfabId = loginResult?.Result?.PlayFabId;

       // PlayFab EntityAPI has been replaced here with the PlayFabProfilesAPI
       // and PlayFab.EntityModels has been replaced with PlayFab.ProfileModels
       var getProfileResult = await PlayFab.PlayFabProfilesAPI.GetProfileAsync(new
       PlayFab.ProfilesModels.GetEntityProfileRequest());
       var profile = getProfileResult?.Result?.Profile;
}
```

このチュートリアルの [付録 1](#appendix-1-old-to-new-api-mappings) のマッピングを使用して、他の SDK でも同様に対応してください。

## まとめ

皆様のフィードバックを基に、ドキュメント サイトとコードで Entity API をより直感的な方法で公開できることを嬉しく思います。

ご質問やコメントがある場合は、[PlayFab フォーラム](https://community.playfab.com/index.html) からお問い合わせください。

## 付録 1: 旧 API から新 API へのマッピング

以下に示す API はすべて、*以前は* `PlayFabEntityModel` API グループの一部でした。これらは *現在*、次の新しい API グループに分類されています。

### PlayFabProfilesApi

* GetGlobalPolicy
* GetProfile
* GetProfiles
* SetGlobalPolicy
* SetProfilePolicy

### PlayFabAuthenticationApi

* GetEntityToken

### PlayFabDataApi

* AbortFileUploads
* DeleteFiles
* FinalizeFileUploads
* GetFiles
* InitiateFileUploads
* GetObjects
* SetObjects

### PlayFabGroupsApi

* AcceptGroupApplication
* AcceptGroupInvitation
* AddMembers
* ApplyToGroup
* BlockEntity
* ChangeMemberRole
* CreateGroup
* CreateRole
* DeleteGroup
* DeleteRole
* GetEntityToken
* GetGroup
* InviteToGroup
* IsMember
* ListGroupApplications
* ListGroupBlocks
* ListGroupInvitations
* ListGroupMembers
* ListMembershipOpportunities
* RemoveGroupApplication
* RemoveGroupInvitation
* RemoveMembers
* UnblockEntity
* UpdateGroup
* UpdateRole

### PlayFabEventsApi

* WriteEvents

### PlayFabCloudScriptApi

* ExecuteEntityCloudScript


## Related topics

- [イベントパイプラインチュートリアル](/ja-jp/services/playfab/sdks/c/event-pipeline/eventpipeline-tutorial.md)
- [Game Saves のチュートリアルとサンプル](/ja-jp/build/core-features/common/game-save/game-saves-walkthroughs-and-samples.md)
- [PlayFab と Microsoft Fabric リアルタイム分析チュートリアル](/ja-jp/services/playfab/data-analytics/learn-data/reports/real-time-analytics-tutorial.md)
- [GSDK サンプルプロジェクトの作成](/ja-jp/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/third-person-mp-example-project-setup.md)
- [エンティティ クイックスタート](/ja-jp/services/playfab/live-service-management/game-configuration/entities/quickstart.md)