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

# Tutorial de actualización por la reestructuración de la API de entidades

> Actualice el código de PlayFab que usa el antiguo grupo de API PlayFabEntityModel a los nuevos grupos de API lógicos, con un tutorial de migración del SDK de C#.

## Introducción

Hemos reestructurado las API que estaban agrupadas bajo el grupo de API de entidades en grupos lógicos coherentes que facilitan su consumo, tanto a través del [sitio de documentación](/services/playfab/api-references) como de los SDK de PlayFab.

El impacto inmediato es que, si ha estado usando las API basadas en entidades en su juego, el código deberá actualizarse cuando actualice sus SDK.

## Requisitos previos

Las siguientes condiciones deben cumplirse para que esta guía de actualización le aplique:

1. Usa las API de PlayFab basadas en entidades.
2. Ha actualizado a un SDK de PlayFab publicado el 9/8/2018 o después.

<Note>
  *No* hay cambios en el nivel de servicio. Por ejemplo, los títulos existentes que usan SDK antiguos seguirán funcionando sin necesidad de cambios.
</Note>

## Cómo actualizar

El impacto fundamental de este cambio es que el grupo de API `PlayFabEntityModel` se ha separado en seis grupos de API diferentes que están enlazados lógicamente, como se muestra en la siguiente imagen.

<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="Cambios en el grupo de API PlayFabEntityModel" width="460" height="558" data-path="images/playfab/live-service-management/game-configuration/entities/tutorials/changes-to-playfabentitymodel-api-group.png" />

Puede encontrar la lista completa de asignaciones de **API de entidades anterior** -> **Nueva API** en el [APÉNDICE 1](#appendix-1-old-to-new-api-mappings) de este tutorial.

<Note>
  La asignación de la API clásica *no* se ha visto afectada.
</Note>

En la siguiente sección se muestra un ejemplo de actualización de un SDK de C# que usa `PlayFabEntityAPIGroup` al nuevo conjunto de grupos de API.

## Ejemplo de actualización: SDK de C\#

Siga estos pasos para actualizar su aplicación.

**Paso 1**: Cambie las instrucciones `using` que hagan referencia a `PlayFab.EntityModels`, como las que se muestran a continuación.

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

Ahora puede ser granular al seleccionar cuáles de estas API quiere incorporar, en lugar de importar todo el grupo de API de entidades.

**Paso 2**: A continuación se proporciona un ejemplo de código más detallado de la nueva API, con comentarios sobre cómo era antes.

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

Proceda de la misma manera con los demás SDK,
usando la asignación del [APÉNDICE 1](#appendix-1-old-to-new-api-mappings) de este tutorial.

## Conclusión

Nos complace exponer las API de entidades de una manera más intuitiva en nuestro sitio de documentación y en nuestro código, basándonos en sus comentarios.

Si tiene preguntas o comentarios, póngase en contacto con nosotros a través de los [foros de PlayFab](https://community.playfab.com/index.html).

## APÉNDICE 1: Asignaciones de API ANTIGUAS a NUEVAS

Todas las API que se enumeran a continuación formaban parte *anteriormente* del grupo de API `PlayFabEntityModel`. *Ahora* están clasificadas en los siguientes grupos de API nuevos.

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

- [Modelo de programación de entidades](/es/services/playfab/live-service-management/game-configuration/entities/index.md)
- [Actualización de la presencia de un usuario mediante REST](/es/services/xbox-services/community/presence/how-to/live-updating-presence-rest.md)
- [Actualización de la presencia de un usuario mediante XSAPI C](/es/services/xbox-services/community/presence/how-to/live-updating-user-presence.md)
- [Referencia de la API de Leaderboard](/es/services/playfab/community/leaderboards/api-reference.md)
- [Información general de la certificación de XBOX](/es/publishing/certification/overview.md)