安排 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.get
和bigquery.datasets.update
權限
bigquery.admin
這個預先定義的 IAM 角色具備bigquery.transfers.update
、bigquery.datasets.update
和bigquery.datasets.get
權限。如要進一步瞭解 BigQuery 資料移轉服務中的身分與存取權管理角色,請參閱「存取權控管」一文。- 用於建立資料移轉作業的
Merchant Center:
在移轉作業設定中所使用 Merchant Center 帳戶的標準存取權。如果您使用服務帳戶設定轉移作業,該服務帳戶必須具備 Merchant Center 帳戶的存取權。如要驗證存取權,請按一下 Merchant Center UI 中的「Users」(使用者) 區段。
如要查看價格競爭力、價格洞察資料和暢銷商品資料,您必須符合市場洞察的資格規定。
設定 Merchant Center 轉移作業
如要設定 Merchant Center 報表的資料移轉作業,您必須具備:
- 商家 ID 或多重客戶帳戶 ID:這是 Merchant Center UI 中顯示的商家 ID。
如何建立 Merchant Center 報表的資料移轉作業:
主控台
前往 Google Cloud 控制台的「資料移轉」頁面。
按一下
「建立移轉作業」。在「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。選取要移轉的報表,詳情請參閱「支援的報表」。
在「Service Account」(服務帳戶) 選單,選取與貴組織Google Cloud 專案相關聯的服務帳戶。您可以將服務帳戶與資料移轉作業建立關聯,而非使用使用者憑證。如要進一步瞭解如何搭配使用服務帳戶與資料移轉作業,請參閱使用服務帳戶的相關說明。
(選用步驟) 在「Notification options」(通知選項) 部分執行下列操作:
按一下 [儲存]。
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
參數可指定是否要傳輸產品成效資料。
- 針對 Merchant Center 資料移轉作業,您必須提供
- 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 移轉問題」一節。