Transferencias de Google Play

El Servicio de transferencia de datos de BigQuery para Google Play te permite administrar y programar de manera automática trabajos de carga recurrentes para los datos de informe de Google Play.

Informes compatibles

Actualmente, el Servicio de transferencia de datos de BigQuery para Google Play es compatible con las siguientes opciones de informes mensuales:

Informes detallados

Informes agregados

Para obtener información sobre cómo los informes de Google Play se transforman en tablas de BigQuery, consulta la página sobre las transformaciones de informes de Google Play.

Opción de informe Compatibilidad
Versión de la API compatible

N/A

Programa

Diaria, en el momento en que se crea por primera vez la transferencia (predeterminado)

Puedes configurar la hora del día

Período de actualización

Últimos 7 días

No configurable

Duración máxima del reabastecimiento

Sin límite

Si bien Google Play no tiene límites conocidos de retención de datos, el Servicio de transferencia de datos de BigQuery tiene límites sobre cuántos días se pueden solicitar en un solo reabastecimiento. Para obtener más información sobre los reabastecimientos, consulta la sección sobre cómo configurar un reabastecimiento.

Antes de comenzar

Antes de crear una transferencia de Google Play, haz lo siguiente:

  • Verifica si completaste todas las acciones necesarias para habilitar el Servicio de transferencia de datos de BigQuery
  • Si creas la transferencia con la IU web clásica de BigQuery, debes permitir que aparezcan ventanas emergentes en tu navegador de bigquery.cloud.google.com para que puedas ver la ventana de permisos. Debes otorgar permiso al Servicio de transferencia de datos de BigQuery para que controle tu transferencia.
  • Crea un conjunto de datos de BigQuery para almacenar los datos de Google Play.
  • Encuentra tu depósito de Cloud Storage de este modo:
    • En Google Play Console, selecciona cualquier informe, como Revisiones. Encontrarás el ID de tu depósito de Cloud Storage cerca de la parte inferior de la página. El ID del depósito comienza con gs://. Por ejemplo, para el informe de revisiones, verás lo siguiente:
      gs://pubsite_prod_rev_01234567890987654321/reviews
      Para configurar tu transferencia, copia solo el ID único que se encuentra entre gs:// y /reviews:
      pubsite_prod_rev_01234567890987654321
  • Si quieres configurar las notificaciones de ejecución de transferencias para Pub/Sub, debes tener los permisos pubsub.topics.setIamPolicy. Los permisos de Pub/Sub no son necesarios si solo configuras las notificaciones por correo electrónico. Para obtener más información, consulta la sección sobre notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.

Permisos necesarios

  • BigQuery: Asegúrate de que la persona que crea la transferencia tenga los siguientes permisos en BigQuery:

    • Los permisos bigquery.transfers.update para crear la transferencia.

    La función bigquery.admin predefinida de Cloud IAM incluye los permisos bigquery.transfers.update. Para obtener más información sobre las funciones de Cloud IAM en el Servicio de transferencia de datos de BigQuery, consulta la referencia de control de acceso .

  • Google Play: Asegúrate de tener los siguientes permisos en Google Play:

    El equipo de Google Cloud NO tiene la capacidad de generar los archivos de Google Play o conceder acceso a ellos en tu nombre. Consulta Comunicarse con el equipo de atención de Google Play para obtener ayuda sobre cómo acceder a los archivos de Google Play.

Configura una transferencia de Google Play

Si deseas configurar una transferencia de Google Play necesitas lo siguiente:

  • Depósito de Cloud Storage. Los pasos para encontrar tu depósito de Cloud Storage se describen en la sección Antes de comenzar. Tu depósito de Cloud Storage comienza con pubsite_prod_rev. Por ejemplo: pubsite_prod_rev_01234567890987654321.
  • Sufijo de tabla: Un nombre fácil de usar para todas las fuentes de datos que se cargan en el mismo conjunto de datos. El sufijo se usa para evitar que transferencias diferentes escriban en las mismas tablas. El sufijo de la tabla debe ser único en todas las transferencias que cargan datos en el mismo conjunto de datos y debe ser corto para minimizar la longitud del nombre de la tabla resultante.

Para configurar una transferencia de Google Play, sigue estos pasos:

Console

  1. Ve a la IU web de BigQuery en Cloud Console.

    Ir a Cloud Console

  2. Haz clic en Transferencias.

  3. Haz clic en Crear transferencia.

  4. En la página Crear transferencia, sigue estos pasos:

    • En la sección Tipo de fuente (Source Type), en Fuente (Source), selecciona Google Play.

      Fuente de transferencia

    • En la sección Nombre de la configuración de transferencia (Transfer config name), en Nombre visible (Display name), ingresa el nombre de la transferencia, como My Transfer. El nombre de la transferencia puede ser cualquier valor que te permita identificarla con facilidad si es necesario hacerle modificaciones más tarde.

      Nombre de la transferencia

    • En la sección Opciones de programa (Schedule options), en Programa, deja el valor predeterminado, Comenzar ahora (Start now), o haz clic en Comenzar a una hora determinada (Start at a set time).

      • En Repeticiones (Repeats), selecciona una opción para la frecuencia con la que se ejecutará la transferencia.
        • Diaria (predeterminada)
        • Semanal
        • Mensual
        • Personalizada
        • A pedido
      • En Fecha de inicio y hora de ejecución (Start date and run time), ingresa la fecha y hora para iniciar la transferencia. Si seleccionas Comenzar ahora (Start now), esta opción se inhabilitará.

        Programa de la transferencia

    • En la sección Configuración de destino (Destination settings), en Conjunto de datos de destino (Destination dataset), selecciona el conjunto de datos que creaste para almacenar tus datos.

      Conjunto de datos de la transferencia

    • En la sección Detalles de fuente de datos (Data source details):

      • En Depósito de Cloud Storage (Cloud Storage bucket), ingresa el ID de tu depósito de Cloud Storage.
      • En Sufijo de tabla (Table suffix) ingresa un sufijo como “MT” (para “My Transfer”).

        Detalles de la fuente de Google Play

    • De forma opcional, en la sección Opciones de notificación (Notification options), haz lo siguiente:

      • Haz clic en el botón de activación para habilitar las notificaciones por correo electrónico. Cuando habilitas esta opción, el administrador de transferencias recibe una notificación por correo electrónico cuando falla una ejecución de transferencia.
      • En Seleccionar un tema de Cloud Pub/Sub (Select a Cloud Pub/Sub topic), elige el nombre de tu tema o haz clic en Crear un tema (Create a topic). Con esta opción, se configuran las notificaciones de ejecución de Pub/Sub para tu transferencia.
  5. Haz clic en Guardar (Save).

IU clásica

  1. Ve a la IU web de BigQuery.

    Ir a IU web de BigQuery

  2. Haz clic en Transferencias.

  3. Haz clic en Agregar transferencia.

  4. En la página New Transfer (Transferencia nueva), sigue estos pasos:

    • En Fuente (Source), selecciona Google Play.
    • En Nombre visible (Display name), ingresa un nombre para la transferencia, como “My Transfer”. El nombre de la transferencia puede ser cualquier valor que te permita identificarla con facilidad si es necesario hacerle modificaciones más tarde.
    • En Schedule (Programa), deja el valor predeterminado (cada 24 horas al momento de la creación de la transferencia) o haz clic en Edit y cambia la hora.

      Programa personalizado de transferencia de Google Play

    • En Conjunto de datos de destino, selecciona el conjunto de datos que corresponda.

    • En Cloud Storage bucket (Depósito de Cloud Storage), ingresa el nombre de tu depósito de Cloud Storage.

    • En Sufijo de tabla (Table suffix), ingresa un sufijo como “MT” (para “My Transfer”).

      Programa predeterminado de transferencia de Google Play

    • De forma opcional, expande la sección Avanzado (Advanced) y configura las notificaciones de ejecución para tu transferencia.

      • En el Tema Pub/Sub (Pub/Sub topic), ingresa tu nombre de tema, por ejemplo, “projects/myproject/topics/mytopic”.
      • Marca Enviar notificaciones por correo electrónico (Send email notifications) para activar las notificaciones por correo de las ejecuciones de transferencia con errores.
      • No debes marcar Inhabilitado (Disabled) cuando configuras una transferencia. Consulta la sección Trabaja con transferencias para inhabilitar las transferencias existentes.

        Tema de Pub/Sub

  5. Haz clic en Agregar (Add). Ten en cuenta que si haces clic en el botón Agregar otorgas acceso de escritura y lectura de informes de Google Play al conjunto seleccionado de datos de destino de BigQuery.

  6. Cuando se te solicite, haz clic en Permitir (Allow) a fin de otorgarle al Servicio de transferencia de datos de BigQuery el permiso para ver tus datos de informes de Google Play, y acceder y administrar los datos en BigQuery. Para ver la ventana de permisos, debes permitir las ventanas emergentes de bigquery.cloud.google.com.

    Permitir la transferencia

bq

Ingresa el comando bq mk y suministra la marca de creación de transferencias --transfer_config. También se requieren las siguientes marcas:

  • --target_dataset
  • --display_name
  • --params
  • --data_source
bq mk \
--transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source

Aquí:

  • project_id es el ID del proyecto. Si no se especifica --project_id, se usa el proyecto predeterminado.
  • dataset es el conjunto de datos de destino para la configuración de la transferencia.
  • name es el nombre visible de la configuración de transferencia. El nombre de la transferencia puede ser cualquier valor que te permita identificarla con facilidad si necesitas modificarla más tarde.
  • parameters contiene los parámetros para la configuración de la transferencia creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}' Para Google Play, debes proporcionar los parámetros bucket y table_suffix. bucket es el depósito de Cloud Storage que contiene tus archivos de informes de Play.
  • data_source es la fuente de datos: play.

Por ejemplo, el siguiente comando crea una transferencia de Google Play llamada My Transfer mediante el depósito de Cloud Storage pubsite_prod_rev_01234567890987654321 y el conjunto de datos de destino mydataset. La transferencia se crea en el proyecto predeterminado:

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"bucket":"pubsite_prod_rev_01234567890987654321","table_suffix":"MT"}' \
--data_source=play

La primera vez que ejecutes el comando, recibirás un mensaje como el siguiente:

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Sigue las instrucciones del mensaje y pega el código de autenticación en la línea de comandos.

API

Usa el método projects.locations.transferConfigs.create y suministra una instancia del recurso TransferConfig.

Solucionar problemas de configuración de transferencia de Google Play

Si tienes problemas para configurar tu transferencia, consulta la página sobre cómo solucionar problemas de configuración de la transferencia del Servicio de transferencia de datos de BigQuery.

Consulta tus datos

Cuando tus datos se transfieren a BigQuery, se escriben en tablas particionadas por tiempo de transferencia. Para obtener más información, consulta Introducción a las tablas particionadas.

Si consultas tus tablas directamente en lugar de usar las vistas generadas de manera automática, debes usar la seudocolumna _PARTITIONTIME en tu consulta. Para obtener más información, visita Consulta tablas particionadas.

Próximos pasos