Transferencias de propietario del contenido 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 propietario del contenido de YouTube.

Informes compatibles

En la actualidad, el Servicio de transferencia de datos de BigQuery para los informes de propietario del contenido de YouTube admite las siguientes opciones de informes:

Para obtener información sobre cómo los informes de propietario del contenido de YouTube se transforman en tablas y vistas de BigQuery, consulta Transformaciones de informes de propietario del contenido de YouTube.

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

Diario, alrededor de las 14:45 UTC

Puedes configurar la hora del día

Período de actualización

Último día

No configurable

Duración máxima del reabastecimiento

Últimos 180 días

YouTube retiene los datos durante un máximo de 180 días. Para obtener más información, consulta Datos históricos en la documentación de la API de informes de YouTube

Antes de comenzar

Antes de crear una transferencia de propietario del contenido de YouTube, haz lo siguiente:

  • Verifica que se completaron 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.
  • Verifica que tengas una cuenta de propietario del contenido de YouTube. Un propietario del contenido de YouTube no es lo mismo que un canal de YouTube. Por lo general, solo tienes una cuenta de propietario del contenido de YouTube si administras muchos canales diferentes.
  • Asegúrate de que la persona que crea la transferencia tenga los siguientes permisos obligatorios:
    • YouTube: administrador de contenido o propietario del contenido de YouTube. A un administrador de contenido se le otorgan derechos a fin de administrar contenido de YouTube para un propietario del contenido. Un propietario del contenido es una cuenta general que es propietaria de uno o más canales de YouTube y de los videos en esos canales.
    • BigQuery: permisos bigquery.transfers.update para crear la transferencia y permisos bigquery.datasets.update en el conjunto de datos de destino. 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 deseas 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 permitir que el Servicio de transferencia de datos de BigQuery administre tus datos de informes de YouTube para que la transferencia tenga éxito.
  • Por el momento, las notificaciones de ejecución de transferencias están en versión Alfa. Si tienes la intención de 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 necesarios 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.

Configura una transferencia de propietario del contenido de YouTube

La configuración de una transferencia de propietario del contenido de YouTube requiere lo siguiente:

  • ID de propietario del contenido: proporcionado por YouTube. Cuando accedes a YouTube como propietario del contenido o administrador de contenido, tu ID aparece en la URL después de o=. Por ejemplo, si la URL es https://youtube.com/dashboard?0=AbCDE_8FghIjK, el ID de propietario del contenido es AbCDE_8FghIjK. Para obtener más información sobre tu cuenta de administrador de contenido, consulta lo siguiente: Configura la cuenta de administrador de contenido.
  • 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 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.

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 configurar una transferencia de propietario del contenido de YouTube, haz lo siguiente:

IU web

  1. Dirígete a la IU web de BigQuery.

    Ir a la IU web de BigQuery

  2. Haz clic en Transferencias.

  3. Haz clic en Agregar transferencia.

  4. En la página New Transfer (Transferencia nueva), haz lo siguiente:

    • En Source (Fuente), selecciona YouTube Content Owner (Propietario del contenido de YouTube).
    • En Display Name (Nombre visible), 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 necesitas modificarla más adelante.
    • En Schedule (Programa), deja el valor predeterminado o haz clic en Edit (Editar) y cambia el horario.

      Programa personalizado de la transferencia de propietario del contenido

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

    • En Content owner ID (ID de propietario del contenido), ingresa tu ID de propietario del contenido.

    • 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 en la actualidad para tu cuenta, se crearán trabajos de informes nuevos a fin de habilitarlos.

      Programa predeterminado de la transferencia de propietario del contenido

    • (Opcional) Expande la sección Advanced (Avanzado) y configura las notificaciones de ejecución para tu transferencia. Por el momento, las notificaciones de ejecución de transferencias están en versión Alfa.

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

        Tema de Cloud Pub/Sub

  5. Haz clic en Add (Agregar).

  6. Cuando se te solicite, haz clic en Allow (Permitir) a fin de otorgarle al Servicio de transferencia de datos de BigQuery el permiso para ver tus datos de informes de YouTube, además de acceder a los datos en BigQuery y administrarlos. Debes permitir las ventanas emergentes de bigquery.cloud.google.com para ver la ventana de permisos.

    Permitir la transferencia

Línea de comandos

Ingresa el comando bq mk y suministra la marca de creación de transferencia --transfer_config. Las marcas siguientes también son obligatorias:

  • --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 tu ID del proyecto.
  • --target_dataset es el conjunto de datos de destino para la configuración de la transferencia.
  • --display_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 adelante.
  • --params contiene los parámetros para la configuración de la transferencia creada en formato JSON. Por ejemplo: --params='{"param":"param_value"}'. Para las transferencias de propietario del contenido de YouTube, debes suministrar los parámetros content_owner_id y table_suffix. De manera opcional, puedes configurar el parámetro configure_jobs como 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 en la actualidad para tu cuenta, se crearán trabajos de informes nuevos a fin de habilitarlos.
  • --data_source es la fuente de datos: youtube_content_owner.

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

Por ejemplo, el siguiente comando crea una transferencia de propietario del contenido de YouTube llamada My Transfer con el ID de propietario del contenido AbCDE_8FghIjK, 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='{"content_owner_id":"abCDE_8FghIjK","table_suffix":"MT","configure_jobs":"true"}' --data_source=youtube_content_owner

API

Usa el método projects.locations.transferConfigs.create y suministra 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 Tablas de partición.

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

Soluciona problemas de la configuración de la transferencia de propietario del contenido de YouTube

Si tienes problemas para configurar tu transferencia, consulta Problemas de transferencias de YouTube en Soluciona problemas de la configuración de la 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.