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

# Dados de jogador

> Leia e grave os dados personalizados de um jogador no escopo do título ou do editor.

Leia e grave os dados personalizados de um jogador, seja para o título ou compartilhados entre os
títulos do editor.

| Comando | Descrição |
| - | - |
| `playfab player-data get` | Lê algumas ou todas as chaves do jogador. |
| `playfab player-data set` | Define uma ou mais chaves. |
| `playfab player-data delete` | Remove uma ou mais chaves. |

Os comandos `player-data` não aceitam `--output table`.

## Opções

Todos os comandos `player-data` aceitam estas opções:

| Opção | Obrigatória | Descrição |
| - | - | - |
| `--playfab-id` | Sim | A ID do PlayFab do jogador (ID da conta de jogador mestre). |
| `--visibility` | Não | Camada de dados: `client` (padrão), `read-only` ou `internal`. |
| `--publisher` | Não | Usa os dados de editor do jogador em vez dos dados de título dele. |

| Comando | Opções |
| - | - |
| `player-data get` | `--key` para uma chave ou `--keys` para chaves separadas por vírgulas; omita ambas para obter todas as chaves. `--value-only` com `--key` imprime somente o valor. `--if-changed-from-version` retorna os dados somente se a versão deles for diferente; não pode ser combinada com `--value-only`. |
| `player-data set` | `--key` e `--value` ou `--data` com um objeto JSON de chaves e valores. Valores de objeto e de matriz são armazenados como cadeias de caracteres JSON. `--permission` é obrigatória, exceto com `--visibility internal`, em que não é válida; consulte [Permissão](#permission). |
| `player-data delete` | `--keys` (obrigatória), as chaves separadas por vírgulas a serem removidas. |

## Caminhos da API do PlayFab

`--visibility` e `--publisher` selecionam a API:

| Escopo e visibilidade | API de `get` | API de `set` e `delete` |
| - | - | - |
| título, `client` | `/Admin/GetUserData` | `/Admin/UpdateUserData` |
| título, `read-only` | `/Admin/GetUserReadOnlyData` | `/Admin/UpdateUserReadOnlyData` |
| título, `internal` | `/Admin/GetUserInternalData` | `/Admin/UpdateUserInternalData` |
| editor, `client` | `/Admin/GetUserPublisherData` | `/Admin/UpdateUserPublisherData` |
| editor, `read-only` | `/Admin/GetUserPublisherReadOnlyData` | `/Admin/UpdateUserPublisherReadOnlyData` |
| editor, `internal` | `/Admin/GetUserPublisherInternalData` | `/Admin/UpdateUserPublisherInternalData` |

## Permissão

Uma chave `client` ou `read-only` é `Private`, legível somente pelo jogador, ou
`Public`, legível também por outros jogadores. O PlayFab atribui a todas as chaves que `set` grava a
permissão que você passa, substituindo a que elas tinham; por isso, `set` exige `--permission` para essas
camadas. A permissão se aplica a todas as chaves em `--data`; para atribuir permissões diferentes
às chaves, defina-as em comandos separados.

## Exemplos

Imprimir o valor da chave `level` de um jogador:

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

Definir `level` nos dados somente leitura do jogador, para que outros jogadores também possam lê-la:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab player-data set --playfab-id PLAYER123 --visibility read-only --key level --value 5 --permission Public
```

Definir `rating` nos dados internos do jogador:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab player-data set --playfab-id PLAYER123 --visibility internal --key rating --value 1500
```

Remover as chaves `level` e `legacyFlag` do jogador:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab player-data delete --playfab-id PLAYER123 --keys level,legacyFlag
```


## Related topics

- [Ferramenta de redefinição de dados do jogador (XblPlayerDataReset.exe)](https://docs.xbox.com/pt-BR/tools/tools-services/live-player-data-reset.md)
- [GDPR do PlayFab - Exportar dados do jogador](https://docs.xbox.com/pt-BR/services/playfab/data-analytics/privacy-compliance/gdpr-exporting-player-data.md)
- [GDPR do PlayFab - Excluir dados do jogador](https://docs.xbox.com/pt-BR/services/playfab/data-analytics/privacy-compliance/gdpr-deleting-player-data.md)
- [Dados do jogador](https://docs.xbox.com/pt-BR/services/playfab/player-progression/player-data/index.md)
- [Início rápido de dados do jogador](https://docs.xbox.com/pt-BR/services/playfab/player-progression/player-data/quickstart.md)
