> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Inicio rápido de datos del título

> Lea y escriba pares clave-valor de datos del título de PlayFab desde clientes y servidores de juego mediante las API GetTitleData y SetTitleData con ejemplos de código en C#.

Los datos del título son el conjunto de pares clave-valor de texto sin formato que se usan para almacenar y administrar los datos de configuración del juego de forma remota en el servidor. Mantienen accesibles y organizadas las variables de configuración de todo el título, que se pueden recuperar en el lado cliente.

Este inicio rápido describe cómo crear y usar mediante programación los datos del título.

Se trata de un tema importante porque almacenar los datos de configuración de un juego de forma remota en el servidor, donde se pueden cambiar en cualquier momento, es una de las razones más básicas para usar un servicio como PlayFab.

## Obtención de los datos del título

### Desde el cliente del juego

Use [GetTitleData](xref:titleid.playfabapi.com.client.title-widedatamanagement.gettitledata) de `PlayFabClientAPI` para obtener los pares clave-valor de un título específico. El siguiente ejemplo de código muestra los valores de todos los datos del título.

```csharp theme={null}
public void ClientGetTitleData() {
    PlayFabClientAPI.GetTitleData(new GetTitleDataRequest(),
        result => {
            if(result.Data == null || !result.Data.ContainsKey("MonsterName")) Debug.Log("No MonsterName");
            else Debug.Log("MonsterName: "+result.Data["MonsterName"]);
        },
        error => {
            Debug.Log("Got error getting titleData:");
            Debug.Log(error.GenerateErrorReport());
        }
    );
}
```

### Desde el servidor del juego

Use [GetTitleData](xref:titleid.playfabapi.com.server.title-widedatamanagement.gettitledata) de `PlayFabServerAPI` para obtener los pares clave-valor de un título específico. El siguiente ejemplo de código muestra los valores de todos los datos del título.

```csharp theme={null}
public void ServerGetTitleData() {
    PlayFabServerAPI.GetTitleData( new GetTitleDataRequest(),
        result => {
            if (result.Data == null || !result.Data.ContainsKey("MonsterName")) Debug.Log("No MonsterName");
            else Debug.Log("MonsterName: " + result.Data["MonsterName"]);
        },
        error => {
            Debug.Log("Got error getting titleData:");
            Debug.Log(error.GenerateErrorReport());
        });
}
```

## Establecimiento de los datos del título

Es poco probable que los datos del título cambien con mucha frecuencia. En la mayoría de las situaciones, debería usar los datos del título para datos estáticos que en gran medida no cambian durante la vida del título.

Puede establecer los datos del título mediante Game Manager o mediante una función de la API de servidor.

### Establecimiento de los datos del título mediante Game Manager

Para agregar datos principales del título a un título mediante Game Manager, siga estos pasos.

1. Abra el título en **Game Manager**.
2. Seleccione **Content** y, después, **Title Data**.
3. Seleccione **New Title Data**.
4. En la nueva página de datos del título, escriba un valor para la clave (**Key**) y un valor para el valor (**Value**). Tanto la **clave** como el **valor** se almacenan como cadenas.
5. Use el botón **Save** para guardar el nuevo elemento de datos.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-new-title-data.PNG?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=2aad92647840e49665b006d43d2b6128" alt="La captura de pantalla muestra nuevos datos del título." width="2965" height="1053" data-path="images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-new-title-data.PNG" />

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-add-primary-title-data.PNG?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=e4d36dac8aaf57c54f680f7bae73be7e" alt="Captura de pantalla de los datos del título" width="3000" height="1001" data-path="images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-add-primary-title-data.PNG" />

### Establecimiento de los datos del título mediante una llamada a la API de servidor en C

La API [SetTitleData](xref:titleid.playfabapi.com.server.title-widedatamanagement.settitledata) es una API de servidor a la que debe llamar desde un servidor dedicado. Solo puede establecer un par clave-valor de datos del título en cada llamada a `SetTitleData`.

```csharp theme={null}
public void SetTitleData() {
    PlayFabServerAPI.SetTitleData(
        new SetTitleDataRequest {
            Key = "MonsterName",
            Value = "Dorf"
        },
        result => Debug.Log("Set titleData successful"),
        error => {
            Debug.Log("Got error setting titleData:");
            Debug.Log(error.GenerateErrorReport());
        }
    );
}
```

### Establecimiento de invalidaciones de datos del título mediante Game Manager

Una invalidación es también un conjunto de pares clave-valor JSON y, en principio, debería destinarse a contener el cambio diferencial necesario en los pares clave-valor de los datos principales del título. El cambio diferencial puede consistir, en comparación con los datos principales del título, en pares clave-valor nuevos, en un cambio del valor de una clave existente o en la eliminación de una clave (con NULL como entrada del valor).

Para agregar invalidaciones a los datos principales del título, siga estos pasos.

1. Abra el título en **Game Manager**.
2. Seleccione **Content** y, después, **Title Data**.
3. Seleccione **New Override**.
4. Escriba la etiqueta de la invalidación y, además, escriba un valor para la clave (**Key**) y un valor para el valor (**Value**). Tanto la clave como el valor se almacenan como cadenas.
5. Use el botón **Save** para guardar la nueva invalidación de datos del título.

<Note>
  Por ahora, este conjunto de invalidación de pares clave-valor solo entra en vigor mediante los [experimentos](/services/playfab/live-service-management/game-configuration/experiments).
</Note>

Si el jugador pertenece a una variante de experimento que contiene invalidaciones de datos del título, las invalidaciones se aplican automáticamente en el lado servidor y se devuelven con los datos del título en el lado cliente.

<Note>
  Los valores de las invalidaciones de datos del título pueden tardar hasta un minuto en actualizarse y conservarse.
</Note>

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/titledata/tutorials/new-title-data-override.PNG?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=d0bf7381eb30bee016b63b5b8ae57eb0" alt="La captura de pantalla muestra una nueva invalidación de datos del título." width="2955" height="1006" data-path="images/playfab/live-service-management/game-configuration/titledata/tutorials/new-title-data-override.PNG" />

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/titledata/tutorials/set-title-data-override.PNG?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=a4f1978c4749d06b4767a0cfaf64bbd5" alt="La captura de pantalla muestra cómo establecer una nueva invalidación de datos del título." width="2999" height="974" data-path="images/playfab/live-service-management/game-configuration/titledata/tutorials/set-title-data-override.PNG" />

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-landing.PNG?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=2655a7e1a34589e3c6f19590262d3426" alt="La captura de pantalla muestra los datos del título y la invalidación." width="2969" height="1572" data-path="images/playfab/live-service-management/game-configuration/titledata/tutorials/title-data-landing.PNG" />

## Datos internos del título

De forma similar a los datos de usuario, los datos del título tienen un almacenamiento interno que está oculto para el cliente. Estos datos también se pueden establecer en Game Manager o mediante una API de servidor.

### Obtención de los datos internos del título mediante una llamada a la API de servidor en C \#

```csharp theme={null}
public void GetTitleInternalData()
{
    PlayFabServerAPI.GetTitleInternalData( new GetTitleDataRequest(),
        result => {
            if (result.Data == null || !result.Data.ContainsKey("PlayFab")) Debug.Log("No PlayFab");
            else Debug.Log("PlayFab: " + result.Data["PlayFab"]);
        },
        error => {
            Debug.Log("Got error getting titleData:");
            Debug.Log(error.GenerateErrorReport());
        }
    );
}
```

### Establecimiento de los datos internos del título mediante una llamada a la API de servidor en C \#

```csharp theme={null}
public void SetTitleInternalData() {
    PlayFabServerAPI.SetTitleInternalData(
        new SetTitleDataRequest {
            Key = "PlayFab",
            Value = "{ \"Status\": \"Secretly Awesome\" }"
        },
        result => { Debug.Log("Set titleData successful"); },
        error =>
        {
            Debug.Log("Got error setting titleData:");
            Debug.Log(error.GenerateErrorReport());
        });
}
```

## Consulte también

* [Uso de los datos del publicador](/services/playfab/live-service-management/game-configuration/titledata/using-publisher-data)
* [Inicio rápido de datos de jugador](/services/playfab/player-progression/player-data/quickstart)
* [Inicio rápido de CloudScript](/services/playfab/live-service-management/service-gateway/automation/cloudscript/quickstart)


## Related topics

- [Inicio rápido de datos del jugador](/es/services/playfab/player-progression/player-data/quickstart.md)
- [Datos del título](/es/services/playfab/live-service-management/game-configuration/titledata/index.md)
- [Uso de los datos del publicador](/es/services/playfab/live-service-management/game-configuration/titledata/using-publisher-data.md)
- [Inicio rápido del Explorador de datos](/es/services/playfab/data-analytics/learn-data/data-explorer/quickstart.md)
- [Inicio rápido de noticias del título](/es/services/playfab/live-service-management/game-configuration/title-communications/news/quickstart.md)
