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

# Datos de jugador

> Lee y escribe los datos personalizados de un jugador con ámbito de título o de publicador.

Lee y escribe los datos personalizados de un jugador, ya sea para el título o compartidos entre los
títulos del publicador.

| Comando | Descripción |
| - | - |
| `playfab player-data get` | Lee algunas o todas las claves del jugador. |
| `playfab player-data set` | Establece una o varias claves. |
| `playfab player-data delete` | Quita una o varias claves. |

Los comandos `player-data` no aceptan `--output table`.

## Opciones

Todos los comandos `player-data` aceptan estas opciones:

| Opción | Obligatorio | Descripción |
| - | - | - |
| `--playfab-id` | Sí | El identificador de PlayFab del jugador (identificador de cuenta de jugador maestra). |
| `--visibility` | No | Nivel de datos: `client` (predeterminado), `read-only` o `internal`. |
| `--publisher` | No | Usa los datos de publicador del jugador en lugar de sus datos de título. |

| Comando | Opciones |
| - | - |
| `player-data get` | `--key` para una clave, o `--keys` para claves separadas por comas; omite ambas para obtener todas las claves. `--value-only` con `--key` imprime solo el valor. `--if-changed-from-version` devuelve los datos solo si su versión es distinta; no se puede combinar con `--value-only`. |
| `player-data set` | `--key` y `--value`, o bien `--data` con un objeto JSON de claves y valores. Los valores de objeto y de matriz se almacenan como cadenas JSON. `--permission` es obligatoria, excepto con `--visibility internal`, donde no es válida; consulta [Permiso](#permission). |
| `player-data delete` | `--keys` (obligatoria), las claves separadas por comas que se van a quitar. |

## Rutas de la API de PlayFab

`--visibility` y `--publisher` seleccionan la API:

| Ámbito y visibilidad | API de `get` | API de `set` y `delete` |
| - | - | - |
| título, `client` | `/Admin/GetUserData` | `/Admin/UpdateUserData` |
| título, `read-only` | `/Admin/GetUserReadOnlyData` | `/Admin/UpdateUserReadOnlyData` |
| título, `internal` | `/Admin/GetUserInternalData` | `/Admin/UpdateUserInternalData` |
| publicador, `client` | `/Admin/GetUserPublisherData` | `/Admin/UpdateUserPublisherData` |
| publicador, `read-only` | `/Admin/GetUserPublisherReadOnlyData` | `/Admin/UpdateUserPublisherReadOnlyData` |
| publicador, `internal` | `/Admin/GetUserPublisherInternalData` | `/Admin/UpdateUserPublisherInternalData` |

## Permiso

Una clave `client` o `read-only` es `Private`, que solo puede leer el jugador, o
`Public`, que también pueden leer otros jugadores. PlayFab asigna a cada clave que escribe `set` el
permiso que pasas, en sustitución del que tenía, por lo que `set` requiere `--permission` para esos
niveles. El permiso se aplica a todas las claves de `--data`; para asignar permisos distintos a las claves,
establécelas en comandos separados.

## Ejemplos

Imprimir el valor de la clave `level` de un jugador:

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

Establecer `level` en los datos de solo lectura del jugador, para que otros jugadores también puedan leerlo:

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

Establecer `rating` en los datos internos del jugador:

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

Quitar las claves `level` y `legacyFlag` del jugador:

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


## Related topics

- [Datos de jugador](https://docs.xbox.com/es/services/playfab/player-progression/player-data/index.md)
- [Documentación de progresión del jugador de PlayFab](https://docs.xbox.com/es/services/playfab/player-progression/index.md)
- [Datos de jugador (contenido)](https://docs.xbox.com/es/services/xbox-services/player-data/live-playerdata-nav.md)
- [Uso de objetos de entidad para almacenar datos de jugador](https://docs.xbox.com/es/services/playfab/live-service-management/game-configuration/entities/entity-objects.md)
- [RGPD de PlayFab: exportar datos de jugador](https://docs.xbox.com/es/services/playfab/data-analytics/privacy-compliance/gdpr-exporting-player-data.md)
