> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contas de jogador

> Consulte as informações da conta de um jogador com base na ID do PlayFab dele.

A família de comandos `playfab player` é Experimental. Sua interface de CLI pode mudar
ou ser removida com base em comentários.

Leia as informações da conta de um jogador.

| Comando | Caminho da API do PlayFab | Descrição |
| - | - | - |
| `playfab player account get` | `/Admin/GetUserAccountInfo` | Obtém a conta de um jogador com base na ID do PlayFab dele. |

`player account get` exige `--playfab-id` e não aceita `--output table`.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab player account get --playfab-id PLAYER123
```

## Qual ID passar

`--playfab-id` aceita a **ID da conta de jogador mestre** do jogador, a ID do PlayFab que as
APIs de entrada de jogadores do PlayFab retornam.

O PlayFab também atribui a cada jogador uma **ID da conta de jogador do título**. Ela tem a mesma aparência, 16
caracteres hexadecimais, e o Game Manager mostra ambas, mas `GetUserAccountInfo` a rejeita:

```console theme={null}
$ xbox --playfab-title-id ABC123 playfab player account get --playfab-id TITLEPLAYER123
{"code":400,"status":"BadRequest","error":"AccountNotFound","errorCode":1001,"errorMessage":"User not found"}
```

Se uma consulta falhar para um jogador que você sabe que existe, verifique se passou a ID da conta de jogador
mestre.

O comando não pode consultar um jogador por email, nome de usuário, nome de exibição ou uma ID de plataforma, como
uma ID de usuário do XBOX. Encontre o jogador no Game Manager para obter primeiro a ID do PlayFab dele.

## O que é retornado

A resposta é o registro completo da conta do jogador, incluindo todas as contas de plataforma vinculadas
e a ID da conta de jogador do título que outros comandos, como
[`playfab file`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playfab/file), aceitam:

```bash theme={null}
xbox --playfab-title-id ABC123 --data-only playfab player account get --playfab-id PLAYER123
```

```json theme={null}
{
  "UserInfo": {
    "PlayFabId": "PLAYER123",
    "Created": "2026-08-27T16:03:09.477Z",
    "TitleInfo": {
      "Origination": "CustomId",
      "DisplayName": "Hero",
      "isBanned": false,
      "TitlePlayerAccount": { "Id": "TITLEPLAYER123", "Type": "title_player_account" }
    },
    "SteamInfo": { "SteamId": "76561197960287930", "SteamCountry": "US" },
    "PsnInfo": { "PsnAccountId": "1234567890", "PsnOnlineId": "player1" },
    "PrivateInfo": { "Email": "player@example.com" }
  }
}
```

O registro pode incluir informações pessoais, como o endereço de email do jogador. O PlayFab
recomenda não armazená-las localmente; portanto, tenha cuidado com o local em que você salva ou para onde redireciona a saída.


## Related topics

- [Obter jogadores do título a partir de IDs de conta de jogador mestre](https://docs.xbox.com/pt-BR/services/playfab/api-references/rest/profiles/account-management/get-title-players-from-master-player-account-ids.md)
- [Usar modelos de email para enviar um email de recuperação de conta](https://docs.xbox.com/pt-BR/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email.md)
- [Início rápido da vinculação de contas](https://docs.xbox.com/pt-BR/services/playfab/identity/player-identity/login/quickstart.md)
- [Dados de jogador](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playfab/player-data.md)
- [Usar uma regra para verificar um endereço de email de contato](https://docs.xbox.com/pt-BR/services/playfab/live-service-management/game-configuration/title-communications/emails/using-a-rule-to-verify-a-contact-email-address.md)
