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

# Informações de migração de entidades

> Mova dados de título, jogador e personagem das APIs de conta e de dados do PlayFab para a API de entidade, incluindo alterações de terminologia e de padrões de acesso.

A API de entidade introduz novos padrões de acesso projetados para aliviar os pontos problemáticos dos sistemas atuais de conta e de dados.

As informações apresentadas aqui são úteis se você usava anteriormente os seguintes métodos para implementar o gerenciamento de dados das informações de título, jogador ou personagem.

Acesso de **título**:

* 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)

Acesso de **jogador**:

* 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)

Acesso de **personagem**:

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

Usando a API de entidades, você pode chamar um único método para salvar os valores de dados dos tipos de entidade de título, jogador e personagem. A API fornece regras de acesso que replicam e expandem o comportamento atual do sistema de dados personalizados em uma interface melhor.

Em alguns aspectos, essas alterações não são compatíveis com versões anteriores. No entanto, você pode adicionar chamadas à API de entidade sem alterar o comportamento das APIs existentes.

## Terminologia

A tabela a seguir descreve refinamentos na terminologia relacionada às APIs de entidade.

| Termo | Descrição |
| - | - |
| **title** | Esse conceito não mudou. Seu título pode conter informações globais disponíveis para todos os jogadores. Isso é semelhante a [TitleData](xref:titleid.playfabapi.com.client.title-widedatamanagement.gettitledata). Ele é identificado pela ID de título (`TitleId`) do jogo/aplicativo. |
| **master\_player\_account** | Esse tipo de entidade permite compartilhar informações sobre um jogador entre vários jogos de um namespace. Isso é semelhante a [UserPublisherData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserpublisherdata). Ele é identificado pela ID do jogador (`PlayFabId`), que é retornada como parte de qualquer login ou de qualquer chamada para obter informações da conta do jogador (por exemplo, [GetAccountInfo](xref:titleid.playfabapi.com.client.accountmanagement.getaccountinfo) da PlayFab Client API). |
| **title\_player\_account** | Esse conceito se baseia no usuário/jogador dos métodos de API existentes. Cada jogador pode conter algumas informações para o título atual. Isso é semelhante ao método [GetUserData](xref:titleid.playfabapi.com.client.playerdatamanagement.getuserdata). Ele é identificado pela ID de entidade (`EntityKey.Id`) que você recebe no objeto [EntityKey](xref:titleid.playfabapi.com.authentication.authentication.getentitytoken#entitykey) em qualquer login em que você especificar `LoginTitlePlayerAccountEntity` como `True`. |
| **character** | Esse conceito não mudou. Seu jogador pode ter personagens, e cada um pode conter algumas informações. Isso é semelhante a [CharacterData](xref:titleid.playfabapi.com.client.characterdata.getcharacterdata). Ele é identificado pela ID do personagem (`CharacterId`). |
| **PlayFabId** | Anteriormente, esse termo abrangia os conceitos de `master_player_account` e `title_player_account`. Separar esses conceitos simplifica e esclarece a funcionalidade. Um jogador pode interagir com vários títulos no mesmo namespace. O jogador pode ter informações exclusivas em uma `title_player_account` diferente para cada título e uma única `master_player_account` com dados compartilhados entre títulos. Isso permite a promoção cruzada de jogos e recompensas entre jogos. |

## Confira também

* [Introducing Entities, Objects and Files](https://blog.playfab.com/blog/introducing-entities-objects-and-files) no blog do PlayFab.
* [Início rápido de entidades](/pt-BR/services/playfab/live-service-management/game-configuration/entities/quickstart)


## Related topics

- [Início rápido de entidades](/pt-BR/services/playfab/live-service-management/game-configuration/entities/quickstart.md)
- [Servidores de jogo e lobbies](/pt-BR/services/playfab/multiplayer/lobby/lobby-server-overview.md)
- [Modelo de programação de entidades](/pt-BR/services/playfab/live-service-management/game-configuration/entities/index.md)
- [Tutorial de atualização da reestruturação da API de entidade](/pt-BR/services/playfab/live-service-management/game-configuration/entities/entity-api-restructure-upgrade-tutorial.md)
- [Tipos de entidade internos disponíveis](/pt-BR/services/playfab/live-service-management/game-configuration/entities/available-built-in-entity-types.md)