YouTube 內容擁有者移轉作業

YouTube 專用的 BigQuery 資料移轉服務可讓您為 YouTube 內容擁有者報告自動排程及管理週期性載入工作。

支援的報表

YouTube 內容擁有者報告專用的 BigQuery 資料移轉服務目前支援以下報告選項:

如要瞭解 YouTube 內容擁有者報表如何轉換成 BigQuery 表格和視圖,請參閱 YouTube 內容擁有者報告轉換

報表選項 支援
支援的 API 版本 2018 年 6 月 18 日
排程

UTC 時間每天 14:45 左右

您可以設定當天的時間

更新期

過去 1 天

無法設定

補充作業時間長度上限

30 天

自 2018 年 7 月起,包含歷來資料的 YouTube 報表在產生後可保留 30 天 (政策變更後,不含歷來資料的報表可保留 60 天)。詳情請參閱 YouTube Reporting API 說明文件中的歷來資料

事前準備

建立 YouTube 內容擁有者移轉之前:

  • 確認您已完成啟用 BigQuery 資料移轉服務的一切必要動作。
  • 建立 BigQuery 資料集來儲存 YouTube 資料。
  • 確認您擁有 YouTube 內容擁有者帳戶。YouTube 內容擁有者與 YouTube 頻道並不相同。一般來說,只有在必須管理多個不同的頻道時,您才需要擁有 YouTube 內容擁有者帳戶。
  • 如果您想要使用傳統 BigQuery 網頁版 UI 建立移轉作業,請允許來自 bigquery.cloud.google.com 的彈出式視窗,以便查看權限視窗。為使移轉作業順利進行,您必須向 BigQuery 資料移轉服務授權管理您的 YouTube 報表資料。
  • 移轉執行通知目前仍在 Alpha 測試階段。如果您想要為 Cloud Pub/Sub 設定移轉執行通知,您必須具有 pubsub.topics.setIamPolicy 權限。如果您只是要設定電子郵件通知,就不需要 Cloud Pub/Sub 權限。詳情請參閱 BigQuery 資料移轉服務執行通知

所需權限

確認建立移轉作業的人員具有以下必要權限:

  • BigQuery

    • 建立移轉作業的 bigquery.transfers.update 權限,以及目標資料集的 bigquery.datasets.update 權限。

    bigquery.admin 預先定義的專案層級身分與存取權管理角色包括 bigquery.transfers.updatebigquery.transfers.update 權限。如要進一步瞭解 BigQuery 中的身分與存取權管理角色,請參閱存取權控管一文。

  • YouTube

    • YouTube 內容管理員或 YouTube 內容擁有者。

    內容管理員具有為內容擁有者管理 YouTube 內容的權限。內容擁有者是一種綜合帳戶,這個帳戶擁有一或多個 YouTube 頻道,以及這些頻道中的影片。

    • YouTube 內容擁有者報表設定中的 Hide revenue data 已取消勾選。

    如要移轉收益相關報表,您必須為建立移轉作業的使用者取消勾選 YouTube 報表權限設定中的 Hide revenue data

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

設定 YouTube 內容擁有者移轉作業

設定 YouTube 內容擁有者移轉必須具備:

  • 內容擁有者 ID:由 YouTube 提供。當您以內容擁有者或管理員身分登入 YouTube 時,您的 ID 會顯示在 URL 的 o= 後方。舉例來說,如果網址是 https://youtube.com/dashboard?0=AbCDE_8FghIjK,則內容擁有者 ID 為 AbCDE_8FghIjK。如要進一步瞭解內容管理員帳戶,請參閱修改內容管理員帳戶設定
  • 資料表後置字串:您在設定移轉作業時為頻道提供的易記名稱。後置字串會附加在工作 ID 後方,形成資料表名稱,例如 [reportTypeId]_[suffix]。後置字串可用於防止不同的移轉作業寫入同一個資料表。所有將資料載入同個資料集的移轉工作,其資料表後置字串都不能重複,並且後置字串應盡量簡短,避免產生過於冗長的資料表名稱。

如果您正在使用 YouTube Reporting API,並且已經有一些報表工作,BigQuery 資料移轉服務會載入您的報表資料。如果您目前沒有報表工作,設定完移轉作業後,系統就會自動啟用 YouTube 報表工作。

如要設定 YouTube 內容擁有者移轉作業:

主控台

  1. 前往 BigQuery 網頁版 UI。

    前往 BigQuery 網頁版 UI

  2. 按一下 [Transfers] (移轉作業)

  3. 按一下 [+ Create] (+ 建立)。

  4. 在「Create Transfer」(建立轉移作業) 頁面:

    • 在「Source type」(來源類型) 區段中,針對「Source」(來源),選擇 [YouTube Content Owner] (YouTube 內容擁有者)

      移轉作業來源

    • 在「Transfer config name」(移轉設定名稱) 區段,針對「Display name」(顯示名稱),輸入移轉作業的名稱,例如 My Transfer。移轉作業名稱可以是任何容易辨識的值,方便您日後在必要時進行修改。

      資料轉移設定名稱

    • 在「Schedule options」(排程選項) 區段或「Schedule」(排程) 中,保留預設值 ([Start now] (立即開始)),或按一下 [Start at a set time] (於設定的時間開始)

      • 在「Repeats」(重複時間間隔) 部分,選擇多久執行一次移轉作業的選項。
        • Daily (每天) (預設)
        • Weekly (每週)
        • Monthly (每月)
        • Custom (自訂)
        • On-demand (隨選)
      • 在「Start date and run time」(開始日期和執行時間) 部分,輸入開始移轉的日期與時間。如果您選擇 [Start now] (立即開始),就會停用此選項。

        轉移作業時間表

    • 在 [Destination dataset] (目的地資料集) 區段,針對「Destination dataset」(目的地資料集),選擇您建立來儲存資料的資料集。

      移轉資料集

    • 在「Data source details」(資料來源詳細資料) 區段:

      • 於「Content Owner ID」(內容擁有者 ID) 部分輸入您的內容擁有者 ID。
      • 在「Table Suffix」(資料表後置字串) 部分輸入後置字串,例如 MT

        YouTube 內容擁有者來源詳細資料

    • (選用) 在「Notification options」(通知選項) 區段中:

      • 按一下啟用電子郵件通知的切換開關。當您啟用此選項時,移轉管理員會在移轉作業失敗時收到電子郵件通知。
      • 在「Select a Cloud Pub/Sub topic」(選取 Cloud Pub/Sub 主題) 部分,選擇您的主題名稱或按一下 [Create a topic] (建立主題)。此選項可為移轉作業設定 Cloud Pub/Sub 執行通知。移轉執行通知目前仍為 Alpha 測試版。
  5. 按一下 [Save] (儲存)

傳統版 UI

  1. 前往 BigQuery 網頁版 UI。

    前往 BigQuery 網頁版 UI

  2. 按一下 [Transfers] (移轉作業)

  3. 按一下 [Add Transfer] (新增移轉作業)。

  4. 在「新增移轉」頁面上:

    • 於「Source」(來源) 部分選擇「YouTube Content Owner」(YouTube 內容擁有者)
    • 在「Display name」(顯示名稱) 部分,輸入移轉作業的名稱,例如 My Transfer。移轉名稱可以是任何容易識別的值,方便您後續修改。
    • 保留「Schedule」(排程)預設值,或按一下 [Edit] (編輯) 並變更時間。

      內容擁有者移轉自訂時間表

    • 在「Destination dataset」(目的地資料集) 部分選擇適當的資料集。

    • 於「Content Owner ID」(內容擁有者 ID) 部分輸入您的內容擁有者 ID。

    • 在「Table Suffix」(資料表後置字串) 部分輸入後置字串,例如 MT

    • 勾選 [Configure Jobs],讓 BigQuery 資料移轉服務為您管理 YouTube 報表工作。如果 YouTube 報表目前並不存在於您的帳戶中,則系統會建立新的報表工作來啟用這些報表。

      內容擁有者移轉預設時間表

    • (選用) 展開「Advanced」(進階) 區段,然後設定移轉作業的執行通知。移轉執行通知目前仍為 Alpha 版。

      • 在「Cloud Pub/Sub topic」(Cloud Pub/Sub 主題) 部分輸入您的主題名稱,例如 projects/myproject/topics/mytopic
      • 勾選「Send email notifications」(傳送電子郵件通知),讓系統在移轉執行失敗時,寄送電子郵件通知。
      • 設定移轉作業時,請勿勾選 [Disabled] (已停用)。如需停用現有的移轉作業,請參閱使用移轉一文。

        Cloud Pub/Sub 主題

  5. 按一下 [Add] (新增)

  6. 出現提示時,按一下 [Allow] (允許),讓 BigQuery 資料移轉服務有權限查看您的 YouTube 報告資料,以及存取並管理 BigQuery 中的資料。您必須允許來自 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_idtable_suffix 參數。您可以選擇將 configure_jobs 參數設為 true,允許 BigQuery 移轉服務為您管理 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 資料移轉服務的移轉設定問題中的 YouTube 移轉問題一節。

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁