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

# Tutoriel de mise à niveau suite à la restructuration de l'API d'entité

> Mettez à niveau le code PlayFab utilisant l'ancien groupe d'API PlayFabEntityModel vers les nouveaux groupes logiques d'API d'entité, avec une procédure de migration pour le SDK C#.

## Introduction

Nous avons restructuré les API qui étaient regroupées sous le groupe Entity API en groupes logiques cohérents, afin d'en faciliter l'utilisation, à la fois via le [site de documentation](/fr/services/playfab/api-references) et les SDK PlayFab.

La conséquence immédiate est que, si vous utilisiez les API basées sur les entités dans votre jeu, le code devra être mis à jour lorsque vous mettrez à niveau vos SDK.

## Prérequis

Les conditions suivantes doivent être remplies pour que ce guide de mise à niveau s'applique à vous :

1. Vous utilisez les API PlayFab basées sur les entités.
2. Vous avez effectué la mise à niveau vers un SDK PlayFab publié le 9/8/2018 ou ultérieurement.

<Note>
  Il n'y a *aucune* modification au niveau du service. Par exemple, les titres existants utilisant d'anciens SDK continueront de fonctionner sans nécessiter de modifications.
</Note>

## Procédure de mise à niveau

L'impact fondamental de ce changement est que le groupe d'API `PlayFabEntityModel` a été scindé en six groupes d'API distincts, liés logiquement entre eux, comme le montre l'image suivante.

<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="Modifications du groupe d'API PlayFabEntityModel" width="460" height="558" data-path="images/playfab/live-service-management/game-configuration/entities/tutorials/changes-to-playfabentitymodel-api-group.png" />

La liste complète des correspondances **Previous Entity API** -> **New API** se trouve dans l'[ANNEXE 1](#appendix-1-old-to-new-api-mappings) de ce tutoriel.

<Note>
  Le mappage de l'API classique n'a *pas* été modifié.
</Note>

La section suivante présente un exemple de mise à niveau d'un SDK C# utilisant le `PlayFabEntityAPIGroup` vers le nouvel ensemble de groupes d'API.

## Exemple de mise à niveau : SDK C\#

Suivez ces étapes pour mettre à niveau votre application.

**Étape 1** : modifiez toutes les instructions `using` qui référencent `PlayFab.EntityModels`, comme celles présentées ci-dessous.

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

Vous pouvez désormais choisir précisément les API que vous souhaitez importer, au lieu d'importer tout le groupe Entity API.

**Étape 2** : un exemple de code plus détaillé de la nouvelle API, avec des commentaires indiquant à quoi il ressemblait auparavant, est fourni ci-dessous.

```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;
}
```

Procédez de même pour les autres SDK,
en utilisant les correspondances de l'[ANNEXE 1](#appendix-1-old-to-new-api-mappings) de ce tutoriel.

## Conclusion

Nous sommes ravis d'exposer les API d'entité de manière plus intuitive sur notre site de documentation et dans notre code, en fonction de vos commentaires.

Si vous avez des questions ou des commentaires, contactez-nous via les [forums PlayFab](https://community.playfab.com/index.html).

<a id="appendix-1-old-to-new-api-mappings" />

## ANNEXE 1 : correspondances entre les ANCIENNES et les NOUVELLES API

Toutes les API répertoriées ci-dessous faisaient *auparavant* partie du groupe d'API `PlayFabEntityModel`. Elles sont *désormais* classées dans les nouveaux groupes d'API suivants.

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

- [Gestion des versions de l'API GameInput](/fr/build/core-features/common/input/overviews/input-versioning.md)
- [Groupes d'entités](/fr/services/playfab/community/associations/groups/quickstart.md)
- [Handles d'entité](/fr/services/playfab/sdks/c/entity-handles.md)
- [Référence de l'API Leaderboard](/fr/services/playfab/community/leaderboards/api-reference.md)
- [Tutoriel Event Pipeline](/fr/services/playfab/sdks/c/event-pipeline/eventpipeline-tutorial.md)