Google Play 移轉作業

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

支援的報表

Google Play 專用的 BigQuery 資料移轉服務目前支援下列月報表選項:

詳細報表

匯總報表

如要瞭解 Google Play 報表如何轉換成 BigQuery 表格,請參閱 Google Play 報表轉換一文。

報表選項 支援
支援的 API 版本

不適用

排程

每天,在首次建立移轉作業的時間執行 (預設)

您可以設定時間。

更新期

最近 7 天

無法設定

補充作業時間長度上限

無限制

Google Play 沒有已知的資料保留限制,但 BigQuery 資料移轉服務對於單一補充作業可要求的天數設有限制。如需補充作業的相關資訊,請參閱設定補充作業

事前準備

建立 Google Play 移轉作業前,請先:

  • 確認您已完成啟用 BigQuery 資料移轉服務的一切必要動作。
  • 如果您要使用傳統 BigQuery 網頁版 UI 建立移轉作業,請允許來自 bigquery.cloud.google.com 的彈出式視窗,以便查看權限視窗。您必須允許 BigQuery 資料移轉服務取得相關權限,以管理您的移轉作業。
  • 建立 BigQuery 資料集以儲存 Google Play 資料。
  • 尋找您的 Cloud Storage 值區:
    • Google Play 管理中心選取任意報表,例如「評論」。Cloud Storage 值區的 ID 會顯示在頁面底部。值區 ID 的開頭是 gs://。舉例來說,如果是「評論」報表,您會看到:
      gs://pubsite_prod_rev_01234567890987654321/reviews
      如要設定移轉作業,只需複製 gs:///reviews 之間的唯一識別碼:
      pubsite_prod_rev_01234567890987654321
  • 移轉執行通知目前仍為 Alpha 版。如果您想要為 Cloud Pub/Sub 設定移轉執行通知,您必須具有 pubsub.topics.setIamPolicy 權限。如果您只是要設定電子郵件通知,就不需要 Cloud Pub/Sub 權限。詳情請參閱 BigQuery 資料移轉服務執行通知一文。

所需權限

  • BigQuery:確認建立移轉的人員在 BigQuery 中具有以下權限:

    • 建立移轉作業的 bigquery.transfers.update 權限。

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

  • Google Play:確認您在 Google Play 中已擁有下列權限:

    Google Cloud 小組「無法」代表您產生 Google Play 檔案或授予該檔案的存取權。如需存取 Google Play 檔案的說明,請參閱聯絡 Google Play 支援服務一文。

設定 Google Play 移轉作業

設定 Google Play 移轉作業須具備:

  • Cloud Storage 值區。如需找出 Cloud Storage 值區的步驟,請參閱事前準備一節。Cloud Storage 值區的開頭是 pubsite_prod_rev,例如:pubsite_prod_rev_01234567890987654321
  • 資料表後置字串:在載入同一資料集的所有資料來源標上易記名稱。後置字串可用於防止不同的移轉作業寫入同一個資料表。所有將資料載入同個資料集的移轉工作,其資料表後置字串都不能重複,並且後置字串應盡量簡短,避免產生過於冗長的資料表名稱。

要設定 Google Play 移轉作業:

主控台

  1. 前往 BigQuery 網頁版 UI。

    前往 BigQuery 網頁版 UI

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

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

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

    • 在「Source type」(來源類型) 區段中,針對「Source」(來源),選擇 [Google Play]

      移轉作業來源

    • 在「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」(資料來源詳細資料) 區段:

      • 在「Cloud Storage bucket」(Cloud Storage 值區) 部分,輸入 Cloud Storage 值區的 ID。
      • 在「Table suffix」(資料表後置字串) 部分,輸入後置字串,例如「MT」(即「My Transfer」的縮寫)。

        Google Play 來源詳細資料

    • (選用) 在「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」:選擇 [Google Play]
    • 「Display name」:輸入移轉作業的名稱,例如「My Transfer」。移轉名稱可以是任何容易識別的值,方便您後續修改。
    • 針對「Schedule」,保留預設值 (以移轉作業建立時間為時間點,間隔為每 24 小時);或點選 [Edit],然後變更時間。

      Google Play 移轉自訂時間表

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

    • 「Cloud Storage bucket」:輸入您的 Cloud Storage 值區。

    • 在「Table suffix」(資料表後置字串) 部分,輸入後置字串,例如「MT」(即「My Transfer」的縮寫)。

      Google Play 移轉預設時間表

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

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

        Cloud Pub/Sub 主題

  5. 按一下 [Add]。請注意,點按 [Add] 按鈕,即會將您選擇的目的地 BigQuery 資料集的讀取和寫入權限授予 Google Play 報表。

  6. 出現提示時,點選 [Allow],讓 BigQuery 資料移轉服務有權查看您的 Google Play 報表資料,以及存取並管理 BigQuery 中的資料。您必須允許來自 bigquery.cloud.google.com 的彈出式視窗,才能查看權限視窗。

    允許移轉

指令列

輸入 bq mk 指令並提供轉換建立標記 — --transfer_config。以下標記亦需提供:

  • --target_dataset
  • --display_name
  • --params
  • --data_source

    bq mk --transfer_config --project_id=[PROJECT_ID] --target_dataset=[DATASET] --display_name=[NAME] --params='[PARAMETERS]' --data_source=[DATA_SOURCE]
    

其中:

  • --project_id 是您的專案 ID。如未指定 --project_id,則會使用預設專案。
  • --target_dataset 是移轉設定的目標資料集。
  • --display_name 是移轉設定的顯示名稱。移轉名稱可以是任何容易識別並且方便您後續修改的值。
  • --params 含有已建立移轉設定的 JSON 格式參數。例如:--params='{"param":"param_value"}'。針對 Google Play,您必須提供 buckettable_suffix 參數。bucket 是包含您 Play 報表檔案的 Cloud Storage 值區。
  • --data_source 是資料來源:play

舉例來說,下列指令會使用 Cloud Storage 值區 pubsite_prod_rev_01234567890987654321 和目標資料集 mydataset 建立名為 My Transfer 的 Google Play 移轉作業。移轉作業會在預設專案中建立:

bq mk --transfer_config --target_dataset=mydataset --display_name='My Transfer' --params='{"bucket":"pubsite_prod_rev_01234567890987654321","table_suffix":"MT"}' --data_source=play

首次執行指令時,您會收到如下的訊息:

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

請按照訊息中的操作說明進行,在指令列中貼上驗證碼。

API

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

排解 Google Play 移轉設定問題

如果您在設定移轉作業時遇到問題,請參閱排解 BigQuery 資料移轉服務移轉設定問題相關說明。

查詢資料

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

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

後續步驟

  • 如要瞭解 Google Play 報告如何移轉至 BigQuery,請參閱 Google Play 報告轉換一文。
  • 如需 BigQuery 資料移轉服務的總覽,請參閱 BigQuery 資料移轉服務簡介一文。
  • 如要瞭解如何使用移轉作業,包括取得移轉設定、列出移轉設定及查看移轉設定的執行記錄等相關資訊,請參閱使用移轉功能一文。
本頁內容對您是否有任何幫助?請提供意見:

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

這個網頁