BigQuery Data Transfer Service 数据源更新日志

本页详细介绍了 BigQuery Data Transfer Service 数据源架构和架构映射的变更。如需了解 BigQuery Data Transfer Service 连接器即将发生的更改，您可以在此页面中搜索数据源（例如 Google Ads API 或 Facebook Ads API），或搜索特定表名称或值。

适用于 Google Ads 的 BigQuery Data Transfer Service 会定期更新以支持新列并适应新版 Google Ads API 引入的变更。适用于 Google Ads 的 BigQuery Data Transfer Service 连接器使用 Google Ads 连接器中支持的 API 版本。

以下部分简要介绍了更新到新版 Google Ads API 时所发生的变更。更改按发布日期排序，每条条目都提供了您需要做出哪些更改才能继续从 Google Ads 接收数据的信息。

如需详细了解 Google Ads API 发布时间表，请参阅时间表。

2025 年 1 月 20 日

Google Ads 转移计划将 Google Ads API 版本从 v16 更新为 v18。API 升级后，受影响表中新传输数据的列值将发生变化。如需了解详情，请参阅 Google Ads API 升级。

  • 目标开始日期：2025 年 1 月 20 日
  • 送达日期：待定

表：p_ads_Campaign_customer_id

受影响的列 旧值 (v16) 新值 (v18)
campaign_advertising_channel_type DISCOVERY DEMAND_GEN

表：p_ads_Ad_customer_id

受影响的列 旧值 (v16) 新值 (v18)
ad_type

DISCOVERY_MULTI_ASSET_AD

DISCOVERY_CAROUSEL_AD

DISCOVERY_VIDEO_RESPONSIVE_AD

DEMAND_GEN_MULTI_ASSET_AD

DEMAND_GEN_CAROUSEL_AD

DEMAND_GEN_VIDEO_RESPONSIVE_AD

表：Asset

受影响的列 旧值 (v16) 新值 (v18)
asset_type DISCOVERY_CAROUSEL_CARD DEMAND_GEN_CAROUSEL_CARD

如需确保查询在更新后可继续正常运行，请更改查询以同时选择旧值和新值。例如，如果您的 SQL 查询中包含以下 WHERE 条件：

WHERE asset_type='DISCOVERY_CAROUSEL_CARD'

将其替换为以下语句：

WHERE
  asset_type='DISCOVERY_CAROUSEL_CARD'
  OR asset_type='DEMAND_GEN_CAROUSEL_CARD'

2024 年 6 月 24 日

Google Ads 转移计划将 Google Ads API 版本从 v14 更新为 v16。在此 API 升级中，受影响表中新转移数据的列名称会发生更改。此外，部分列已被弃用。如需了解详情，请参阅 Google Ads API 升级。

  • 目标开始日期：2024 年 6 月 17 日
  • 送达日期：2024 年 6 月 23 日
受影响的表 弃用的列 新列
  • ShoppingProductStats
  • ShoppingProductConversionStats
 segments_product_bidding_category_level1 segments_product_category_level1
segments_product_bidding_category_level2 segments_product_category_level2
segments_product_bidding_category_level3 segments_product_category_level3
segments_product_bidding_category_level4 segments_product_category_level4
segments_product_bidding_category_level5 segments_product_category_level5
  • ProductGroupStats
 ad_group_criterion_listing_group_case_value_product_bidding_category_id ad_group_criterion_listing_group_case_value_product_category_category_id
ad_group_criterion_listing_group_case_value_product_bidding_category_level ad_group_criterion_listing_group_case_value_product_category_level
  • AssetGroupListingFilter
 asset_group_listing_group_filter_case_value_product_bidding_category_id asset_group_listing_group_filter_case_value_product_category_category_id
asset_group_listing_group_filter_case_value_product_bidding_category_level asset_group_listing_group_filter_case_value_product_category_level
asset_group_listing_group_filter_vertical asset_group_listing_group_filter_listing_source

在 Google Ads API v14 中，segments_product_category_level1 和 segments_product_category_level2 等新列已添加到 BigQuery 表架构中，但使用 null 进行填充。更新到 Google Ads API v16 后，这些新列将使用新值进行填充。弃用的列（例如 segments_product_bidding_category_level1 和 segments_product_bidding_category_level2）将使用 null 进行填充，但仍保留在表架构中。

对于每对列，只有一列会使用 Google Ads API 中的值进行填充，而另一列会使用 null 进行填充。如需确保现有查询在更新后可继续正常运行，请更新查询以选择两列之一。例如，如果您的 SQL 查询中包含以下语句：

segments_product_bidding_category_level1

请替换为指定正确列的以下语句：

IFNULL(segments_product_category_level1, segments_product_bidding_category_level1)

在 2024 年 6 月 24 日之后创建的转移作业配置将始终使用新列。弃用的列仍会保留在表架构中，但会使用 null 进行填充。