YouTube コンテンツ所有者の転送

BigQuery Data Transfer Service for YouTube を使用すると、繰り返し実施する必要がある YouTube コンテンツ所有者レポートの読み込みジョブのスケジュールと管理を自動化できます。

サポートされるレポート

BigQuery Data Transfer Service for YouTube のコンテンツ所有者レポートでは現在、次のレポート オプションがサポートされています。

YouTube コンテンツ所有者レポートがどのように BigQuery のテーブルとビューに変換されるかについては、YouTube コンテンツ所有者レポートの変換をご覧ください。

レポート オプション サポート
サポート対象の API バージョン 2018 年 6 月 18 日
スケジュール

毎日、UTC 時間の 14 時 45 分頃

時刻を設定できます。

ウィンドウの更新

過去 1 日

構成不可

最大バックフィル期間

30 日

2018 年 7 月現在、履歴データを含む YouTube レポートは、生成後 30 日間利用できます(履歴データ以外のデータを含むレポートは、ポリシー変更後 60 日間利用できます)。詳細については、YouTube Reporting API ドキュメントの履歴データをご覧ください。

始める前に

YouTube コンテンツ所有者の転送を作成する前に、以下を行います。

  • BigQuery Data Transfer Service を有効にするために必要なすべての操作が完了していることを確認します。
  • YouTube データを格納する BigQuery データセットを作成します。
  • YouTube コンテンツ所有者アカウントを持っていることを確認します。YouTube コンテンツ所有者は、YouTube チャンネルと同じではありません。通常、さまざまなチャンネルを管理する場合は、YouTube コンテンツ所有者アカウントのみが必要です。
  • 従来の BigQuery ウェブ UI を使用して転送を作成する場合は、bigquery.cloud.google.com からのポップアップを許可して、権限ウィンドウが表示されるようにします。転送を成功させるには、YouTube のレポート作成データを管理するための BigQuery Data Transfer Service 権限を許可しておく必要があります。
  • 転送実行通知は、現時点ではアルファ版です。Cloud Pub/Sub に対する転送実行通知を設定する場合は、pubsub.topics.setIamPolicy 権限が必要です。メール通知の設定のみを行う場合は、Cloud Pub/Sub の権限は必要ありません。詳細については、BigQuery Data Transfer Service の実行通知をご覧ください。

必要な権限

転送を作成するユーザーに、次の必要な権限が付与されていることを確認します。

  • BigQuery:

    • 転送を作成するための bigquery.transfers.update 権限と、ターゲット データセットに対する bigquery.datasets.update 権限。

    事前定義されたプロジェクト レベルの IAM 役割である bigquery.admin には、bigquery.transfers.update 権限と bigquery.transfers.update 権限が含まれています。BigQuery での IAM 役割の詳細については、アクセス制御をご覧ください。

  • YouTube:

    • YouTube コンテンツ マネージャまたは YouTube コンテンツ所有者。

    コンテンツ マネージャには、コンテンツ所有者の YouTube コンテンツを管理する権限が付与されます。コンテンツ所有者とは、1 つ以上の YouTube チャンネルとそのチャンネルの動画を所有するアカウントのことです。

    • YouTube コンテンツ所有者レポートの設定で、[Hide revenue data] がオフになっている。

    収益に関連するレポートを転送するには、転送を作成するユーザーの YouTube レポートの権限設定で [Hide revenue data] をオフにする必要があります。

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

YouTube コンテンツ所有者の転送の設定

YouTube コンテンツ所有者の転送を設定するには、以下が必要です。

  • コンテンツ所有者 ID: YouTube から提供されます。YouTube にコンテンツ所有者またはコンテンツ マネージャとしてログインすると、URL の o= の後に ID が表示されます。たとえば、URL が https://youtube.com/dashboard?0=AbCDE_8FghIjK である場合、コンテンツ所有者 ID は AbCDE_8FghIjK です。コンテンツ マネージャ アカウントの詳細については、コンテンツ マネージャのアカウント設定をご覧ください。
  • テーブル サフィックス: 転送を設定するときにユーザーが指定するわかりやすいチャンネル名です。テーブル名は、このサフィックスをジョブ ID に追加して作成されます(例: [reportTypeId]_[suffix])。別の転送で同じテーブルに書き込まれないようにするために、このサフィックスが使用されます。テーブル サフィックスは、同じデータセットにデータを読み込むすべての転送で一意である必要があり、生成されるテーブル名の長さが短くなるように、サフィックスは短くする必要があります。

現在 YouTube Reporting API を使用していて、既存のレポート作成ジョブがある場合は、BigQuery Data Transfer Service によってユーザーのレポートデータが読み込まれます。既存のレポート作成ジョブがない場合は、転送を設定すると、YouTube レポート作成ジョブが自動的に有効になります。

YouTube コンテンツ所有者の転送を設定するには:

Console

  1. BigQuery ウェブ UI に移動します。

    BigQuery ウェブ UI に移動

  2. [転送] をクリックします。

  3. [+ 作成] をクリックします。

  4. [転送の作成] ページで、次の操作を行います。

    • [ソースタイプ] セクションの [ソース] で、YouTube コンテンツ管理者を選択します。

      転送のソース

    • [転送構成名] セクションの [表示名] に、転送名(My Transfer など)を入力します。転送名には、後で修正が必要になった場合に簡単に識別できる任意の名前を使用できます。

      転送名

    • [スケジュール オプション] セクションで、[スケジュール] をデフォルト値([すぐに開始可能])のままにするか、[設定した時間に開始] をクリックします。

      • [繰り返しの頻度] で、転送を実行する頻度のオプションを選択します。
        • 毎日(デフォルト)
        • 毎週
        • 毎月
        • カスタム
        • オンデマンド
      • [開始日と実行時間] に、転送を開始する日付と時刻を入力します。[すぐに開始可能] を選択した場合、このオプションは無効になります。

        転送スケジュール

    • [転送先の設定] セクションの [宛先データセット] で、データを保存するために作成したデータセットを選択します。

      転送データセット

    • [データソースの詳細] セクションで、次の操作を行います。

      • [コンテンツ所有者 ID] に、コンテンツ所有者 ID を入力します。
      • [テーブル サフィックス] にサフィックス(MT など)を入力します。

        YouTube コンテンツ所有者のソースの詳細

    • (省略可)[通知オプション] セクションで、次の操作を行います。

      • 切り替えボタンをクリックしてメール通知を有効にします。このオプションを有効にすると、転送の実行が失敗した場合、転送管理者にメール通知が送信されます。
      • [Cloud Pub/Sub トピックを選択してください] で、トピック名を選択するか、[トピックを作成] をクリックします。このオプションで、Cloud Pub/Sub の転送実行通知を構成します。転送実行通知は、現時点ではアルファ版です。
  5. [保存] をクリックします。

従来の UI

  1. BigQuery ウェブ UI に移動します。

    BigQuery ウェブ UI に移動

  2. [Transfers] をクリックします。

  3. [Add Transfer] をクリックします。

  4. [New Transfer] ページで次の操作を行います。

    • [Source] で [YouTube Content Owner] を選択します。
    • [Display Name] に転送名(My Transfer など)を入力します。転送名には、後で修正が必要になった場合に簡単に識別できる任意の名前を使用できます。
    • [Schedule] はデフォルト値のままにするか、[Edit] をクリックして時刻を変更します。

      コンテンツ所有者の転送のカスタム スケジュール

    • [Destination dataset] で、該当するデータセットを選択します。

    • [Content owner ID] に、コンテンツ所有者 ID を入力します。

    • [Table suffix] にサフィックス(MT など)を入力します。

    • BigQuery Data Transfer Service で YouTube レポート作成ジョブを管理できるようにするには、[Configure jobs] をオンにします。アカウントに現在存在しない YouTube レポートがある場合は、新しいレポート作成ジョブが作成されてそのレポートが有効になります。

      コンテンツ所有者の転送のデフォルト スケジュール

    • (省略可)[Advanced] セクションを展開し、転送用の実行通知を構成します。転送実行通知は、現時点ではアルファ版です。

      • [Cloud Pub/Sub topic] にトピック名(projects/myproject/topics/mytopic など)を入力します。
      • [Send email notifications] をオンにして、転送実行失敗のメール通知を許可します。
      • 転送を設定するときは [Disabled] をオンにしないでください。既存の転送を無効にするには転送の操作をご覧ください。

        Cloud Pub/Sub トピック

  5. [Add] をクリックします。

  6. プロンプトが表示されたら、[Allow] をクリックし、YouTube レポート作成データの表示権限、BigQuery でのデータのアクセス権限と管理権限を BigQuery Data Transfer Service に付与します。権限ウィンドウが表示されるように、bigquery.cloud.google.com からのポップアップを許可する必要があります。

    転送の許可

コマンドライン

bq mk コマンドを入力して、転送作成フラグ --transfer_config を指定します。次のフラグも必要です。

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

ここで

  • --project_id はプロジェクト ID です。
  • --target_dataset は転送構成のターゲット データセットです。
  • --display_name は転送構成の表示名です。転送名には、後で修正が必要になった場合に簡単に識別できる任意の名前を使用できます。
  • --params には、作成される転送構成のパラメータを JSON 形式で指定します(例: --params='{"param":"param_value"}')。YouTube コンテンツ所有者の転送では、content_owner_id パラメータと table_suffix パラメータを指定する必要があります。オプションで、configure_jobs パラメータを true に設定して、BigQuery Transfer Service で YouTube のレポート作成ジョブを管理できるようにすることができます。アカウントに現在存在しない YouTube レポートがある場合は、新しいレポート作成ジョブが作成されてそのレポートが有効になります。
  • --data_source はデータソース(youtube_content_owner)です。

また、--project_id フラグを指定して、特定のプロジェクトを指定することもできます。--project_id が指定されていない場合は、デフォルトのプロジェクトが使用されます。

たとえば、次のコマンドは、コンテンツ所有者 ID AbCDE_8FghIjK、テーブル サフィックス MT、およびターゲット データセット mydataset を使用して、My Transfer という YouTube コンテンツ所有者の転送を作成します。この転送はデフォルトのプロジェクトで作成されます。

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

projects.locations.transferConfigs.create メソッドを使用して、TransferConfig リソースのインスタンスを作成します。

データのクエリ

データが BigQuery に転送されると、データは取り込み時間分割テーブルに書き込まれます。詳細については、分割テーブルをご覧ください。

自動生成されたビューを使用せずに、テーブルでクエリを直接実行する場合は、そのクエリで _PARTITIONTIME 疑似列を使用する必要があります。詳細については、分割テーブルのクエリをご覧ください。

YouTube コンテンツ所有者の転送設定のトラブルシューティング

転送を設定する際に問題が発生した場合は、BigQuery Data Transfer Service 転送設定のトラブルシューティングにある YouTube の転送に関する問題をご覧ください。

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。