安排 Merchant Center 轉移作業

事前準備

建立 Merchant Center 資料移轉作業前,請先完成下列事項:

  • 確認您已完成啟用 BigQuery 資料移轉服務的一切必要動作。
  • 建立 BigQuery 資料集以儲存 Merchant Center 資料。
    • 針對資料集區域,我們支援在美國或歐盟使用預設選項「多區域」。
    • 如要在特定區域建立資料集,Merchant Center 資料移轉功能僅支援下列區域:
    • us-east4 (Northern Virginia)
    • asia-northeast1 (Tokyo)
    • asia-southeast1 (Singapore)
    • australia-southeast1 (Sydney)
    • europe-north1 (Finland)
    • europe-west2 (London)
    • europe-west6 (Zurich)
  • 如果您想要為 Pub/Sub 設定移轉執行通知,就必須具有 pubsub.topics.setIamPolicy 權限。如果您只想設定電子郵件通知,則不需要擁有 Pub/Sub 權限。詳情請參閱 BigQuery 資料移轉服務執行通知

所需權限

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

  • BigQuery

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

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

  • Merchant Center

設定 Merchant Center 轉移作業

如要設定 Merchant Center 報表的資料移轉作業,您必須具備:

如何建立 Merchant Center 報表的資料移轉作業:

主控台

  1. 前往 Google Cloud 控制台的「資料移轉」頁面。

    前往「資料移轉」

  2. 按一下 「建立移轉作業」

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

    • 在「Source type」(來源類型) 區段中,針對「Source」(來源) 選擇 [Google Merchant Center]
    • 在「Transfer config name」(轉移設定名稱) 部分,「Display name」(顯示名稱) 請輸入資料移轉作業的名稱,例如 My Transfer。移轉作業名稱可以是任何能讓您辨識移轉作業的值,方便您日後在必要時進行修改。

      移轉作業名稱

    • 在「Schedule options」(排程選項) 專區:

      • 選取重複頻率。如果選取「Hours」(小時)、「Days」(天)、「Weeks」(週)或「Months」(月),必須一併指定頻率。您也可以選取「Custom」(自訂),指定重複頻率。如果選取「On-demand」(隨選),這項資料移轉作業會在您手動觸發後執行。
      • 視情況選取「Start now」(立即開始) 或「Start at set time」(在所設時間開始執行),並提供開始日期和執行時間。
      • 針對「Start date and run time」(開始日期和執行時間),請輸入開始移轉作業的日期和時間。這個值至少須比當下的世界標準時間晚 24 小時。如果選取「Start now」(立即開始),這個選項就會停用。

      如果將排程選項設為「Start now」(立即開始),就會立即開始執行第一次資料移轉作業並失敗,錯誤訊息如下:No data to transfer found for the Merchant account. If you have just created this transfer, you may need to wait for up to a day before the data of your Merchant account are prepared and available for the transfer.。下次已排定的執行作業應該會成功執行。如果您的商家帳戶資料會在相同日期準備就緒 (以世界標準時間為準),可以為今天的執行作業設定補充作業

      移轉作業排程

    • 在「Destination settings」(目的地設定) 部分,「Destination dataset」(目的地資料集) 請選取您為了儲存資料而建立的資料集。

      移轉資料集

    • 在「Data source details」(資料來源詳細資料) 部分,「Merchant ID」(商家 ID) 請輸入您的商家 ID 或 MCA ID。選取要移轉的報表,詳情請參閱「支援的報表」。

      Google Merchant Center 移轉資料。

    • 在「Service Account」(服務帳戶) 選單,選取與貴組織Google Cloud 專案相關聯的服務帳戶。您可以將服務帳戶與資料移轉作業建立關聯,而非使用使用者憑證。如要進一步瞭解如何搭配使用服務帳戶與資料移轉作業,請參閱使用服務帳戶的相關說明。

      • 如果使用聯合身分登入,您必須擁有服務帳戶才能建立資料移轉作業。如果是以 Google 帳戶登入,則不一定要透過服務帳戶建立移轉作業。
      • 服務帳戶必須具備必要權限
    • (選用步驟) 在「Notification options」(通知選項) 部分執行下列操作:

      • 按一下啟用電子郵件通知的切換開關。當您啟用此選項時,移轉管理員會在移轉作業失敗時收到電子郵件通知。
      • 在「Select a Pub/Sub topic」(選取 Pub/Sub 主題) 選取主題名稱,或是點選「Create a topic」(建立主題)。這個選項會針對移轉作業設定 Pub/Sub 執行通知
  4. 按一下 [儲存]

bq

輸入 bq mk 指令並提供移轉建立標記 - --transfer_config。還需加上以下旗標:

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

您還可以提供 --project_id 標記來指定特定專案。如果您沒有指定 --project_id,系統會使用預設專案。

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

其中:

  • project_id 是您的專案 ID。
  • dataset 是移轉設定的目標資料集。
  • name 是移轉設定的顯示名稱。移轉作業名稱可以是任意值,日後需要修改移轉作業時,能夠據此識別即可。
  • parameters 含有已建立移轉設定的 JSON 格式參數。例如:--params='{"param":"param_value"}'
    • 針對 Merchant Center 資料移轉作業,您必須提供 merchant_id 參數。
    • export_products 參數可指定是否要傳輸產品和產品問題資料。即使您未指定 export_products 參數,系統也會預設加入這個參數。Google 建議您明確加入這個參數,並將其設為「true」。
    • export_regional_inventories 參數可指定是否要轉移區域商品目錄資料。
    • export_local_inventories 參數可指定是否要轉移本機商品目錄資料。
    • export_price_competitiveness 參數可指定是否要轉移價格競爭力資料。
    • export_price_insights 參數會指定是否要傳輸價格深入分析資料。
    • export_best_sellers_v2 參數會指定是否要轉移暢銷書資料。
    • export_performance 參數可指定是否要傳輸產品成效資料。
  • data_source 是資料來源:merchant_center
  • service_account_name 是用於驗證資料移轉作業的服務帳戶名稱。服務帳戶應由用於建立移轉作業的相同 project_id 擁有,且應具備所有必要權限

舉例來說,下列指令會使用商家 ID 1234 和目標資料集 mydataset,建立名為 My Transfer 的 Merchant Center 資料移轉作業。資料移轉作業會在預設專案中建立。

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"merchant_id":"1234","export_products":"true","export_regional_inventories":"true","export_local_inventories":"true","export_price_benchmarks":"true","export_best_sellers":"true"}' \
--data_source=merchant_center

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

[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 資源的執行個體。

排解 Merchant Center 轉移設定問題

如果您在設定資料移轉作業時遇到問題,請參閱排解 BigQuery 資料移轉服務的移轉作業設定問題中的「Merchant Center 移轉問題」一節。