> ## 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 título

> Lee, establece y elimina datos clave-valor de todo el título, ya sean legibles por el cliente o internos.

Administra los datos clave-valor de todo el título. Los comandos actúan sobre los datos de título legibles por el cliente, que
leen los clientes de juego de los jugadores, a menos que agregues `--internal` para actuar sobre los datos de título internos,
solo de servidor. Necesitas el permiso **Admin** en el título; consulta
[Cómo funciona la autenticación de PlayFab](https://docs.xbox.com/es/tools/xbox-cli/authentication.md#how-playfab-authentication-works).

| Comando | Ruta de la API de PlayFab | Descripción |
| - | - | - |
| `playfab title-data get` | `/Admin/GetTitleData` o `/Admin/GetTitleInternalData` | Lee una clave, varias claves o todas las claves. |
| `playfab title-data set` | `/Admin/SetTitleData` o `/Admin/SetTitleInternalData` | Establece una o varias claves. |
| `playfab title-data delete` | `/Admin/SetTitleData` o `/Admin/SetTitleInternalData`, con valores `null` | Quita una o varias claves. |

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

## `playfab title-data get`

```text theme={null}
xbox --playfab-title-id ABC123 playfab title-data get [key] [flags]
```

| Argumento u opción | Descripción |
| - | - |
| `[key]` | Una clave que se va a leer. Igual que `--key`; pasa uno u otro. Una clave en blanco se rechaza, en lugar de interpretarse como todas las claves. |
| `--key <key>` | Una clave que se va a leer. |
| `--keys <a,b,c>` | Claves separadas por comas que se van a leer. No se puede combinar con una sola clave. |
| `--internal` | Lee los datos de título internos en lugar de los datos de título legibles por el cliente. |

Omite la clave y `--keys` para leer todas las claves.

Un `get` de una clave imprime solo el valor de la clave. Para obtener JSON en su lugar, pasa `--output` para obtener
el sobre completo, o `--data-only` para obtener su `data`. La lectura de varias claves o de todas las claves
siempre devuelve JSON.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab title-data get MyKey
```

```text theme={null}
my-value
```

Cuando la clave no existe, `get` escribe `Key 'MyKey' was not found.` en stderr y
sale con el código `1`.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab title-data get MyKey --internal
xbox --playfab-title-id ABC123 playfab title-data get MyKey --output json
xbox --playfab-title-id ABC123 playfab title-data get --keys MyKey,OtherKey
xbox --playfab-title-id ABC123 playfab title-data get
```

## `playfab title-data set`

| Opción | Descripción |
| - | - |
| `--key <key>` | La clave que se va a establecer. Úsala con `--value`. |
| `--value <value>` | El valor de `--key`, que se almacena tal cual. |
| `--data <data>` | Un objeto JSON de pares clave-valor, para establecer varias claves a la vez. No se puede combinar con `--key` ni con `--value`. |
| `--internal` | Escribe datos de título internos en lugar de datos de título legibles por el cliente. |

Establecer una clave:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab title-data set --key MyKey --value my-value
```

O establecer varias claves a la vez:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab title-data set --data '{"MyKey":"my-value","OtherKey":"2"}'
```

Si se completa correctamente, `set` escribe las claves que estableció, como `{"applied":["MyKey","OtherKey"]}`.

## `playfab title-data delete`

| Opción | Obligatorio | Descripción |
| - | - | - |
| `--keys <a,b,c>` | Sí | Claves separadas por comas que se van a quitar. |
| `--internal` | No | Quita datos de título internos en lugar de datos de título legibles por el cliente. |

```bash theme={null}
xbox --playfab-title-id ABC123 playfab title-data delete --keys MyKey,OldKey
```

Si se completa correctamente, `delete` escribe las claves que quitó, como `{"applied":["MyKey","OldKey"]}`.

## Cuando una escritura de varias claves se detiene a medias

`set` y `delete` escriben una clave cada vez, en orden, y se detienen en la primera clave que
no se completa correctamente. Las claves anteriores se escribieron; las posteriores no se intentaron. El comando
sale con el código `1` y escribe un resumen en stderr:

| Campo | Significado |
| - | - |
| `applied` | Las claves que se escribieron. |
| `failed` | La clave que rechazó PlayFab, con su error. No se escribió. |
| `unknown` | La clave cuya solicitud puede haber llegado a PlayFab sin una respuesta concluyente, por ejemplo después de un tiempo de espera agotado, Ctrl+C o un error HTTP 5xx. Es posible que se haya escrito, así que compruébala con `title-data get` antes de volver a ejecutar el comando. |
| `notSent` | La clave cuya solicitud nunca salió, por ejemplo cuando falló el inicio de sesión. No se escribió. |

```json theme={null}
{
  "applied": ["MyKey"],
  "unknown": {
    "key": "OtherKey",
    "error": "The operation was canceled.",
    "outcomeUnknown": "/Admin/SetTitleData may have reached PlayFab, but the request was canceled, so its outcome is unknown. Check whether it was applied before retrying."
  }
}
```


## Related topics

- [Datos de jugador](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/player-data.md)
- [Datos del título](https://docs.xbox.com/es/services/playfab/live-service-management/game-configuration/titledata/index.md)
- [Inicio rápido de datos del título](https://docs.xbox.com/es/services/playfab/live-service-management/game-configuration/titledata/quickstart.md)
- [Almacenamiento de títulos](https://docs.xbox.com/es/services/xbox-services/storage/title-storage/index.md)
- [Eliminar invalidación de datos del título](https://docs.xbox.com/es/services/playfab/api-references/rest/admin/title-wide-data-management/delete-title-data-override.md)
