安排 Google Merchant Center 转移作业

控制台

1. 转到 Google Cloud 控制台中的 BigQuery 页面。

   转到 BigQuery 页面

2. 点击数据传输。

3. 点击创建转移作业。

4. 在创建转移作业页面上：

   • 在来源类型部分的来源中，选择 Google Merchant Center。

   • 在转移配置名称部分的显示名中，输入转移作业的名称，例如 My Transfer。转移作业名称可以是任何可让您在需要修改转移作业时识别该转移作业的名称。

     

   • 在时间表选项部分中，执行以下操作：

     • 选择重复频率。如果您选择小时、天、周或月，则还必须指定频率。您还可以选择自定义来指定自定义重复频率。如果您选择按需，则当您手动触发转移作业时，此转移作业会运行。

     • 如果适用，请选择立即开始或在设置的时间开始，并提供开始日期和运行时间。

     • 在开始日期和运行时间部分，输入开始转移作业的日期和时间。此值应该比当前世界协调时间 (UTC) 至少晚 24 小时。如果选择立即开始，则此选项处于停用状态。

       

       如果将时间表选项设置为立即开始，则第一次转移作业将立即开始运行，它将失败，并显示以下错误消息：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.。安排的下一次运行应会成功。如果您的商家账号数据在采用世界协调时间 (UTC) 的同一日期准备就绪，则可以为当天的运行设置回填。

   • 在目标设置部分的目标数据集中，选择您创建用来存储数据的数据集。

     

   • 在数据源详细信息部分的商家 ID 中，输入您的商家 ID 或 MCA ID。

     选择您要转移的报告。如需了解详情，请参阅支持的报告。

     

   • 在服务账号菜单中，从与您的 Google Cloud 项目关联的服务账号中选择一个服务账号。您可以将服务账号与转移作业相关联，而不是使用用户凭据。如需详细了解如何将服务账号用于数据转移，请参阅使用服务账号。

     • 如果您使用联合身份登录，则需要有服务账号才能创建转移作业。如果您使用 Google 账号登录，则转移作业的服务账号是可选的。
     • 服务账号必须具有所需的权限。

   • （可选）在通知选项部分，执行以下操作：

     • 点击切换开关以启用电子邮件通知。启用此选项后，转移作业管理员会在转移作业运行失败时收到电子邮件通知。
     • 在选择 Pub/Sub 主题部分，选择您的主题名称，或点击创建主题。此选项用于为您的转移作业配置 Pub/Sub 运行通知。

5. 点击保存。

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"}'。
  • 对于 Google 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 的 Google 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.

请按照该消息中的说明操作，并将身份验证代码粘贴到命令行中。

如果您刚刚创建了此转移作业，则最长可能需要等待一天，您的商家账号的数据才会准备就绪，可进行转移。安排的下一次运行应会成功。如果您的商家账号数据在采用世界协调时间 (UTC) 的同一日期准备就绪，则可以为当天的运行设置回填。

API

使用 projects.locations.transferConfigs.create 方法并提供一个 TransferConfig 资源实例。