Exporta datos desde Analytics

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Apigee Analytics recopila y analiza un amplio espectro de datos que fluye entre tus API y proporciona herramientas de visualización, incluidos paneles interactivos, informes personalizados y otras herramientas que identifican tendencias en el rendimiento del proxy de API.

Ahora puedes desbloquear este contenido enriquecido si exportas los datos de estadísticas de Apigee Analytics a tu propio repositorio de datos, como Google Cloud Storage o Google BigQuery. Luego, puedes aprovechar las potentes capacidades de consulta y aprendizaje automático que ofrecen Google BigQuery y TensorFlow para realizar tu propio análisis de datos. También puedes combinar los datos de estadísticas exportados con otros datos, como registros web, para obtener estadísticas nuevas sobre tus usuarios, las API y las aplicaciones.

¿Qué formatos de datos de exportación se admiten?

Exporta datos de estadísticas a uno de los siguientes formatos:

Valores separados por comas (CSV)

El delimitador predeterminado es un carácter de coma (,). Los caracteres delimitadores admitidos incluyen coma (,), barra vertical (|) y tabulación (\t). Configura el valor con la propiedad csvDelimiter, como se describe en Referencia de la propiedad de la solicitud de exportación.
JSON (delimitado por saltos de línea)

Permite usar el carácter de nueva línea como delimitador.

Los datos exportados incluyen todas las métricas y dimensiones de estadísticas compiladas en Apigee y cualquier dato de estadísticas personalizado que agregues. Para obtener una descripción de los datos exportados, consulta la Referencia sobre las métricas, las dimensiones y los filtros de Analytics.

Puedes exportar datos de estadísticas a los siguientes repositorios de datos:

Pasos para exportar tus datos de estadísticas

Los siguientes pasos resumen el proceso que se usa para exportar tus datos de estadísticas:

Configura tu repositorio de datos (Cloud Storage o BigQuery) para la exportación de datos. Debes asegurarte de que tu repositorio de datos se haya configurado de forma correcta y que la cuenta de servicio del agente de servicios de Apigee que se usa para escribir datos en el repositorio de datos tenga los permisos adecuados.

Crea un almacén de datos que defina las propiedades del repositorio de datos (Cloud Storage o BigQuery) donde exportas tus datos.

Exporta los datos de estadísticas. La exportación de datos se ejecuta de forma asíncrona en segundo plano.

Consulta el estado de la solicitud de exportación para determinar cuándo se completa.

Cuando se complete la exportación, accede a los datos exportados en tu repositorio de datos.

En las siguientes secciones, se describen esos pasos con más detalle.

Configura tu repositorio de datos

Configura Cloud Storage o BigQuery para habilitar el acceso mediante la exportación de datos de estadísticas.

Configura Google Cloud Storage

Antes de exportar datos a Google Cloud Storage, debes hacer lo siguiente:

Crea un bucket de Google Cloud Storage.
Asegúrate de que la API de BigQuery esté habilitada en tu proyecto de Google Cloud Platform. Apigee usa la API de BigQuery para aprovechar las funciones de exportación de BigQuery cuando realiza exportaciones a Cloud Storage.

Consulta Habilita las API para obtener instrucciones.
Asegúrate de que la cuenta de servicio del Agente de servicio de Apigee con la dirección de correo electrónico de miembro service-project-number@gcp-sa-apigee.iam.gserviceaccount.com se asigne a las siguientes funciones:
- Usuario de trabajo de BigQuery
- Administrador de almacenamiento
Nota: Si la cuenta de servicio ya existe, no es necesario que crees una cuenta nueva, solo cambia los roles para la cuenta existente.

project-number aparece en la página principal del proyecto, como se muestra a continuación.

Consulta Otorga, cambia y revoca el acceso a recursos.

Como alternativa, si quieres modificar una función existente o crear una función personalizada, agrega los siguientes permisos a la función:
- bigquery.jobs.create
- storage.objects.create
- storage.objects.delete
- storage.objects.list
Nota: Después de cambiar las funciones de una cuenta de servicio, debes esperar un minuto o más para que se aplique el cambio.

Configura Google BigQuery

Sigue estos pasos para exportar datos a Google BigQuery:

Asegúrate de haber habilitado BigQuery en tu proyecto de Google Cloud Platform.
Asegúrate de que la API de BigQuery esté habilitada en tu proyecto de Google Cloud Platform. Consulta Habilita las API para obtener instrucciones.
Asegúrate de que la cuenta de servicio del Agente de servicio de Apigee con la dirección de correo electrónico de miembro service-project-number@gcp-sa-apigee.iam.gserviceaccount.com se asigne a las siguientes funciones:
- Usuario de trabajo de BigQuery
- Editor de datos de BigQuery
Nota: Si la cuenta de servicio ya existe, no es necesario que crees una cuenta nueva, solo cambia los roles para la cuenta existente.

project-number aparece en la página principal del proyecto, como se muestra a continuación.

Consulta Otorga, cambia y revoca el acceso a recursos.

Si deseas modificar una función existente o crear una función personalizada, agrega los siguientes permisos a la función:
- bigquery.datasets.create
- bigquery.datasets.get
- bigquery.jobs.create
- bigquery.tables.create
- bigquery.tables.get
- bigquery.tables.updateData
Nota: Después de cambiar las funciones de una cuenta de servicio, debes esperar un minuto o más para que se aplique el cambio.
Crea un conjunto de datos de BigQuery.

Exporta datos a BigQuery para una región individual en EE.UU. o la UE

Debido a que los datos de estadísticas para EE.UU. o la UE se almacenan en la multirregión US o EU, no puedes exportar los datos directamente a una región individual de US o EU en BigQuery. Como solución alternativa, primero puedes exportar los datos a Google Cloud Storage y, luego, transferirlos a BigQuery de la siguiente manera:

Crea un bucket de Cloud Storage y configura la Ubicación en la región individual de US o EU que deseas asociar a los datos en BigQuery.
Crea un almacén de datos de Cloud Storage con el bucket de almacenamiento que creaste en el paso anterior.
Exportar los datos a Cloud Storage. Consulta el Ejemplo 1: Exporta datos a Cloud Storage a continuación para ver un ejemplo.
Carga los datos en BigQuery, como se describe en las siguientes secciones:
- Carga datos de CSV desde Cloud Storage
- Carga datos JSON desde Cloud Storage

Administrar almacenes de datos

datastore define la conexión con tu repositorio de datos de exportación (Cloud Storage, BigQuery).

En las siguientes secciones, se describe cómo crear y administrar los almacenes de datos. Antes de crear un almacén de datos, se recomienda que pruebes la configuración del repositorio de datos.

Prueba la configuración del repositorio de datos

Cuando creas el repositorio de datos, Apigee no prueba ni valida que la configuración sea válida. Esto significa que puedes crear el almacén de datos (en el siguiente paso) y no detectar ningún error hasta que ejecutes tu primera exportación de datos.

Dado que un proceso de exportación de datos puede demorar mucho tiempo en ejecutarse, puedes detectar errores con anterioridad si pruebas la configuración del repositorio de datos a fin de asegurarte de que sea válida y para corregir cualquier error antes de crear el almacén de datos.

Para probar la configuración del repositorio de datos, envía una solicitud POST a la API de /organizations/{org}/analytics/datastores:test. Pasa la siguiente información en el cuerpo de la solicitud:

Nombre visible
Tipo de Datastore
Detalles de configuración según el tipo de almacén de datos, como se describe en Referencia de propiedad de solicitud de Datastore.

En el siguiente ejemplo, se prueba una configuración de repositorio de datos de Cloud Storage:

curl "https://apigee.googleapis.com/v1/organizations/myorg/analytics/datastores:test" \
  -X POST \
  -H "Content-type:application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d \
  '{
    "displayName": "My Cloud Storage datastore",
    "targetType": "gcs",
    "datastoreConfig": {
      "projectId": "my-project",
      "bucketName": "my-bucket",
      "path": "my/analytics/path"
    }
  }'

A continuación, se proporciona un ejemplo de la respuesta si la prueba es correcta:

{
  "state": "completed",
}

A continuación, se proporciona un ejemplo de la respuesta si la prueba falló:

{
  "state": "failed",
  "error": "<error message>"
}

En este caso, soluciona los problemas indicados en el mensaje de error y vuelve a probar la configuración del repositorio de datos. Después de realizar una prueba de forma correcta, crea el almacén de datos como se describe en la siguiente sección.

Crea un almacén de datos

Para crear un almacén de datos, envía una solicitud POST a la API /organizations/{org}/analytics/datastores. Pasa la siguiente información en el cuerpo de la solicitud:

Nombre visible
Tipo de Datastore
Detalles de configuración según el tipo de almacén de datos, como se describe en Referencia de propiedad de solicitud de Datastore.

A continuación, se proporcionan ejemplos para cada tipo de almacén de datos.

A continuación, se proporciona un ejemplo de la respuesta para un repositorio de datos de Cloud Storage:

{
    "self": "/organizations/myorg/analytics/datastores/c7d3b5aq-1c64-3389-9c43-b211b60de35b",
    "displayName": "My Cloud Storage datastore",
    "org": "myorg",
    "targetType": "gcs",
    "createTime": "1535411583949",
    "lastUpdateTime": "1535411634291",
    "datastoreConfig": {
          "projectId": "my-project",
          "bucketName": "my-bucket",
          "path": "my/analytics/path"
    }
}

Usa la URL que se muestra en la propiedad self para ver los detalles del almacén de datos, como se describe en Visualiza los detalles de un almacén de datos.

Para obtener más información, consulta Crear la API del almacén de datos.

Ejemplo 1: Crea un almacén de datos de Cloud Storage

En la siguiente solicitud, se crea un almacén de datos de Cloud Storage:

curl "https://apigee.googleapis.com/v1/organizations/myorg/analytics/datastores" \
  -X POST \
  -H "Content-type:application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d \
  '{
    "displayName": "My Cloud Storage datastore",
    "targetType": "gcs",
    "datastoreConfig": {
      "projectId": "my-project",
      "bucketName": "my-bucket",
      "path": "my/analytics/path"
    }
  }'

En el ejemplo anterior, $TOKEN está configurado como tu token de acceso de OAuth 2.0, como se describe en Obtén un token de acceso de OAuth 2.0. Para obtener información sobre las opciones de curl que se usan en este ejemplo, consulta Usa curl. Si deseas obtener una descripción de las variables de entorno que se usaron, consulta Configura variables de entorno para solicitudes a la API de Apigee.

Ejemplo2: Crea un almacén de datos de BigQuery

La siguiente solicitud crea un almacén de datos de BigQuery:

curl "https://apigee.googleapis.com/v1/organizations/myorg/analytics/datastores" \
  -X POST \
  -H "Content-type:application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d \
  '{
    "displayName": "My BigQuery datastore",
    "targetType": "bigquery",
    "datastoreConfig": {
      "projectId": "my-project",
      "datasetName": "mybigquery",
      "tablePrefix": "bqprefix"
    }
  }'

Visualiza todos los almacenes de datos

Para ver todos los almacenes de datos de tu organización, envía una solicitud GET a la API de /organizations/{org}/analytics/datastores.

Por ejemplo:

curl "https://apigee.googleapis.com/v1/organizations/myorg/analytics/datastores" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

En el ejemplo anterior, $TOKEN está configurado como tu token de acceso de OAuth 2.0, como se describe en Obtén un token de acceso de OAuth 2.0. Para obtener información sobre las opciones de curl que se usan en este ejemplo, consulta Usa curl. Para obtener una descripción de las variables de entorno utilizadas, consulta Configura variables de entorno para solicitudes a la API de Apigee.

A continuación, se proporciona un ejemplo de la respuesta.

{
  "datastores": [
  {
    "self": "/organizations/myorg/analytics/datastores/c7d3b5aq-1c64-3389-9c43-b211b60de35b",
    "displayName": "My Cloud Storage datastore",
    "org": "myorg",
    "targetType": "gcs",
    "createTime": "1535411583949",
    "lastUpdateTime": "1535411634291",
    "datastoreConfig": {
          "projectId": "my-project",
          "bucketName": "my-bucket",
          "path": "my/analytics/path"
    }
  },
  {
    "self": "/organizations/myorg/analytics/datastores/g8c3f0mk-1f78-8837-9c67-k222b60ce30b",
    "displayName": "My BigQuery datastore",
    "org": "myorg",
    "targetType": "bigquery",
    "createTime": "1535411583949",
    "lastUpdateTime": "1535411634291",
    "datastoreConfig": {
      "projectId": "my-project",
      "datasetName": "mybigquery",
      "tablePrefix": "bqprefix"
    }
  }
  ]
}

Para obtener más información, consulta la Lista de API de Datastore.

Visualiza los detalles de un almacén de datos

Para ver los detalles de un almacén de datos, envía una solicitud GET a la API de /organizations/{org}/analytics/datastores/{datastore}.

Por ejemplo:

curl "https://apigee.googleapis.com/v1/organizations/myorg/analytics/datastores/c7d3b5aq-1c64-3389-9c43-b211b60de35b" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

A continuación, se proporciona un ejemplo de la respuesta de un almacén de datos de Cloud Storage:

{
    "self": "/organizations/myorg/analytics/datastores/c7d3b5aq-1c64-3389-9c43-b211b60de35b",
    "displayName": "My Cloud Storage datastore",
    "org": "myorg",
    "targetType": "gcs",
    "createTime": "1535411583949",
    "lastUpdateTime": "1535411634291",
    "datastoreConfig": {
          "projectId": "my-project",
          "bucketName": "my-bucket",
          "path": "my/analytics/path"
    }
}

Para obtener más información, consulta Obtén la API del almacén de datos.

Modifica un almacén de datos

Para modificar un almacén de datos, envía una solicitud PUT a la API de /organizations/{org}/analytics/datastores/{datastore}. Pasa toda o un subconjunto de la información siguiente en el cuerpo de la solicitud:

Nombre visible de Datastore
Detalles de configuración según el tipo de almacén de datos, como se describe en Referencia de propiedad de solicitud de Datastore.

Por ejemplo, para actualizar un almacén de datos de Cloud Storage, sigue estos pasos:

curl "https://apigee.googleapis.com/v1/organizations/myorg/analytics/datastores" \
  -X PUT \
  -H "Content-type:application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d \
  '{
    "displayName": "My Cloud Storage datastore",
    "datastoreConfig": {
      "projectId": "my-project",
      "bucketName": "my-bucket",
      "path": "my/analytics/path"
    }
  }'

A continuación, se proporciona un ejemplo de la respuesta de un almacén de datos de Cloud Storage:

{
    "self": "/organizations/myorg/analytics/datastores/c7d3b5aq-1c64-3389-9c43-b211b60de35b",
    "displayName": "My Cloud Storage datastore",
    "org": "myorg",
    "targetType": "gcs",
    "createTime": "1535411583949",
    "lastUpdateTime": "1535411634291",
    "datastoreConfig": {
          "projectId": "my-project",
          "bucketName": "my-bucket",
          "path": "my/analytics/path"
    }
}

Para obtener más información, consulta Actualiza la API del almacén de datos.

Borra un almacén de datos

Para borrar un almacén de datos, envía una solicitud DELETE a la API de/organizations/{org}/analytics/datastores/{datastore}.

Por ejemplo:

curl "https://apigee.googleapis.com/v1/organizations/myorg/analytics/datastores/c7d3b5aq-1c64-3389-9c43-b211b60de35b" \
  -X DELETE \
  -H "Authorization: Bearer $TOKEN"

En el ejemplo anterior, $TOKEN está configurado como tu token de acceso de OAuth 2.0, como se describe en Obtén un token de acceso de OAuth 2.0. Para obtener información sobre las opciones de curl que se usan en este ejemplo, consulta Usa curl. Para obtener una descripción de las variables de entorno utilizadas, consulta Configura variables de entorno para solicitudes a la API de Apigee.

A continuación, se proporciona un ejemplo de la respuesta.

{}

Para obtener más información, consulta Borra la API del almacén de datos.

Exporta datos de estadísticas

Para exportar datos de estadísticas, envía una solicitud POST a la API de /organizations/{org}/environments/{env}/analytics/exports. Pasa la siguiente información en el cuerpo de la solicitud:

Nombre y descripción de la solicitud de exportación
Período de los datos exportados (el valor solo puede abarcar un día)
Formato de los datos exportados
Nombre del almacén de datos

A continuación, se proporcionan ejemplos de solicitudes de exportación. Para obtener una descripción completa de las propiedades del cuerpo de la solicitud, consulta Referencia de la propiedad de la solicitud de exportación.

La respuesta del POST tiene el siguiente formato:

{
    "self": "/organizations/myorg/environments/test/analytics/exports/a7c2f0dd-1b53-4917-9c42-a211b60ce35b",
    "created": "2017-09-28T12:39:35Z",
    "state": "enqueued"
}

Ten en cuenta que la propiedad state de la respuesta se configura como enqueued. La solicitud POST funciona de forma asíncrona. Esto significa que continuará ejecutándose en segundo plano después de que la solicitud muestre una respuesta. Los valores posibles para state incluyen enqueued, running, completed, failed.

Usa la URL que se muestra en la propiedad self para ver el estado de la solicitud de exportación de datos, como se describe en Visualiza el estado de una solicitud de exportación de estadísticas. Cuando la solicitud se completa, el valor de la propiedad state en la respuesta se configura como completed. Luego, puedes acceder a los datos de estadísticas en el almacén de datos.

Para obtener más información, consulta Crea API de exportación de datos.

Ejemplo 1: Exporta datos a Cloud Storage

En el ejemplo siguiente, se exporta un conjunto completo de datos sin procesar durante las últimas 24 horas del entorno de prueba a la organización myorg. El contenido se exporta a Cloud Storage en JSON:

curl "https://apigee.googleapis.com/v1/organizations/myorg/environments/test/analytics/exports" \
  -X POST \
  -H "Content-type:application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d \
  '{
    "name": "Export raw results to Cloud Storage",
    "description": "Export raw results to Cloud Storage for last 24 hours",
    "dateRange": {
      "start": "2020-06-08",
      "end": "2020-06-09"
    },
    "outputFormat": "json",
    "datastoreName": "My Cloud Storage data repository"
  }'

En el ejemplo anterior, $TOKEN está configurado como tu token de acceso de OAuth 2.0, como se describe en Obtén un token de acceso de OAuth 2.0. Para obtener información sobre las opciones de curl que se usan en este ejemplo, consulta Usa curl. Para obtener una descripción de las variables de entorno utilizadas, consulta Configura variables de entorno para solicitudes a la API de Apigee.

Usa el URI que especifica la propiedad self para supervisar el estado del trabajo como se describe en Visualiza el estado de una solicitud de exportación de estadísticas.

Ejemplo 2: Exporta datos a BigQuery

Nota: La ubicación de los datos para el conjunto de datos de BigQuery debe ser igual que la analytics_location. Para regiones de estadísticas en EE.UU. o la UE:

Si la región es parte de EE.UU., configura Ubicación de los datos como us (varias regiones en Estados Unidos).
Si la región de estadísticas es parte de la UE, configura Ubicación de datos como eu (varias regiones en la Unión Europea).

En el siguiente ejemplo, se exporta un archivo CSV delimitado por comas a BigQuery:

curl "https://apigee.googleapis.com/v1/organizations/myorg/environments/test/analytics/exports" \
  -X POST \
  -H "Content-type:application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d \
  '{
    "name": "Export query results to BigQuery",
    "description": "One-time export to BigQuery",
    "dateRange": {
      "start": "2018-06-08", 
      "end": "2018-06-09"
    },
    "outputFormat": "csv",
    "csvDelimiter": ",", 
    "datastoreName": "My BigQuery data repository"
  }'

En el ejemplo anterior, $TOKEN está configurado como tu token de acceso de OAuth 2.0, como se describe en Obtén un token de acceso de OAuth 2.0. Para obtener información sobre las opciones de curl que se usan en este ejemplo, consulta Usa curl. Para obtener una descripción de las variables de entorno utilizadas, consulta Configura variables de entorno para solicitudes a la API de Apigee.

Nota: El archivo CSV exportado crea una tabla de BigQuery con el siguiente prefijo:

<PREFIX>_<EXPORT_DATE>_api_<UUID>_from_<FROM_DATE>_to_<TO_DATE>

Usa el URI que especifica la propiedad self para supervisar el estado del trabajo como se describe en Visualiza el estado de una solicitud de exportación de estadísticas.

00:08:03,995 --> 00:08:06,690

Información sobre las cuotas de la API de exportación

Para evitar el uso excesivo de costosas llamadas a la API de exportación de datos, Apigee aplica una cuota de 15 llamadas por día a la organización en llamadas a la API de organizations/{org}/environments/{env}/analytics/exports.

Si excedes la cuota de llamada, la API muestra una respuesta HTTP 429.

Visualiza el estado de todas las solicitudes de exportación de estadísticas

Para ver el estado de todas las solicitudes de exportación de estadísticas, envía una solicitud GET a /organizations/{org}/environments/{env}/analytics/exports.

Por ejemplo, la siguiente solicitud muestra el estado de todas las solicitudes de exportación de estadísticas para el entorno test en la organización myorg:

curl "https://apigee.googleapis.com/v1/organizations/myorg/environments/test/analytics/exports" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

A continuación, se proporciona un ejemplo de la respuesta que muestra dos solicitudes de exportación, una en cola (creada y en la cola) y otra completada:

[
  {
    "self":
"/v1/organizations/myorg/environments/test/analytics/exports/e8b8db22-fe03-4364-aaf2-6d4f110444ba",
    "name": "Export results To Cloud Storage",
    "description": "One-time export to Cloud Storage",
    "userId": "my@email.com",
    "datastoreName": "My datastore",
    "executionTime": "36 seconds",
    "created": "2018-09-28T12:39:35Z",
    "updated": "2018-09-28T12:39:42Z",
    "state": "enqueued"
  },
  {
    "self":
"/v1/organizations/myorg/environments/test/analytics/exports/9870987089fe03-4364-aaf2-6d4f110444ba"
    "name": "Export raw results to BigQuery",
    "description": "One-time export to BigQuery",
    ... 
  }
]

Para obtener más información, consulta Enumera la API de exportaciones de datos.

Visualiza el estado de una solicitud de exportación de estadísticas

Para ver el estado de una solicitud de exportación de estadísticas específica, envía una solicitud GET a /organizations/{org}/environments/{env}/analytics/exports/{exportId}, en la que {exportId} es el ID asociado a la solicitud de exportación de estadísticas.

Nota: La URL para verificar el estado de una solicitud se muestra en la propiedad self cuando envías una solicitud de exportación. Para obtener el ID de una solicitud de exportación de estadísticas, consulta una lista de todas las solicitudes de exportación de estadísticas y sus ID asociados, como se describe en Visualiza el estado de todas las solicitudes de exportación de estadísticas.

Por ejemplo, la siguiente solicitud muestra el estado de la solicitud de exportación de estadísticas con el ID 4d6d94ad-a33b-4572-8dba-8677c9c4bd98.

curl "https://apigee.googleapis.com/v1/organizations/myorg/environments/test/analytics/exports/4d6d94ad-a33b-4572-8dba-8677c9c4bd98" \
  -X GET \
  -H "Authorization: Bearer $TOKEN"

A continuación, se proporciona un ejemplo de la respuesta.

{
  "self":
"/v1/organizations/myorg/environments/test/analytics/exports/4d6d94ad-a33b-4572-8dba-8677c9c4bd98",
  "name": "Export results to Cloud Storage",
  "description": "One-time export to Cloud Storage",
  "userId": "my@email.com",
  "datastoreName": "My datastore",
  "executionTime": "36 seconds",
  "created": "2018-09-28T12:39:35Z",
  "updated": "2018-09-28T12:39:42Z",
  "state": "enqueued"
}

Para obtener más información, consulta Obtén la API de exportación de datos.

Si la exportación de estadísticas no muestra datos de estadísticas, executionTime se establece en "0 segundos".

Referencia de las propiedades de solicitud de Datastore

En la siguiente tabla, se describen las propiedades que puedes pasar en el cuerpo de la solicitud en formato JSON cuando se crea un almacén de datos según el tipo.

Para Google Cloud Storage:

Propiedad

Descripción

¿Es obligatorio?

ID del proyecto

ID del proyecto de Google Cloud Platform.

Para crear un proyecto de Google Cloud Platform, consulta Crea y administra proyectos en la documentación de Google Cloud Platform.

Sí

Nombre del bucket

Nombre del depósito en Cloud Storage al que deseas exportar los datos de estadísticas.

Nota: El depósito debe existir antes de realizar una exportación de datos.

Para crear un bucket de Cloud Storage, consulta Crea buckets en la documentación de Google Cloud Platform.

Sí

Ruta

Directorio en el que se almacenan los datos de estadísticas en el bucket de Cloud Storage.

Sí

Para BigQuery:

Propiedad	Descripción	¿Es obligatorio?
ID del proyecto	ID del proyecto de Google Cloud Platform. Para crear un proyecto de Google Cloud Platform, consulta Crea y administra proyectos en la documentación de Google Cloud Platform.	Sí
Nombre del conjunto de datos	Nombre del conjunto de datos de BigQuery al que deseas exportar datos de estadísticas. Asegúrate de que el conjunto de datos se cree antes de solicitar la exportación de datos. Para crear un conjunto de datos de BigQuery, consulta Crea y usa conjuntos de datos en la documentación de Google Cloud Platform.	Sí
Prefijo de la tabla	El prefijo para los nombres de las tablas creadas para los datos de estadísticas en el conjunto de datos de BigQuery.	Sí

Referencia de la propiedad de la solicitud de exportación

En la siguiente tabla, se describen las propiedades que puedes pasar en el cuerpo de la solicitud en formato JSON cuando se exportan datos de estadísticas.

Propiedad	Descripción	¿Es obligatorio?
`description`	Descripción de la solicitud de exportación	No
`name`	Nombre de la solicitud de exportación	Sí
`dateRange`	Especifica la fecha `start` y `end` de los datos que se exportarán, en el formato `yyyy-mm-dd`. Por ejemplo: "dateRange": { "start": "2018-07-29", "end": "2018-07-30" } El valor `dateRange` solo puede abarcar un día. El período comienza a las 00:00:00 UTC de la fecha de `start` y termina a las 00:00:00 UTC de la fecha de `end`. Nota: Para garantizar que todos los datos se recopilen del día anterior, es posible que debas retrasar la hora de inicio de la solicitud de exportación (por ejemplo, 00:05:00 AM UTC).	Sí
`outputFormat`	Especifica como `json` o `csv`.	Sí
`csvDelimiter`	El delimitador que se usa en el archivo de salida CSV, si `outputFormat` se configura como `csv`. El valor predeterminado es el carácter , (coma). Los caracteres delimitadores admitidos incluyen coma (,), barra vertical (\|) y tabulación (\t).	No
`datastoreName`	El nombre del almacén de datos que contiene la definición de tu almacén de datos.	Sí

Por ejemplo:

{
  "name": "Export raw results to Cloud Storage",
  "description": "Export raw results to Cloud Storage for last 24 hours",
  "datastoreName": "My Cloud Storage datastore"
}