> ## 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 atualização da reestruturação da API de entidade

> Atualize o código do PlayFab que usa o antigo grupo de API PlayFabEntityModel para os novos grupos lógicos de API de entidade, com um passo a passo de migração do SDK do C#.

## Introdução

Reestruturamos as APIs que estavam agrupadas no grupo Entity API em grupos lógicos coerentes que facilitam seu consumo, tanto pelo [site de documentação](/pt-BR/services/playfab/api-references) quanto pelos SDKs do PlayFab.

O impacto imediato é que, se você estiver usando as APIs baseadas em entidade no seu jogo, o código precisará ser atualizado quando você atualizar seus SDKs.

## Pré-requisitos

As seguintes condições devem ser verdadeiras para que este guia de atualização se aplique a você:

1. Você está usando as APIs do PlayFab baseadas em entidade.
2. Você atualizou para um SDK do PlayFab publicado em 9/8/2018 ou posteriormente.

<Note>
  *Não* há alterações no nível do serviço. Por exemplo, os títulos existentes que usam SDKs antigos continuarão funcionando sem exigir alterações.
</Note>

## Como atualizar

O impacto fundamental dessa alteração é que o grupo de API `PlayFabEntityModel` foi separado em seis grupos de API diferentes, logicamente agrupados, conforme mostrado na imagem a seguir.

<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="Alterações no 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" />

Uma lista completa do mapeamento **API de entidade anterior** -> **Nova API** pode ser encontrada no [APÊNDICE 1](#appendix-1-old-to-new-api-mappings) deste tutorial.

<Note>
  O mapeamento da API clássica *não* foi afetado.
</Note>

A próxima seção mostra um exemplo de atualização de um SDK do C# que usa o `PlayFabEntityAPIGroup` para o novo conjunto de grupos de API.

## Exemplo de atualização: SDK do C\#

Siga estas etapas para atualizar seu aplicativo.

**Etapa 1**: altere todas as instruções `using` que fazem referência a `PlayFab.EntityModels`, como as mostradas abaixo.

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

Agora você pode escolher de forma granular quais dessas APIs deseja incluir, em vez de importar todo o grupo Entity API.

**Etapa 2**: um exemplo de código mais detalhado da nova API, com comentários sobre como ela era antes, é fornecido abaixo.

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

Faça o mesmo para outros SDKs,
usando o mapeamento do [APÊNDICE 1](#appendix-1-old-to-new-api-mappings) deste tutorial.

## Conclusão

Estamos entusiasmados em expor as APIs de entidade de forma mais intuitiva no nosso site de documentação e no nosso código, com base nos seus comentários.

Se você tiver dúvidas ou comentários, entre em contato conosco pelos [fóruns do PlayFab](https://community.playfab.com/index.html).

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

## APÊNDICE 1: mapeamentos de API ANTIGA para NOVA

Todas as APIs listadas abaixo faziam parte *anteriormente* do grupo de API `PlayFabEntityModel`. *Agora*, elas estão categorizadas nos seguintes novos grupos de 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

- [Excluir avaliações de itens da entidade](/pt-BR/services/playfab/api-references/rest/economy/catalog/delete-entity-item-reviews.md)
- [Obter avaliação de item da entidade](/pt-BR/services/playfab/api-references/rest/economy/catalog/get-entity-item-review.md)
- [Obter itens de rascunho da entidade](/pt-BR/services/playfab/api-references/rest/economy/catalog/get-entity-draft-items.md)
- [Servidores de jogo a partir da entidade de título](/pt-BR/services/playfab/sdks/c/server.md)
- [Obter tabela de classificação em torno da entidade](/pt-BR/services/playfab/api-references/rest/progression/leaderboards/get-leaderboard-around-entity.md)