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 預先定義的專案層級 Cloud IAM 角色具有 bigquery.transfers.updatebigquery.datasets.update 權限。如要進一步瞭解 BigQuery 中的 Cloud IAM 角色,請參閱存取權控管一文。

  • YouTube:YouTube 頻道的擁有者。

設定 YouTube 頻道移轉作業

如要設定 YouTube 頻道移轉作業,您需要下列項目:

  • 資料表後置字串:您在設定移轉作業時為頻道提供的易記名稱。後置字串會附加在工作 ID 後方,形成資料表名稱,例如 [reportTypeId]_[suffix]。後置字串可用於防止不同的移轉作業寫入同一個資料表。所有將資料載入同個資料集的移轉工作,其資料表後置字串都不能重複,且後置字串應盡量簡短,避免產生過於冗長的資料表名稱。

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

如何建立 YouTube 頻道移轉作業:

主控台

  1. 前往 GCP Console。

    前往 GCP Console

  2. 按一下 [Transfers] (傳輸作業)

  3. 按一下 [Create Transfer] (建立移轉作業)

  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 (自訂)
        • 隨選
      • 在「Start date and run time」(開始日期和執行時間) 部分,輸入開始移轉的日期與時間。如果您選擇 [Start now] (立即開始),系統就會停用這個選項。

        移轉作業時間表

    • 在 [Destination settings] (目的地設定) 區段,針對「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 的彈出式視窗,才能查看權限視窗。如果您有多個帳戶,系統可能還會提示您選擇帳戶。

    允許移轉作業

CLI

輸入 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。
  • 「dataset」是移轉設定的目標資料集。
  • 「name」是移轉設定的顯示名稱。移轉作業名稱可以是任何容易辨識的值,方便您日後在必要時進行修改。
  • parameters 含有已建立移轉設定的 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 移轉問題一節。

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

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

這個網頁
需要協助嗎?請前往我們的支援網頁