將 YouTube 內容擁有者資料載入 BigQuery

您可以使用 YouTube 內容擁有者專用的 BigQuery 資料移轉服務連接器，將資料從 YouTube 內容擁有者載入 BigQuery。您可以使用 BigQuery 資料移轉服務，排定週期性移轉工作，將 YouTube 內容擁有者的最新資料新增至 BigQuery。

支援的報表

• 內容擁有者報告
• 系統代管報告
  • 總覽
  • 報告
  • 欄位

YouTube 內容擁有者報表適用的 BigQuery 資料移轉服務支援下列報表選項：

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

從 YouTube 內容擁有者轉移作業擷取資料

重新整理視窗

更新期是指資料移轉作業在執行時，擷取資料的天數。舉例來說，如果重新整理時間範圍為三天，且每天都會進行移轉，BigQuery 資料移轉服務就會從來源資料表擷取過去三天的所有資料。在這個範例中，每天進行移轉時，BigQuery 資料移轉服務會建立新的 BigQuery 目的地資料表分割區，並複製當天的來源資料表資料，然後自動觸發回填執行作業，以更新過去兩天的來源資料表資料。系統自動觸發的回填作業會覆寫或增量更新 BigQuery 目的地資料表，具體做法取決於 BigQuery 資料移轉服務連接器是否支援增量更新。

首次執行資料移轉時，資料移轉作業會擷取重新整理視窗內的所有可用來源資料。舉例來說，如果重新整理時間範圍為三天，且您是第一次執行資料移轉作業，BigQuery 資料移轉服務會擷取三天內的所有來源資料。

重新整理視窗會對應至 TransferConfig.data_refresh_window_days API 欄位。

如要擷取重新整理時間範圍外的資料 (例如歷來資料)，或從任何轉移中斷或缺漏中復原資料，您可以啟動或排定補充作業。

限制

• 每個報表支援的檔案大小上限為 1710 GB。
• 資料移轉作業的最低排程頻率為每 24 小時一次。根據預設，資料移轉會在您建立資料移轉時開始。不過，您可以在設定轉移作業時，設定轉移作業的開始時間。
• 在 YouTube 內容擁有者移轉作業期間，BigQuery 資料移轉服務不支援增量資料移轉。指定資料移轉日期後，系統會移轉該日期可用的所有資料。

事前準備

建立 YouTube 內容擁有者資料移轉作業前，請先完成下列事項：

• 確認您已完成啟用 BigQuery 資料移轉服務的一切必要動作。
• 建立 BigQuery 資料集來儲存 YouTube 資料。
• 確認您擁有 YouTube 內容擁有者帳戶。YouTube 內容擁有者與 YouTube 頻道並不相同。 一般來說，只有在必須管理多個不同的頻道時，您才需要擁有 YouTube 內容擁有者帳戶。
• 如要為 Pub/Sub 設定移轉作業執行通知，您必須擁有 pubsub.topics.setIamPolicy 權限。如果您只想設定電子郵件通知，則不需要擁有 Pub/Sub 權限。詳情請參閱 BigQuery 資料移轉服務執行通知一文。

所需權限

請確認要建立資料移轉作業的人員具備下列必要權限：

• BigQuery：

  • 建立資料移轉作業的 bigquery.transfers.update 權限
  • 目標資料集的 bigquery.datasets.get 和 bigquery.datasets.update 權限

  bigquery.admin 這個預先定義的 IAM 角色具備 bigquery.transfers.update、bigquery.datasets.update 和 bigquery.datasets.get 權限。如要進一步瞭解 BigQuery 資料移轉服務中的身分與存取權管理角色，請參閱存取權控管。

• YouTube：

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

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

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

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

  

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

如要設定 YouTube 內容擁有者資料移轉作業，您需要下列項目：

• 內容擁有者 ID：由 YouTube 提供。當您以內容擁有者或管理員身分登入 YouTube 時，您的 ID 會顯示在 URL 的 o= 後方。舉例來說，如果網址為 https://studio.youtube.com/owner/AbCDE_8FghIjK?o=AbCDE_8FghIjK，則內容擁有者 ID 為 AbCDE_8FghIjK。如要選取其他內容管理工具帳戶，請參閱「登入內容管理工具帳戶」或「YouTube 頻道切換器」。如要進一步瞭解如何建立及管理內容管理工具帳戶，請參閱「設定內容管理工具帳戶設定」。
• 資料表後置字串：您在設定移轉作業時為頻道提供的易記名稱。後置字串會附加在工作 ID 後方，形成資料表名稱，例如 reportTypeId_suffix。後置字串可用於防止不同的資料移轉作業寫入同一個資料表。所有將資料載入同個資料集的移轉工作，其資料表後置字串都不能重複，且後置字串應盡量簡短，避免產生過於冗長的資料表名稱。

如果您使用 YouTube Reporting API，並且已經有一些報表工作，BigQuery 資料移轉服務會載入您的報表資料。如果沒有現有的報表工作，設定資料移轉時，系統會自動啟用 YouTube 報表工作。

如要設定 YouTube 內容擁有者資料轉移作業：

bq mk \
--transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source \
--service_account_name=service_account_name

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

import com.google.api.gax.rpc.ApiException;
import com.google.cloud.bigquery.datatransfer.v1.CreateTransferConfigRequest;
import com.google.cloud.bigquery.datatransfer.v1.DataTransferServiceClient;
import com.google.cloud.bigquery.datatransfer.v1.ProjectName;
import com.google.cloud.bigquery.datatransfer.v1.TransferConfig;
import com.google.protobuf.Struct;
import com.google.protobuf.Value;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

// Sample to create youtube content owner channel transfer config
public class CreateYoutubeContentOwnerTransfer {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    final String projectId = "MY_PROJECT_ID";
    String datasetId = "MY_DATASET_ID";
    String contentOwnerId = "MY_CONTENT_OWNER_ID";
    String tableSuffix = "_test";
    Map<String, Value> params = new HashMap<>();
    params.put("content_owner_id", Value.newBuilder().setStringValue(contentOwnerId).build());
    params.put("table_suffix", Value.newBuilder().setStringValue(tableSuffix).build());
    TransferConfig transferConfig =
        TransferConfig.newBuilder()
            .setDestinationDatasetId(datasetId)
            .setDisplayName("Your Youtube Owner Channel Config Name")
            .setDataSourceId("youtube_content_owner")
            .setParams(Struct.newBuilder().putAllFields(params).build())
            .build();
    createYoutubeContentOwnerTransfer(projectId, transferConfig);
  }

  public static void createYoutubeContentOwnerTransfer(
      String projectId, TransferConfig transferConfig) throws IOException {
    try (DataTransferServiceClient client = DataTransferServiceClient.create()) {
      ProjectName parent = ProjectName.of(projectId);
      CreateTransferConfigRequest request =
          CreateTransferConfigRequest.newBuilder()
              .setParent(parent.toString())
              .setTransferConfig(transferConfig)
              .build();
      TransferConfig config = client.createTransferConfig(request);
      System.out.println(
          "Youtube content owner channel transfer created successfully :" + config.getName());
    } catch (ApiException ex) {
      System.out.print("Youtube content owner channel transfer was not created." + ex.toString());
    }
  }
}

查詢資料

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

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

排解 YouTube 內容擁有者移轉設定問題

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