Transferts de propriétaires de contenu YouTube

Le service de transfert de données BigQuery pour YouTube permet de planifier et de gérer automatiquement les tâches de chargement récurrentes pour les rapports de propriétaire de contenu YouTube.

Rapports acceptés

Le service de transfert de données BigQuery pour les rapports de propriétaire de contenu YouTube est actuellement compatible avec les options de création de rapports suivantes :

Pour plus d'informations sur la transformation des rapports de propriétaire de contenu YouTube en tables et vues BigQuery, consultez la section Transformations des rapports de propriétaire de contenu YouTube.

Option de création de rapports Compatibilité
Version d'API compatible 18 juin 2018
Programmation

Tous les jours, vers 14h45 UTC

Vous pouvez configurer l'heure

Fenêtre d'actualisation

La veille

Non configurable

Durée maximale du remplissage

30 jours

Depuis juillet 2018, les rapports YouTube contenant des données de l'historique sont disponibles pendant 30 jours à compter de leur génération. Les rapports contenant des données non historiques sont disponibles pendant 60 jours après le changement des règles. Pour plus d'informations, consultez la section Données de l'historique dans la documentation de l'API de création de rapports YouTube.

Avant de commencer

Avant de créer un transfert de propriétaire de contenu YouTube :

  • Vérifiez que vous avez effectué toutes les actions requises pour activer le service de transfert de données BigQuery.
  • Créez un ensemble de données BigQuery pour stocker les données YouTube.
  • Vérifiez que vous possédez un compte de propriétaire de contenu YouTube. Un propriétaire de contenu YouTube n'est pas la même chose qu'une chaîne YouTube. En règle générale, vous ne disposez d'un compte propriétaire de contenu YouTube que si vous gérez un grand nombre de chaînes différentes.
  • Si vous envisagez de créer des transferts à l'aide de l'UI Web classique de BigQuery, autorisez les pop-ups de bigquery.cloud.google.com pour pouvoir afficher la fenêtre des autorisations. Pour que le transfert aboutisse, vous devez autoriser le service de transfert de données BigQuery à gérer vos données de rapport YouTube.
  • Si vous avez l'intention de configurer des notifications d'exécution de transfert pour Pub/Sub, vous devez disposer des autorisations pubsub.topics.setIamPolicy. Les autorisations Pub/Sub ne sont pas nécessaires si vous ne configurez que des notifications par e-mail. Pour plus d'informations, consultez la page Notifications d'exécution du service de transfert de données BigQuery.

Autorisations requises

Assurez-vous que la personne qui crée le transfert dispose des autorisations requises suivantes :

  • BigQuery :

    • Autorisations bigquery.transfers.update pour créer le transfert
    • Autorisations bigquery.datasets.update sur l'ensemble de données cible

    Le rôle Cloud IAM prédéfini bigquery.admin au niveau du projet inclut les autorisations bigquery.transfers.update et bigquery.datasets.update. Pour en savoir plus sur les rôles Cloud IAM dans le cadre du service de transfert de données BigQuery, consultez la documentation de référence sur le Contrôle des accès.

  • YouTube :

    • Gestionnaire de contenu YouTube ou propriétaire du contenu YouTube.

    Un gestionnaire de contenu a le droit d'administrer du contenu YouTube pour un propriétaire de contenu. Un propriétaire de contenu est un compte central possédant au moins une chaîne YouTube, ainsi que les vidéos qui y sont associées.

    • Hide revenue data est désélectionné dans les paramètres du rapport pour les propriétaires de contenu YouTube.

    Pour autoriser le transfert des rapports liés aux revenus, le paramètre d'autorisation des rapports YouTube Hide revenue data doit être décoché pour l'utilisateur qui crée le transfert.

    youtube-content-owner-reports-uncheck-hide-revenue

Configurer un transfert de propriétaire de contenu YouTube

Configurer un transfert de propriétaire de contenu YouTube implique les éléments suivants :

  • ID du propriétaire du contenu : fourni par YouTube. Lorsque vous vous connectez à YouTube en tant que propriétaire ou gestionnaire de contenu, votre identifiant apparaît dans l'URL après o=. Par exemple, si l'URL est https://youtube.com/dashboard?0=AbCDE_8FghIjK, l'ID du propriétaire de contenu est AbCDE_8FghIjK. Pour en savoir plus sur votre compte de gestionnaire de contenu, consultez la section Configurer les paramètres du compte de gestionnaire de contenu.
  • Suffixe de table : nom convivial de la chaîne que vous avez fourni lors de la configuration du transfert. Le suffixe est ajouté à l'ID de tâche pour créer le nom de la table, par exemple reportTypeId_suffix. Il empêche que des transferts séparés écrivent sur des tableaux identiques. Le suffixe de table doit être unique pour tous les transferts qui chargent des données dans le même ensemble de données. Il doit par ailleurs être court de façon à réduire la longueur du nom de table obtenu.

Si vous utilisez actuellement l'API de création de rapports YouTube et disposez de tâches de création de rapports, le service de transfert de données BigQuery charge les données de vos rapports. Si vous n'avez pas de tâches de création de rapports existantes, la configuration du transfert active automatiquement les tâches de création de rapports YouTube.

Pour configurer un transfert de propriétaire de contenu YouTube :

Console

  1. Accédez à l'UI Web de BigQuery dans Cloud Console.

    Accéder à Cloud Console

  2. Cliquez sur Transferts.

  3. Cliquez sur Créer un transfert.

  4. Sur la page Créer un transfert :

    • Dans la section Type de source, choisissez Propriétaire de contenu YouTube comme Source.

      Source de transfert

    • Dans la section Nom de la configuration de transfert, sous Nom à afficher, saisissez un nom pour le transfert, tel que My Transfer. Ce nom peut correspondre à n'importe quelle valeur permettant d'identifier facilement le transfert si vous devez le modifier ultérieurement.

      Nom du transfert

    • Dans la section Options de programmation, pour le champ Programmation personnalisée, laissez la valeur par défaut Commencer, ou cliquez sur Démarrer à l'heure définie.

      • Pour le champ Périodicité, choisissez une option pour la fréquence d'exécution du transfert.
        • Daily (Tous les jours) (par défaut)
        • Weekly (Toutes les semaines)
        • Monthly (Tous les mois)
        • Custom (Personnalisé)
        • À la demande
      • Pour le champ Date de début et heure d'exécution, saisissez la date et l'heure de début du transfert. Cette option est désactivée si vous choisissez Start now (Commencer).

        Planning de transfert

    • Dans la section Paramètres de destination, pour le champ Ensemble de données de destination, choisissez l'ensemble de données que vous avez créé pour stocker vos données.

      Transférer un jeu de données

    • Dans la section Data source details (Détails de la source de données) :

      • Pour ID de propriétaire de contenu, saisissez votre ID de propriétaire de contenu.
      • Pour Table suffix (Suffixe de table), saisissez un suffixe tel que MT.

        Informations sur le propriétaire de contenu YouTube source

    • (Facultatif) Dans la section Notification options (Options de notification) :

      • Cliquez sur le bouton pour activer les notifications par e-mail. Lorsque vous activez cette option, l'administrateur de transfert reçoit une notification par e-mail en cas d'échec de l'exécution du transfert.
      • Pour le champ Sélectionner un sujet Pub/Sub, choisissez le nom de votre sujet ou cliquez sur Créer un sujet. Cette option configure les notifications d'exécution Pub/Sub pour votre transfert.
  5. Cliquez sur Save.

Interface utilisateur classique

  1. Accédez à l'UI Web de BigQuery.

    Accéder à l'UI Web de BigQuery

  2. Cliquez sur Transfers (Transferts).

  3. Cliquez sur Add Transfer (Ajouter un transfert).

  4. Sur la page New Transfer (Nouveau transfert) :

    • Pour Source, sélectionnez YouTube Content Owner (Propriétaire de contenu YouTube).
    • Pour le champ Display name (Nom à afficher), saisissez le nom du transfert, par exemple My Transfer. Ce nom peut correspondre à n'importe quelle valeur permettant d'identifier facilement le transfert si vous devez le modifier ultérieurement.
    • Pour Programmation, conservez la valeur par défaut ou cliquez sur Modifier pour changer l'heure.

      Programmation personnalisée du transfert de propriétaire du contenu

    • Pour Destination dataset (Ensemble de données de destination), sélectionnez l'ensemble de données approprié.

    • Pour ID de propriétaire de contenu, saisissez votre ID de propriétaire de contenu.

    • Pour Table suffix (Suffixe de table), saisissez un suffixe tel que MT.

    • Cochez la case Configurer les tâches pour autoriser le service de transfert de données BigQuery à gérer les tâches de création de rapports YouTube à votre place. S'il n'existe actuellement pas de rapports YouTube pour votre compte, des tâches de création de rapports sont créées pour les activer.

      Programmation par défaut du transfert de propriétaire de contenu

    • (Facultatif) Développez la section Avancé, puis configurez les notifications d'exécution pour votre transfert.

      • Pour le champ Sujet Pub/Sub, saisissez le nom de votre sujet, par exemple, projects/myproject/topics/mytopic.
      • Cochez la case Envoyer des notifications par e-mail pour autoriser les notifications par e-mail en cas d'échec de l'exécution des transferts.
      • Ne cochez pas la case Disabled (Désactivé) lorsque vous configurez un transfert. Pour désactiver les transferts existants, consultez la page Utiliser les transferts.

        Sujet Pub/Sub

  5. Cliquez sur Ajouter.

  6. Lorsque vous y êtes invité, cliquez sur Autoriser pour autoriser le service de transfert de données BigQuery à afficher vos données de rapports YouTube, à accéder aux données dans BigQuery et à les gérer. Vous devez autoriser les fenêtres pop-up de bigquery.cloud.google.com pour afficher la fenêtre des autorisations.

    Autoriser le transfert

CLI

Saisissez la commande bq mk, puis spécifiez l'option de création de transfert --transfer_config. Les paramètres suivants sont également requis :

  • --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
    

Où :

  • project_id est l'ID du projet.
  • dataset est l'ensemble de données cible de la configuration de transfert.
  • name est le nom à afficher pour la configuration de transfert. Ce nom peut correspondre à n'importe quelle valeur permettant d'identifier facilement le transfert si vous devez le modifier ultérieurement.
  • parameters contient les paramètres de la configuration de transfert créée au format JSON. Par exemple : --params='{"param":"param_value"}'. Pour les transferts de propriétaire de contenu YouTube, vous devez fournir les paramètres content_owner_id et table_suffix. Vous pouvez éventuellement définir le paramètre configure_jobs sur true pour autoriser le service de transfert BigQuery à gérer les tâches de rapport YouTube à votre place. S'il n'existe actuellement pas de rapports YouTube pour votre compte, des tâches de création de rapports sont créées pour les activer.
  • data_source représente la source de données : youtube_content_owner.

Vous pouvez également indiquer l'option --project_id pour spécifier un projet particulier. Si --project_id n'est pas spécifié, le projet par défaut est utilisé.

Par exemple, la commande suivante crée un transfert de propriétaire de contenu YouTube nommé My Transfer avec l'ID de propriétaire de contenu AbCDE_8FghIjK, le suffixe de table MT et l'ensemble de données cible mydataset. Le transfert est créé dans le projet par défaut :

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

Utilisez la méthode projects.locations.transferConfigs.create et fournissez une instance de la ressource TransferConfig.

Interroger les données

Lorsque les données sont transférées vers BigQuery, elles sont écrites dans des tables partitionnées par date d'ingestion. Pour en savoir plus, consultez la page Tables partitionnées.

Si vous interrogez directement les tables au lieu d'utiliser les vues générées automatiquement, vous devez utiliser la pseudo-colonne _PARTITIONTIME dans votre requête. Pour en savoir plus, consultez la page Interroger des tables partitionnées.

Résoudre les problèmes de configuration des transferts de propriétaire de contenu YouTube

Si vous rencontrez des problèmes lors de la configuration de votre transfert, consultez la section Problèmes de transfert sur YouTube de la page sur la résolution des problèmes de configuration des transferts avec le service de transfert de données BigQuery.