YouTube 頻道移轉

YouTube 適用的 BigQuery 資料移轉服務可讓您針對 YouTube 頻道報表自動安排及管理週期性載入工作。

支援的報表

YouTube 頻道報表適用的 BigQuery 資料移轉服務目前支援下列報表選項:

要瞭解 YouTube 頻道報表如何轉換成 BigQuery 資料表和視圖,請參閱 YouTube 頻道報表轉換一文。

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

每天,大約在 14:10 (世界標準時間)

您可以設定時段

更新期

過去 1 天

無法設定

補充作業時間長度上限

30 天

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

事前準備

建立 YouTube 頻道移轉作業前,請先完成下列事項:

  • 確認您已完成啟用 BigQuery 資料移轉服務的一切必要動作。
  • 建立 BigQuery 資料集來儲存 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 頻道移轉作業,您需要下列項目:

  • 資料表後置字串:您在設定移轉作業時為頻道提供的易記名稱。後置字串會附加在工作 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 Channel] (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」(資料來源詳細資料) 區段:

      • 針對 [Customer ID] (客戶 ID),輸入您的客戶 ID 或管理員帳戶。
      • 勾選 [Exclude removed/disabled Items] (排除已移除/已停用的項目),以免移轉已移除或停用的實體和指標。

        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. 在「New Transfer」(新增移轉作業) 頁面上:

    • 為「Source」(來源) 選擇 [YouTube Channel]
    • 在「Display name」(顯示名稱) 中,輸入移轉作業的名稱,例如 My Transfer
    • 保留「Schedule」(排程) 的預設值,或按一下 [Edit] (編輯) 並變更時間。

      頻道移轉自訂時間表

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

    • 在「Channel Page ID」(頻道頁面 ID) 中輸入頻道頁面 ID。

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

    • 勾選 [Configure Jobs] (設定工作),讓 BigQuery 資料移轉服務為您管理 YouTube 報表工作。如果您的頻道目前沒有任何 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.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 頻道移轉作業時,您必須提供 page_idtable_suffix 參數。您可以選擇將 configure_jobs 參數設為 true,讓 BigQuery 資料移轉服務為您管理 YouTube 報表工作。如果您的頻道目前沒有任何 YouTube 報表,系統會建立新的報表工作來啟用這些報表。
  • --data_source 是資料來源:youtube_channel。

您也可以提供 --project_id 標記,用以指定特定的專案。如未指定 --project_id,系統會使用預設的專案。

舉例來說,下列指令會使用頁面 ID 123123123、資料表後置字串 MT 和目標資料集 mydataset,建立名為 My Transfer 的 YouTube 頻道移轉作業。移轉是以預設的專案建立:

bq mk --transfer_config --target_dataset=mydataset --display_name='My Transfer' --params='{"page_id":"123123123","table_suffix":"MT","configure_jobs":"true"}' --data_source=youtube_channel

API

使用 projects.locations.transferConfigs.create 方法並提供 TransferConfig 資源的執行個體。

查詢資料

資料移轉至 BigQuery 時,系統會將資料寫入擷取時間分區資料表。詳情請參閱分區資料表簡介一文。

如果您要直接查詢資料表,而不要使用自動產生的資料檢視,您必須在查詢中使用 _PARTITIONTIME 虛擬資料欄。詳情請參閱查詢分區資料表一文。

排解 YouTube 頻道移轉設定問題

如果您無法順利設定移轉,請參閱排解 BigQuery 資料移轉服務的移轉設定問題中的 YouTube 移轉問題一節。

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

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

這個網頁