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

# RGPD de PlayFab: exportar datos de jugador

> Cómo exportar los datos de un jugador de PlayFab para el cumplimiento del RGPD mediante ExportMasterPlayerData, incluidas las estadísticas, el inventario, las compras y el historial de eventos.

# Exportación de datos

Este artículo describe cómo exportar datos de jugador y de eventos desde PlayFab.

## Exportar los datos de la cuenta de jugador

Cuando realiza una solicitud para exportar los datos de un jugador, la solicitud se envía a un **agente de procesamiento de colas** (de forma similar a la eliminación de un jugador).

La API [ExportMasterPlayerData](https://learn.microsoft.com/en-us/rest/api/playfab/admin/account-management/export-master-player-data) exporta todos los datos asociados al `PlayFabId` proporcionado, incluidos los datos de todos sus títulos, como:

* **Estadísticas**
* **Datos personalizados**
* **Inventario**
* \**Compras* \*
* **Elementos creados por el jugador/UGC**
* **Historial de transacciones**
* **Saldos de moneda virtual**
* **Personajes**
* **Pertenencias a grupos**
* **Datos del publicador**
* **Datos de credenciales**
* **Vinculaciones de cuentas**
* **Lista de amigos**
* **Historial de eventos de PlayStream**.

Lea [Asegúrese de encontrar todos los datos](/services/playfab/data-analytics/privacy-compliance/playfab-gdpr-deleting-and-exporting-player-data), donde se detalla cómo asegurarse de que dispone de todos los PlayFabId de un jugador.

Esta API devuelve inmediatamente un `JobReceiptId`, que debería almacenar en sus registros para futuras consultas. La exportación puede tardar algún tiempo en estar disponible para su descarga.

Al completarse la exportación, se enviará un correo electrónico con el vínculo de descarga de la exportación a la dirección de correo electrónico de notificación configurada para el título.

La finalización de la tarea también desencadena un [evento de PlayStream `player_data_exported`](/services/playfab/api-references/events/PlayerIdentity/player-data-exported). El evento contiene el `JobReceiptId` como propiedad, así como la propiedad `ExportDownloadUrl`, que proporciona acceso a los datos exportados. Mediante las [reglas de automatización con Azure Functions](/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart#azure-functions-in-automation-rules) o los [webhooks](/services/playfab/data-analytics/acting-data/webhooks-overview), puede registrarse para recibir estos eventos en el punto de conexión que elija y procesarlos según sea necesario.

El siguiente ejemplo muestra cómo usar la API de administración con el [SDK de C#](/services/playfab/sdks/c-sharp). Si desea usar otro SDK, seleccione uno de la lista de [SDK de PlayFab](/services/playfab/sdks/playfab-sdk-intro).

```csharp theme={null}
public static async void ExportMasterPlayerExample(Action<PlayFabError> callback)
{
    var task = await PlayFabAdminAPI.ExportMasterPlayerDataAsync(new ExportMasterPlayerDataRequest()
    {
        PlayFabId = PlayFabId
    });

    if(task.Error != null)
    {
        callback(task.Error);
    }

    var jobReceiptId = task.Result.JobReceiptId;

    Console.WriteLine(string.Format("Export Player Request Received - Receipt: {0}", jobReceiptId));

    callback(null);
}
```

<Note>
  La dirección URL estará disponible durante un máximo de 30 días después de completarse la exportación. Transcurrido este tiempo, el archivo se eliminará y deberá iniciar una *nueva* solicitud de exportación.
</Note>

## Formato de los datos exportados

Los datos exportados se empaquetan en un archivo ZIP cuyo nombre contiene el `JobReceiptId` y la hora de la exportación. El archivo contiene varios archivos organizados en una estructura de directorios.

| Ruta de archivo                                                                                                              | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| /master\_player\_export.json                                                                                                 | <p>Un archivo JSON que contiene los datos del jugador registrados en PlayFab. Esto incluye los datos de cada uno de los títulos en los que participa el jugador.</p><p>El esquema del documento JSON se proporciona como una especificación de OpenAPI. Consulte el objeto `MasterPlayerDataExport` en `https://<your_title_id>.playfabapi.com/Swagger/MasterPlayerDataExport.swagger.json`</p>                                                                                                  |
| /CustomFiles/MasterPlayerFiles/\*                                                                                            | Contiene los [archivos de entidad](/services/playfab/live-service-management/game-configuration/entities/entity-files) personalizados asociados a la entidad `master_player_account` del jugador.                                                                                                                                                                                                                                                                                                |
| /CustomFiles/TitlePlayerFiles/\<TitlePlayerAccountId>/\*                                                                     | <p>Contiene los [archivos de entidad](/services/playfab/live-service-management/game-configuration/entities/entity-files) personalizados asociados a las entidades `title_player_account` del jugador.</p><p>Los archivos están organizados en un subdirectorio por cada título en el que participa el jugador. El nombre de cada subdirectorio es el identificador de entidad `title_player_account` del jugador en el título.</p>                                                              |
| /TitlePlayerEvents/\<TitleId>/event-history\_1.jsonl <br />...<br /> /TitlePlayerEvents/\<TitleId>/event-history\_\<N>.jsonl | <p>Los eventos de PlayStream y de telemetría registrados sobre el jugador.</p><p>Los archivos están organizados en un subdirectorio por cada título en el que participa el jugador. El nombre de cada subdirectorio es el identificador del título.</p><p>Cada subdirectorio contiene uno o varios archivos `event-history`, según la cantidad de datos que tenga el jugador en el título en cuestión. Los archivos contienen los eventos serializados en objetos JSON, un evento por línea.</p> |

## Exportar datos de eventos

PlayFab proporciona varios tipos de datos de eventos: datos personalizados, objetos de entidad y archivos de entidad.

### Exportar datos personalizados

Los datos personalizados hacen referencia a una amplia categoría de características que le permiten asociar datos arbitrarios a un jugador. PlayFab proporciona métodos para interactuar con los datos desde la lógica de su juego, pero por lo demás no interpreta ni entiende los datos.

#### Datos de jugador heredados

Al usar la API [ExportMasterPlayerData](https://learn.microsoft.com/en-us/rest/api/playfab/admin/account-management/export-master-player-data) (como se menciona en la sección de exportación de datos de PlayFab), todas las propiedades de datos de jugador se pueden encontrar en el archivo master\_player\_export.json en la raíz del archivo ZIP:

* Los datos de "Publisher" se pueden encontrar en la ruta JSONPath: \$.PublisherData
* Los datos por título se pueden encontrar en la ruta JSONPath: \$.Titles\[\*].CustomData

Estos valores también se pueden recuperar mediante API "get" dedicadas, en caso de que solo necesite exportar estos valores. La ventaja de las API dedicadas es que devuelven el resultado de inmediato. Sin embargo, según el diseño de esta característica, será necesario llamar a la API adecuada en función del tipo concreto de datos necesarios:

GetUserData, GetUserInternalData, GetUserReadOnlyData, GetUserPublisherData, GetUserPublisherInternalData, GetUserPublisherReadOnlyData

### Exportar objetos de entidad

Al usar la API [ExportMasterPlayerData](https://learn.microsoft.com/en-us/rest/api/playfab/admin/account-management/export-master-player-data), todos los objetos de entidad se pueden encontrar en el archivo **master\_player\_export.json** en la raíz del archivo ZIP:

Para los objetos de entidad **master\_player\_account**, en la ruta JSONPath: **\$.CustomObjects**

Para los objetos de entidad **title\_player\_account**, en la ruta JSONPath: **\$.Titles\[\*].CustomObjects**

Para los objetos de entidad de personaje, en la ruta JSONPath: **\$.Titles\[*].Characters\[*].CustomObjects**

Los objetos de entidad también se pueden recuperar mediante la API [GetObjects](https://learn.microsoft.com/en-us/rest/api/playfab/data/object/get-objects). Si ya sabe qué objetos de qué entidades está buscando, usar las API dedicadas puede ser más sencillo, ya que devuelven los objetos de inmediato. Sin embargo, la desventaja es que será necesario llamar a la API por separado para la entidad **master\_player\_account** del jugador, cada entidad **title\_player\_account** y cada entidad de personaje.

### Exportar archivos de entidad

Al usar la API [ExportMasterPlayerData](https://learn.microsoft.com/en-us/rest/api/playfab/admin/account-management/export-master-player-data), todos los archivos de entidad asociados al jugador se agregan tal cual al archivo ZIP en el directorio /CustomFiles/, en concreto:

Para la entidad **master\_player\_account** del jugador, los archivos están en /CustomFiles/MasterPlayerFiles/\*

Para **title\_player\_account**, los archivos están en /CustomFiles/TitlePlayerFiles/\<TitlePlayerAccountId>/\*

<Note>
  Existe un subdirectorio por cada entidad, con el identificador de la entidad title\_player\_account como nombre del directorio.
</Note>

Los archivos de entidad también se pueden descargar directamente. Primero, llame a la API [GetFiles](https://learn.microsoft.com/en-us/rest/api/playfab/data/file/get-files) para obtener metadatos sobre los archivos de la entidad. Cada documento de metadatos de archivo incluye una propiedad DownloadUrl, que se puede usar para descargar el archivo directamente.


## Related topics

- [RGPD de PlayFab: eliminación y exportación de datos de jugador](/es/services/playfab/data-analytics/privacy-compliance/playfab-gdpr-deleting-and-exporting-player-data.md)
- [RGPD de PlayFab: eliminar datos de jugador](/es/services/playfab/data-analytics/privacy-compliance/gdpr-deleting-player-data.md)
- [Documentación de progresión del jugador de PlayFab](/es/services/playfab/player-progression/index.md)
- [Documentación de datos y análisis de PlayFab](/es/services/playfab/data-analytics/index.md)
- [Información general del juego de demostración de PlayFab Winter Starfall](/es/services/playfab/demo-game/overview.md)