Übertragungen für YouTube-Rechteinhaber

Mit dem BigQuery Data Transfer Service für YouTube können Sie wiederkehrende Ladejobs für YouTube-Rechteinhaberberichte planen und verwalten.

Unterstützte Berichte

Der BigQuery Data Transfer Service für YouTube-Rechteinhaberberichte unterstützt die folgenden Berichtsoptionen:

Informationen zur Umwandlung von YouTube-Rechteinhaberberichten in BigQuery-Tabellen und -Ansichten finden Sie unter Berichte zu YouTube-Rechteinhabern umwandeln.

Berichtsoption Unterstützung
Unterstützte API-Version 18. Juni 2018
Planen

Täglich etwa um 14:45 Uhr UTC

Sie können die Tageszeit konfigurieren.

Fenster aktualisieren

Letzter Tag

Nicht konfigurierbar

Maximale Backfill-Dauer

30 Tage

Ab Juli 2018 sind YouTube-Berichte, die Verlaufsdaten enthalten, ab dem Zeitpunkt ihrer Erstellung 30 Tage lang verfügbar. Berichte, die keine Verlaufsdaten enthalten, sind nach der Richtlinienänderung 60 Tage lang verfügbar. Weitere Informationen finden Sie in der Dokumentation zur YouTube Reporting API unter "Verlaufsdaten".

Vorbereitung

Diese Schritte sind vor dem Erstellen einer Übertragung für YouTube-Rechteinhaber erforderlich:

  • Prüfen Sie, ob Sie alle erforderlichen Aktionen ausgeführt haben, damit Sie den BigQuery Data Transfer Service aktivieren können.
  • Erstellen Sie ein BigQuery-Dataset zum Speichern der YouTube-Daten.
  • Prüfen Sie, ob Sie ein YouTube-Rechteinhaberkonto haben. Ein YouTube-Rechteinhaber ist nicht mit einem YouTube-Kanal identisch. Normalerweise haben Sie nur dann ein YouTube-Rechteinhaberkonto, wenn Sie mehrere Kanäle verwalten.
  • Wenn Sie Übertragungen mithilfe der klassischen BigQuery-Web-UI erstellen möchten, müssen Sie Pop-up-Fenster von bigquery.cloud.google.com zulassen, damit das Berechtigungsfenster angezeigt werden kann. Damit die Übertragung erfolgen kann, müssen Sie dem BigQuery Data Transfer Service die Berechtigung erteilen, Ihre YouTube-Berichtsdaten zu verwalten.
  • Wenn Sie Benachrichtigungen über die Übertragungsausführung für Pub/Sub einrichten möchten, benötigen Sie die Berechtigungen pubsub.topics.setIamPolicy. Pub/Sub-Berechtigungen sind nicht erforderlich, wenn Sie nur E-Mail-Benachrichtigungen einrichten. Weitere Informationen finden Sie unter Ausführungsbenachrichtigungen im BigQuery Data Transfer Service.

Erforderliche Berechtigung

Achten Sie darauf, dass die Person, die die Übertragung erstellt, die folgenden Berechtigungen hat:

  • BigQuery:

    • bigquery.transfers.update-Berechtigungen zum Erstellen der Übertragung
    • bigquery.datasets.update-Berechtigungen für das Ziel-Dataset

    Die vordefinierte IAM-Rolle bigquery.admin auf Projektebene umfasst die Berechtigungen bigquery.transfers.update und bigquery.datasets.update. Weitere Informationen zu Cloud IAM-Rollen im BigQuery Data Transfer Service finden Sie unter Referenz zur Zugriffssteuerung.

  • YouTube:

    • YouTube-Content-Manager oder YouTube-Rechteinhaber.

    Einem Content-Manager werden Rechte zum Verwalten von YouTube-Inhalten für einen Rechteinhaber gewährt. Ein Rechteinhaber ist ein übergeordnetes Konto, dem ein oder mehrere YouTube-Kanäle und die Videos in diesen Kanälen gehören.

    • Hide revenue data ist in den Berichtseinstellungen des YouTube-Rechteinhabers nicht markiert.

    Zur Übertragung von umsatzbezogenen Berichten sollte die Berechtigungseinstellung Hide revenue data für YouTube-Berichte für den Nutzer, der die Übertragung erstellt, deaktiviert sein.

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

YouTube-Rechteinhaber-Übertragung einrichten

Um die Übertragung für YouTube-Rechteinhaber einrichten zu können, benötigen Sie Folgendes:

  • Rechteinhaber-ID: Wird von YouTube bereitgestellt. Wenn Sie sich bei YouTube als Rechteinhaber oder Content-Manager anmelden, wird Ihre ID in der URL nach o= angezeigt. Wenn die URL beispielsweise https://youtube.com/dashboard?0=AbCDE_8FghIjK lautet, ist die ID des Rechteinhabers AbCDE_8FghIjK. Weitere Informationen zu Ihrem Content-Manager-Konto finden Sie unter: Content-Manager-Kontoeinstellungen konfigurieren.
  • Tabellensuffix: Ein benutzerfreundlicher Name für den Kanal, den Sie beim Einrichten der Übertragung angegeben haben. Das Suffix wird an die Job-ID angefügt, um den Tabellennamen zu bilden, beispielsweise reportTypeId_suffix. Mit dem Suffix wird verhindert, dass bei unterschiedlichen Übertragungen in dieselbe Tabelle geschrieben wird. Das Tabellensuffix darf bei allen Übertragungen, bei denen Daten in dasselbe Dataset geladen werden, nur einmal vorkommen. Außerdem muss das Suffix kurz sein, damit der Tabellenname nicht zu lang wird.

Wenn Sie aktuell die YouTube Reporting API verwenden und Berichterstellungsjobs vorhanden sind, werden die Berichtsdaten vom BigQuery Data Transfer Service geladen. Wenn keine Berichterstellungsjobs vorhanden sind, werden YouTube-Berichterstellungsjobs automatisch beim Einrichten der Übertragung aktiviert.

So richten Sie die Übertragung für einen YouTube-Rechteinhaber ein:

Console

  1. Öffnen Sie in der Cloud Console die BigQuery-Web-UI.

    Zur BigQuery-Web-UI

  2. Klicken Sie auf Transfers (Übertragungen).

  3. Klicken Sie auf Create Transfer (Übertragung erstellen).

  4. Auf der Seite Create Transfer (Übertragung erstellen) gehen Sie so vor:

    • Wählen Sie im Abschnitt Source type (Quelltyp) für Source (Quelle) die Option YouTube-Rechteinhaber aus.

      Übertragungsquelle

    • Geben Sie im Abschnitt Transfer config name (Konfigurationsname für Übertragung) für Display name (Anzeigename) einen Namen wie My Transfer für die Übertragung ein. Der Übertragungsname kann ein beliebiger Wert sein, mit dem Sie die Übertragung einfach identifizieren können, wenn Sie sie später ändern müssen.

      Name der Übertragung

    • Übernehmen Sie im Abschnitt Schedule options (Zeitplanoptionen) für Schedule (Zeitplan) den Standardwert (Start now) (Jetzt starten) oder klicken Sie auf Start at a set time (Zu einer festgelegten Zeit starten).

      • Wählen Sie für Repeats (Wiederholungen) eine Option aus, um festzulegen, wie oft die Übertragung ausgeführt werden soll.
      • Daily (Täglich) (Standardeinstellung)
      • Weekly (Wöchentlich)
      • Monthly (Monatlich)
      • Custom (Benutzerdefiniert)
      • On demand
    • Geben Sie für Start date and run time (Startdatum und Laufzeit) das Datum und die Uhrzeit für den Start der Übertragung ein. Wenn Sie Start now (Jetzt starten) auswählen, ist diese Option deaktiviert.

      Zeitplan für die Übertragung

  5. Wählen Sie im Abschnitt Destination settings (Zieleinstellungen) für Destination dataset (Ziel-Dataset) das Dataset aus, das Sie zum Speichern Ihrer Daten erstellt haben.

    Dataset übertragen

  6. Im Abschnitt Data source details (Details zur Datenquelle):

    • Geben Sie für Rechteinhaber-ID Ihre Rechteinhaber-ID ein.
    • Geben Sie für Table suffix (Tabellensuffix) ein Suffix ein, beispielsweise MT.

      Quellendetails für den YouTube-Rechteinhaber

  7. Optional: Im Abschnitt Notification options (Benachrichtigungsoptionen):

    • Klicken Sie auf die Umschaltfläche, um E-Mail-Benachrichtigungen zu aktivieren. Wenn Sie diese Option aktivieren, erhält der Übertragungsadministrator eine E-Mail-Benachrichtigung, wenn ein Übertragungsvorgang fehlschlägt.
    • Wählen Sie unter Select a Cloud Pub/Sub topic (Cloud Pub/Sub-Thema auswählen) Ihr Thema aus oder klicken Sie auf Create a topic (Thema erstellen). Mit dieser Option werden Pub/Sub-Ausführungsbenachrichtigungen für Ihre Übertragung konfiguriert.
  8. Klicken Sie auf Speichern.

Klassische UI

  1. Öffnen Sie die BigQuery-Web-UI.

    Zur BigQuery-Web-UI

  2. Klicken Sie auf Transfers (Übertragungen).

  3. Klicken Sie auf Übertragung hinzufügen.

  4. Gehen Sie auf der Seite Neue Übertragung so vor:

    • Wählen Sie für Quelle die Option YouTube-Rechteinhaber aus.
    • Geben Sie als Display name (Anzeigename) einen Namen wie My Transfer für die Übertragung ein. Der Anzeigename kann ein beliebiger Wert sein, mit dem Sie die Übertragung einfach identifizieren können, wenn Sie sie später ändern möchten.
    • Übernehmen Sie für Schedule (Zeitplan) den Standardwert oder klicken Sie auf Edit (Bearbeiten) und ändern Sie die Zeit.

      Benutzerdefinierter Zeitplan für Rechteinhaber

    • Wählen Sie für Destination dataset (Ziel-Dataset) das entsprechende Dataset aus.

    • Geben Sie für Rechteinhaber-ID Ihre Rechteinhaber-ID ein.

    • Geben Sie für Table suffix (Tabellensuffix) ein Suffix ein, beispielsweise MT.

    • Klicken Sie das Kästchen Configure jobs (Jobs konfigurieren) an, um BigQuery Transfer Service die Verwaltung von YouTube-Berichterstellungsjobs zu gestatten. Wenn YouTube-Berichte vorhanden sind, die zurzeit nicht für Ihr Konto zur Verfügung stehen, werden neue Berichterstellungsjobs erstellt, um sie zu aktivieren.

      Standardzeitplan für Rechteinhaber

    • Optional: Maximieren Sie den Abschnitt Advanced (Erweitert) und konfigurieren Sie die Run notifications (Ausführungsbenachrichtigungen) für die Übertragung.

      • Geben Sie unter Cloud Pub/Sub topic (Cloud Pub/Sub-Thema) den Namen für Ihr Thema ein, z. B. projects/myproject/topics/mytopic.
      • Aktivieren Sie Send email notifications (E-Mail-Benachrichtigungen senden), um bei Fehlern bei der Übertragungsausführung Benachrichtigungen zu senden.
      • Aktivieren Sie beim Einrichten einer Übertragung nicht Disabled (Deaktiviert). Unter Mit Übertragungen arbeiten erfahren Sie, wie Sie vorhandene Übertragungen deaktivieren.

        Pub/Sub-Thema

  5. Klicken Sie auf Hinzufügen.

  6. Klicken Sie bei entsprechender Aufforderung auf Allow (Zulassen), um dem BigQuery Data Transfer Service die Berechtigung zum Anzeigen Ihrer YouTube-Berichtsdaten sowie zum Zugriff auf und zur Verwaltung von Daten in BigQuery zu erteilen. Sie müssen Pop-ups von bigquery.cloud.google.com zulassen, damit das Berechtigungsfenster angezeigt wird.

    Übertragung zulassen

bq

Geben Sie den Befehl bq mk ein und geben Sie das Flag --transfer_config für die Übertragungserstellung an. Die folgenden Flags sind ebenfalls erforderlich:

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

Dabei gilt:

  • project_id ist die Projekt-ID.
  • dataset ist das Ziel-Dataset für die Übertragungskonfiguration.
  • name ist der Anzeigename für die Übertragungskonfiguration. Der Name der Übertragung kann ein beliebiger Wert sein, mit dem Sie die Übertragung einfach identifizieren können, wenn Sie sie später ändern müssen.
  • parameters enthält die Parameter für die erstellte Übertragungskonfiguration im JSON-Format. Beispiel: --params='{"param":"param_value"}'. Für Übertragungen von YouTube-Rechteinhabern müssen die Parameter content_owner_id und table_suffix angegeben werden. Optional können Sie den Parameter configure_jobs auf true setzen, damit der BigQuery Data Transfer Service YouTube-Berichterstellungsjobs für Sie verwalten kann. Wenn YouTube-Berichte vorhanden sind, die zurzeit nicht für Ihr Konto zur Verfügung stehen, werden neue Berichterstellungsjobs erstellt, um sie zu aktivieren.
  • data_source ist die Datenquelle: youtube_content_owner.

Sie können auch das Flag --project_id bereitstellen, um ein bestimmtes Projekt anzugeben. Wenn --project_id nicht angegeben ist, wird das Standardprojekt verwendet.

Der folgende Befehl erstellt beispielsweise eine Übertragung des YouTube-Rechteinhabers mit dem Namen My Transfer. Dabei werden die Rechteinhaber-ID AbCDE_8FghIjK, das Tabellensuffix MT und das Ziel-Dataset mydataset verwendet. Die Übertragung wird im Standardprojekt erstellt:

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

Verwenden Sie die Methode projects.locations.transferConfigs.create und geben Sie eine Instanz der Ressource TransferConfig an.

Daten abfragen

Bei der Übertragung Ihrer Daten in BigQuery werden die Daten in zeitpartitionierte Tabellen geschrieben. Weitere Informationen finden Sie unter Einführung in partitionierte Tabellen.

Wenn Sie die Tabellen direkt abfragen, anstatt die automatisch generierten Ansichten zu verwenden, müssen Sie in der Abfrage die Pseudospalte _PARTITIONTIME verwenden. Weitere Informationen finden Sie unter Partitionierte Tabellen abfragen.

Fehlerbehebung beim Einrichten von Übertragungen für YouTube-Rechteinhaber

Bei Problemen mit dem Einrichten von Übertragungen finden Sie weitere Informationen unter Fehler beim Einrichten von Übertragungen mit BigQuery Data Transfer Service beheben im Abschnitt Übertragungsprobleme mit YouTube.