Transferencias de canal 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 para los informes de canal de YouTube.

Informes compatibles

Actualmente, el Servicio de transferencia de datos de BigQuery para los informes de canal de YouTube es compatible con las siguientes opciones de informes:

Para obtener información sobre cómo los informes de canal de YouTube se transforman en tablas y vistas de BigQuery, consulta Transformaciones de informes de canal 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 de reabastecimiento

Últimos 180 días

YouTube retiene datos por hasta 180 días. Para obtener más información, consulta los 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.
  • Asegúrate de que la persona que crea la transferencia tenga los siguientes permisos requeridos:
    • YouTube: Propietario de un canal de YouTube.
    • BigQuery: permisos bigquery.transfers.update para crear la transferencia y permisos bigquery.datasets.update en el conjunto de datos meta. La función de IAM bigquery.admin, predefinida a nivel de proyecto, incluye los permisos bigquery.transfers.update y bigquery.datasets.update. Para obtener más información sobre las funciones de IAM en BigQuery, consulta Control de acceso.
  • Si quieres crear transferencias mediante la IU web de BigQuery, habilita las ventanas emergentes de bigquery.cloud.google.com para que puedas ver la ventana de permisos. Debes otorgar los permisos necesarios al Servicio de transferencia de datos de BigQuery para que administre tus datos de informes de YouTube para que la transferencia sea exitosa.
  • Actualmente, las notificaciones de ejecución de transferencias se encuentran en versión Alpha. Si quieres configurar las notificaciones de ejecución de transferencias para Cloud Pub/Sub, debes tener los permisos pubsub.topics.setIamPolicy. Los permisos de Cloud Pub/Sub no son obligatorios si solo configuras las notificaciones por correo electrónico. Para obtener más información, consulta Notificaciones de ejecución del Servicio de transferencia de datos de BigQuery.

Cómo configurar una transferencia de canal de YouTube

Para configurar una transferencia de canal de YouTube se requiere:

  • Un ID de página del canal: Para recuperar el ID de página de la página de Google Plus asociada con el canal, haz lo siguiente:
    • Abre Google Plus.
    • En la parte superior derecha de la ventana, haz clic en el ícono de la cuenta y selecciona la cuenta asociada con tu canal de YouTube.
    • Recupera el ID de la página desde el extremo de la URL. Por ejemplo, si la URL es https://plus.google.com/b/123123123/, el ID de la página es 123123123.
  • Sufijo de tabla: Un nombre fácil de usar para el canal que proporciones cuando configures la transferencia. El sufijo se adjunta al ID del 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 actualmente utilizas la API de informes de YouTube y tienes trabajos de informes existentes, el Servicio de transferencia de datos de BigQuery carga los datos de informes. Si no tienes trabajos de informes existentes, al configurar la transferencia se habilitan de forma automática los trabajos de informes de YouTube.

Para crear una transferencia de canal de YouTube:

IU web

  1. Ve a la IU web de BigQuery.

    Ir a la IU web de BigQuery

  2. Haz clic en Transfers (Transferencias).

  3. Haz clic en Add Transfer (Agregar transferencia).

  4. En la página New Transfer (Transferencia nueva):

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

      Programa personalizado de transferencia de canal

    • En Destination dataset (Conjunto de datos de destino), selecciona el conjunto de datos que corresponda.

    • En Channel page ID (ID de la página del canal), ingresa el ID de la página de tu canal.

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

    • Marca Configure jobs (Configurar trabajos) para permitir que el servicio de transferencia 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 para habilitarlos.

      Transferencia de canal de YouTube

    • (Opcional) Expande la sección Advanced (Avanzado) y configura las notificaciones de ejecución para tus transferencias. Actualmente, las notificaciones de ejecución de transferencias se encuentran en versión Alpha.

      • En Cloud Pub/Sub topic (Tema de Cloud Sub/Pub), ingresa el nombre de tu tema, por ejemplo, projects/myproject/topics/mytopic.
      • Marca Send email notifications (Enviar notificaciones por correo electrónico) para permitir que se activen las notificaciones por correo electrónico de las ejecuciones de transferencia fallidas.
      • No marques Disabled (Inhabilitado) cuando configures una transferencia. Consulta Cómo trabajar con transferencias para inhabilitar transferencias existentes.

        Tema de Cloud Pub/Sub

  5. Haz clic en Add (Agregar).

  6. Cuando se te solicite, haz clic en Allow (Permitir) para otorgar al servicio de transferencias de BigQuery el permiso para administrar tus datos de informes de YouTube. Debes permitir las ventanas emergentes de bigquery.cloud.google.com para ver la ventana de permisos. Si tienes varias cuentas, es posible que también se te solicite seleccionar una cuenta.

    Permitir la transferencia

Línea de comandos

Ingresa el comando bq mk y proporciona la marca de creación de la transferencia: --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]
    

Donde:

  • --project_id es el ID de tu proyecto.
  • --target_dataset es el conjunto de datos meta para la configuración de transferencia.
  • --display_name es el nombre visible para la configuración de transferencia. El nombre de la transferencia puede ser cualquier valor que te permita identificar fácilmente la transferencia si necesitas modificarla más tarde.
  • --params contiene los parámetros para la configuración de transferencia creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}'. Para las transferencias de canal de YouTube, debes proporcionar los parámetros page_id y table_suffix. De manera opcional, puedes configurar el parámetro configure_jobs en true para permitir que el servicio de transferencia 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 para habilitarlos.
  • --data_source es la fuente de los 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, el siguiente comando crea una transferencia de canal de YouTube llamada My Transfer, mediante el ID de página 123123123, el sufijo de tabla MT y el conjunto de datos meta mydataset. La transferencia se crea en el proyecto predeterminado:

bq mk --transfer_config --target_dataset=mydataset --display_name='My Transfer' --params='{"page_id":"123123123","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.

Cómo consultar tus datos

Cuando tus datos se transfieren a BigQuery, los datos se escriben en tablas particionadas en 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 automáticamente, debes usar la pseudocolumna _PARTITIONTIME en tu consulta. Para obtener más información, consulta Cómo consultar tablas particionadas.

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

Si tienes problemas para configurar tu transferencia, consulta Problemas de transferencia de YouTube en Solución de problemas de la configuración de transferencia del Servicio de transferencia de datos de BigQuery.

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

¿Necesitas ayuda? Visita nuestra página de asistencia.