Transferencias de canales de YouTube

El Servicio de transferencia de datos de BigQuery para YouTube te permite programar y administrar de forma automática los trabajos de carga recurrentes de los informes de canales de YouTube.

Informes compatibles

En la actualidad, el Servicio de transferencia de datos de BigQuery para los informes de canales de YouTube es compatible con las siguientes opciones de informes:

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

Opción de informe Compatibilidad
Versión de la API compatible 18 de junio de 2018
Programa

Diaria, aproximadamente a las 14:10 UTC

Puedes configurar la hora del día

Período de actualización

Último día

No configurable

Duración máxima del reabastecimiento

30 días

A partir de julio de 2018, los informes de YouTube que contienen datos históricos estarán disponibles durante 30 días desde el momento en que se generan. Los informes que contienen datos no históricos están disponibles durante 60 días. Para obtener más información, consulta la sección de datos históricos en la documentación de la API de informes de YouTube.

Antes de comenzar

Antes de crear una transferencia de canal de YouTube, haz lo siguiente:

  • Verifica si completaste todas las acciones necesarias para habilitar el Servicio de transferencia de datos de BigQuery.
  • Crea un conjunto de datos de BigQuery para almacenar los datos de YouTube.
  • Si deseas crear transferencias mediante la IU web clásica de BigQuery, permite las ventanas emergentes de bigquery.cloud.google.com para que puedas ver la ventana de permisos. Debes permitir que el Servicio de transferencia de datos de BigQuery administre tus datos de informes de YouTube para que la transferencia tenga éxito.
  • 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

Asegúrate de que la persona que crea la transferencia tenga los siguientes permisos requeridos:

  • BigQuery:

    • Los permisos bigquery.transfers.update para crear la transferencia
    • Los permisos bigquery.datasets.update en el conjunto de datos de destino

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

  • YouTube: Propietario de un canal de YouTube.

Configura una transferencia de canal de YouTube.

Para configurar una transferencia de canal de YouTube se requiere:

  • Sufijo de tabla: un nombre fácil de usar para el canal que proporcionaste cuando configuraste la transferencia. El sufijo se adjunta al ID de trabajo para crear el nombre de la tabla, por ejemplo reportTypeId_suffix. El sufijo se usa para evitar que las transferencias que se ejecutan por separado escriban en las mismas tablas. El sufijo de la tabla debe ser único en todas las transferencias que carguen datos en el mismo conjunto de datos, y el sufijo debe ser corto para minimizar la longitud del nombre de la tabla resultante.

Si usas la API de informes de YouTube en la actualidad y tienes trabajos de informes existentes, el Servicio de transferencia de datos de BigQuery carga tus datos de informes. Si no tienes trabajos de informes existentes, la configuración de la transferencia habilita de forma automática los trabajos de informes de YouTube.

Para crear una transferencia de canal de YouTube:

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:

    • En la sección Tipo de fuente (Source Type), en Fuente (Source), elige Canal de YouTube (YouTube Channel).

      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 necesitas modificarla 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 Sufijo de tabla (Table suffix), ingresa un sufijo como MT.
      • Marca la casilla Configurar trabajos (Configure jobs) para permitir que el Servicio de transferencia de datos de BigQuery administre los trabajos de informes de YouTube por ti. Si hay informes de YouTube que, por el momento, no existen para tu cuenta, se crearán trabajos de informes nuevos a fin de habilitarlos.

        Detalles de la fuente del canal de YouTube

    • De forma opcional, en la sección Opciones de notificación, 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 la ejecución de una transferencia.
      • En Seleccionar un tema de Pub/Sub (Select a 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. Haga clic en 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):

    • En Fuente (Source), selecciona Canal de YouTube (YouTube Channel).
    • En Nombre comercial (Display name), ingresa un nombre para la transferencia, como My Transfer.
    • En Programa (Schedule), deja el valor predeterminado o haz clic en Editar y cambia el horario.

      Programa personalizado de transferencia de canal

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

    • En Sufijo de tabla (Table suffix), ingresa un sufijo como MT.

    • Marca Configurar trabajos (Configure jobs) para permitir que el Servicio de transferencia de datos de BigQuery administre los trabajos de informes de YouTube por ti. Si hay informes de YouTube que no existen actualmente para tu canal, se crearán trabajos de informes nuevos a fin de habilitarlos.

      Transferencia de canal de YouTube

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

      • En Tema Pub/Sub (Pub/sub topic), ingresa el nombre de tu tema, por ejemplo, projects/myproject/topics/mytopic.
      • Marca Enviar notificaciones por correo electrónico (Send email notifications) para activar las notificaciones por correo electrónico 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. Haga clic en Add.

  6. Cuando se te solicite, haz clic en Permitir (Allow) para permitir que el Servicio de transferencia de datos de BigQuery administre tus datos de informes de YouTube. Para ver la ventana de permisos, debes permitir las ventanas emergentes de bigquery.cloud.google.com. Si tienes varias cuentas, es posible que también se te solicite seleccionar una cuenta.

    Permitir la transferencia

CLI

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

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

En el ejemplo anterior, se ilustra lo siguiente:

  • project_id es el ID del proyecto.
  • 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 transferencia creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}' Para las transferencias de canales de YouTube, debes proporcionar el parámetro table_suffix. De manera opcional, puedes configurar el parámetro configure_jobs como true para permitir que el Servicio de transferencia de datos de BigQuery administre los trabajos de informes de YouTube por ti. Si hay informes de YouTube que no existen actualmente para tu canal, se crearán trabajos de informes nuevos a fin de habilitarlos.
  • data_source es la fuente de datos: youtube_channel.

También puedes proporcionar la marca --project_id para especificar un proyecto en particular. Si no se especifica --project_id, se usa el proyecto predeterminado.

Por ejemplo, con el siguiente comando, se crea una transferencia de canales de YouTube llamada My Transfer con el sufijo de tabla MT 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='{"table_suffix":"MT","configure_jobs":"true"}' \
    --data_source=youtube_channel
    

API

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

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, lee la sección Consulta tablas particionadas.

Solución de problemas de la configuración de transferencia de canal de YouTube

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