> ## 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 des joueurs

> Lisez et écrivez les données personnalisées d'un joueur à l'échelle du titre ou de l'éditeur.

Lisez et écrivez 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 certaines ou toutes les clés du joueur. |
| `playfab player-data set` | Définit une ou plusieurs clés. |
| `playfab player-data delete` | Supprime 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 joueur principal). |
| `--visibility` | Non | Niveau de données : `client` (par défaut), `read-only` ou `internal`. |
| `--publisher` | Non | Utilise 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 toutes les clés. `--value-only` avec `--key` affiche la valeur brute. `--if-changed-from-version` renvoie les données uniquement si leur version diffère ; 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 séparées par des virgules à supprimer. |

## Chemins de l'API PlayFab

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

| Portée et visibilité | API `get` | API `set` et `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 uniquement par le joueur, soit
`Public`, lisible également par les autres joueurs. PlayFab attribue à chaque clé qu'écrit `set`
l'autorisation que vous passez, en remplaçant celle qu'elle avait : `set` exige donc `--permission` pour ces
niveaux. L'autorisation s'applique à toutes les clés 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 également 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
```

Supprimer 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 des joueurs](https://docs.xbox.com/fr/services/playfab/player-progression/player-data/index.md)
- [Documentation de PlayFab Player progression](https://docs.xbox.com/fr/services/playfab/player-progression/index.md)
- [Démarrage rapide des données des joueurs](https://docs.xbox.com/fr/services/playfab/player-progression/player-data/quickstart.md)
- [RGPD PlayFab - Suppression et exportation des données des joueurs](https://docs.xbox.com/fr/services/playfab/data-analytics/privacy-compliance/playfab-gdpr-deleting-and-exporting-player-data.md)
- [RGPD PlayFab - Supprimer les données des joueurs](https://docs.xbox.com/fr/services/playfab/data-analytics/privacy-compliance/gdpr-deleting-player-data.md)
