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

# Données de joueur

> Lisez et écrivez les données personnalisées d'un joueur dans la portée du titre ou de l'éditeur.

Lire et écrire les données personnalisées d'un joueur, soit pour le titre, soit partagées entre les
titres de l'éditeur.

| Commande | Description |
| - | - |
| `playfab player-data get` | Lit une partie ou la totalité des clés du joueur. |
| `playfab player-data set` | Définit une ou plusieurs clés. |
| `playfab player-data delete` | Retire une ou plusieurs clés. |

Les commandes `player-data` n'acceptent pas `--output table`.

## Options

Chaque commande `player-data` accepte ces options :

| Option | Obligatoire | Description |
| - | - | - |
| `--playfab-id` | Oui | L'ID PlayFab du joueur (ID du compte de joueur principal). |
| `--visibility` | Non | Niveau des données : `client` (par défaut), `read-only` ou `internal`. |
| `--publisher` | Non | Utiliser les données d'éditeur du joueur au lieu de ses données de titre. |

| Commande | Options |
| - | - |
| `player-data get` | `--key` pour une clé, ou `--keys` pour des clés séparées par des virgules; omettez les deux pour obtenir toutes les clés. `--value-only` avec `--key` affiche la valeur brute. `--if-changed-from-version` retourne les données seulement si leur version est différente; elle ne peut pas être combinée avec `--value-only`. |
| `player-data set` | Soit `--key` et `--value`, soit `--data` avec un objet JSON de clés et de valeurs. Les valeurs de type objet et tableau sont stockées sous forme de chaînes JSON. `--permission` est obligatoire, sauf avec `--visibility internal`, où elle n'est pas valide; consultez [Autorisation](#permission). |
| `player-data delete` | `--keys` (obligatoire), les clés à retirer, séparées par des virgules. |

## Chemins de l'API PlayFab

`--visibility` et `--publisher` sélectionnent l'API :

| Portée et visibilité | API de `get` | API de `set` et de `delete` |
| - | - | - |
| titre, `client` | `/Admin/GetUserData` | `/Admin/UpdateUserData` |
| titre, `read-only` | `/Admin/GetUserReadOnlyData` | `/Admin/UpdateUserReadOnlyData` |
| titre, `internal` | `/Admin/GetUserInternalData` | `/Admin/UpdateUserInternalData` |
| éditeur, `client` | `/Admin/GetUserPublisherData` | `/Admin/UpdateUserPublisherData` |
| éditeur, `read-only` | `/Admin/GetUserPublisherReadOnlyData` | `/Admin/UpdateUserPublisherReadOnlyData` |
| éditeur, `internal` | `/Admin/GetUserPublisherInternalData` | `/Admin/UpdateUserPublisherInternalData` |

## Autorisation

Une clé `client` ou `read-only` est soit `Private`, lisible seulement par le joueur, soit
`Public`, lisible aussi par les autres joueurs. PlayFab attribue à chaque clé qu'écrit `set`
l'autorisation que vous transmettez, en remplaçant celle qu'elle avait; `set` exige donc `--permission` pour ces
niveaux. L'autorisation s'applique à chaque clé de `--data`; pour attribuer des autorisations différentes à des
clés, définissez-les dans des commandes distinctes.

## Exemples

Afficher la valeur de la clé `level` d'un joueur :

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

Définir `level` dans les données en lecture seule du joueur, afin que les autres joueurs puissent aussi la lire :

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

Définir `rating` dans les données internes du joueur :

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

Retirer les clés `level` et `legacyFlag` du joueur :

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


## Related topics

- [Données de joueur (contenu)](https://docs.xbox.com/fr-CA/services/xbox-services/player-data/live-playerdata-nav.md)
- [Données des joueurs](https://docs.xbox.com/fr-CA/services/xbox-services/player-data/index.md)
- [Vue d'ensemble des données de joueur XBOX](https://docs.xbox.com/fr-CA/services/xbox-services/player-data/live-playerdata-overview.md)
- [Utiliser des objets d'entité pour stocker des données de joueur](https://docs.xbox.com/fr-CA/services/playfab/live-service-management/game-configuration/entities/entity-objects.md)
- [Démarrage rapide des données des joueurs](https://docs.xbox.com/fr-CA/services/playfab/player-progression/player-data/quickstart.md)
