BigQuery Data Transfer Service 数据源更改日志

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

Campaign Manager 360

适用于 Campaign Manager 360 的 BigQuery Data Transfer Service 连接器会定期更新，以支持新的列、已弃用的列或已迁移的列。适用于 Campaign Manager 360 的 BigQuery Data Transfer Service 连接器可从 Campaign Manager 360 数据转移文件中检索数据。

以下各部分概述了这些变更。更改按发布日期进行整理，每个条目都提供了您需要做出的更改的信息，以便您继续从 Campaign Manager 360 接收数据。

2025 年 7 月 7 日

Campaign Manager 360 宣布将更新浏览器、操作系统、移动设备品牌和型号以及 ISP 数据的标准 ID，使其符合跨平台数据标准。迁移后，Campaign Manager 360 将停止填充已弃用的列的值，并开始填充新列的值。受影响的列如下：

弃用的列 新列
DBM_Browser_Platform_ID DV360_Browser_Platform_Reportable_ID
DBM_ISP_ID DV360_ISP_Reportable_ID
DBM_Operating_System_ID DV360_Operating_System_Reportable_ID
DBM_Mobile_Make_ID DV360_Mobile_Make_Reportable_ID
DBM_Mobile_Model_ID DV360_Mobile_Model_Reportable_ID

Display & Video 360 API

适用于 Display & Video 360 的 BigQuery Data Transfer Service 连接器会定期更新以支持新列并适应新版 Display & Video 360 API 引入的变更。适用于 Display & Video 360 的 BigQuery Data Transfer Service 连接器使用受支持的 API 版本来检索配置数据。

以下部分概述了更新到新版 Display & Video 360 API 时所发生的变更。更改按发布日期进行整理，每个条目都提供了您需要做出的更改的信息，以便您继续从 Display & Video 360 接收数据。

2025 年 8 月 26 日

Display & Video 360 连接器计划将用于检索配置数据的 Display & Video 360 API 版本从 v3 更新到 v4。下一部分列出了 API 升级带来的变化。如需了解详情，请参阅 Display & Video 360 API v3 到 v4 迁移指南。

此项针对 Display & Video 360 连接器的更新计划于 2025 年 8 月 26 日开始。

已弃用的表

以下表将停止接收新数据。现有数据将保留，但不会再填充任何更新。

  • CampaignTargeting
  • InsertionOrderTargeting

包含已重命名列的表

受影响的表 弃用的列 新列
  • AdGroupTargeting
  • LineItemTargeting
 audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups
audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups.settings audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups.settings
audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups.settings.firstAndThirdPartyAudienceId audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups.settings.firstPartyAndPartnerAudienceId
audienceGroupDetails.includedFirstAndThirdPartyAudienceGroups.settings.recency audienceGroupDetails.includedFirstPartyAndPartnerAudienceGroups.settings.recency
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup.settings audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup.settings
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup.settings.firstAndThirdPartyAudienceId audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup.settings.firstPartyAndPartnerAudienceId
audienceGroupDetails.excludedFirstAndThirdPartyAudienceGroup.settings.recency audienceGroupDetails.excludedFirstPartyAndPartnerAudienceGroup.settings.recency

包含已弃用列的表

受影响的表 弃用的列
Creative reviewStatus.publisherReviewStatuses

适用于 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 发布时间表，请参阅时间表。

2026 年 3 月 2 日

Google Ads 连接器计划将 Google Ads API 版本从 v21 更新到 v22。升级 API 后，受影响的表中新转移数据的列值将发生更改。如需了解详情，请参阅 Google Ads API 升级。

弃用的列 新列 受影响的表
metrics_average_cpv metrics_trueview_average_cpv
  • AccountNonClickStats
  • AdCrossDeviceStats
  • AdGroupAudienceNonClickStats
  • AdGroupCrossDeviceStats
  • AgeRangeNonClickStats
  • BudgetStats
  • CampaignAssetStats
  • CampaignAudienceNonClickStats
  • CampaignCrossDeviceStats
  • CampaignLocationTargetStats
  • DisplayVideoAutomaticPlacementsStats
  • DisplayVideoKeywordStats
  • GenderNonClickStats
  • GeoStats
  • KeywordCrossDeviceStats
  • ParentalStatusNonClickStats
  • PlacementNonClickStats
  • SearchQueryStats
  • VideoNonClickStats
metrics_video_view_rate metrics_video_trueview_view_rate
  • AccountNonClickStats
  • AdCrossDeviceStats
  • AdGroupAudienceNonClickStats
  • AdGroupCrossDeviceStats
  • AgeRangeNonClickStats
  • BudgetStats
  • CampaignAudienceNonClickStats
  • CampaignCrossDeviceStats
  • CampaignLocationTargetStats
  • DisplayVideoAutomaticPlacementsStats
  • GenderNonClickStats
  • GeoStats
  • KeywordCrossDeviceStats
  • ParentalStatusNonClickStats
  • PlacementNonClickStats
  • SearchQueryStats
  • VideoNonClickStats
metrics_video_views metrics_video_trueview_views
  • AccountNonClickStats
  • AdCrossDeviceStats
  • AdGroupAudienceNonClickStats
  • AdGroupCrossDeviceStats
  • AgeRangeNonClickStats
  • BudgetStats
  • CampaignAudienceNonClickStats
  • CampaignCrossDeviceStats
  • CampaignLocationTargetStats
  • DisplayVideoAutomaticPlacementsStats
  • GenderNonClickStats
  • GeoStats
  • KeywordCrossDeviceStats
  • ParentalStatusNonClickStats
  • PlacementNonClickStats
  • SearchQueryStats
  • VideoNonClickStats

到 2026 年 1 月 16 日，Google Ads 连接器将向表架构添加 metrics_trueview_average_cpv、metrics_video_trueview_view_rate 和 metrics_video_trueview_views 列，并使用 null 填充这些列。在 2026 年 3 月 2 日更新到 Google Ads API v22 后，这些新列将使用新值进行填充。部分列现已弃用，例如 metrics_average_cpv、metrics_video_view_rate 和 metrics_video_views。弃用的列现在使用 null 进行填充，但仍保留在表架构中。

对于每对列，只有一列会使用 Google Ads API 中的值进行填充，而另一列会使用 null 进行填充。为响应 Google Ads API v22 更新，请更新查询以指定这两列之一。例如，如果您的 SQL 查询选择了列 metrics_average_cpv，请更新该查询，使其指定正确的列：

IFNULL(metrics_average_cpv, metrics_trueview_average_cpv)

如果您使用自定义报告，请参阅 Google Ads API v22 参考页面和 Google Ads API 版本说明，以便在 Google Ads 连接器升级到 Google Ads v22 API 后更新受影响的 GAQL 查询。 如果您使用自定义报告，请参阅 Google Ads API v22 参考页面和 Google Ads API 版本说明，以便在 Google Ads 连接器升级到 Google Ads v22 API 后更新受影响的 GAQL 查询。

2025 年 8 月 1 日

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

表：p_ads_Ad_customer_id

受影响的列 已弃用的数据类型
ad_group_type VIDEO_OUTSTREAM
ad_group_ad_ad_type VIDEO_OUTSTREAM

表：p_ads_Campaign_customer_id

受影响的列 已弃用的数据类型
campaign_advertising_channel_sub_type VIDEO_OUTSTREAM

表：p_ads_DisplayVideoKeywordStats_customer_id

受影响的列 已弃用的数据类型
campaign_advertising_channel_sub_type VIDEO_OUTSTREAM

2025 年 1 月 20 日

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

此项针对 Google Ads 连接器的更新于 2025 年 1 月 20 日开始，并于 2025 年 2 月 4 日完成。

表：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 升级。

此项针对 Google Ads 连接器的更新于 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 进行填充。

Google Analytics API

适用于 Google Analytics 的 BigQuery Data Transfer Service 连接器会定期更新以支持新列并适应新版 Google Analytics Data API 引入的变更。适用于 Google Analytics 的 BigQuery Data Transfer Service 连接器使用最新支持的 API 版本来检索报告数据。

以下部分概述了更新到新版 Google Analytics Data API 时所发生的变更。更改按发布日期进行整理，每个条目都提供了您需要做出的更改的信息，以便您继续从 Google Analytics 接收数据。

2025 年 9 月 22 日

Google Analytics 连接器计划弃用表并更新架构，以反映 Google Analytics Data API v1 中的变更。以下部分中列出了这些变更。

此项针对 Google Analytics 连接器的更新计划于 2025 年 9 月 22 日开始。

已弃用的表

下表展示了将会弃用并替换为具有更新后架构的新表的表。请注意，p_ga4_conversions 和 p_ga4_inAppPurchases 表将在此次更新后停用。已弃用的表和新表都将在 2025 年 9 月 22 日之前填充，以便留出时间进行迁移。您可以使用转移作业配置中的表过滤器选项过滤出已弃用的表。

已弃用的表 新表
p_ga4_audiences p_ga4_Audiences
p_ga4_conversions Deprecated
p_ga4_demographicDetails p_ga4_DemographicDetails
p_ga4_ecommercePurchase p_ga4_EcommercePurchase
p_ga4_events p_ga4_Events
p_ga4_inAppPurchases Deprecated
p_ga4_landingPage p_ga4_LandingPage
p_ga4_pagesAndScreens p_ga4_PagesAndScreens
p_ga4_promotions p_ga4_Promotions
p_ga4_techDetails p_ga4_TechDetails
p_ga4_trafficAcquisition p_ga4_TrafficAcquisition
p_ga4_userAcquisition p_ga4_UserAcquisition

更新的表架构

您可以在 Google Analytics 报告转换页面上找到新的表架构。

方案更改摘要：

  • 更正了架构：更正了流量获取情况、用户获取情况和着陆页报告的架构。例如，流量获取情况和用户获取情况报告的架构之前是互换的，着陆页报告缺少 landingPage 维度。
  • 字段重命名和停用：为了与当前的 Google Analytics 术语保持一致，我们已将所有报告中的转化字段重命名为 keyEvents。因此，“转化”报告本身已停用。
  • 数据类型更改：BigQuery 中的收入字段从 INTEGER 更改为 FLOAT，以准确表示 API 返回的浮点微值。
  • 新表和字段命名惯例：新表中的字段名称使用 camelCase（例如 eventCount），以便与 Google Analytics API 保持一致，取代之前的 snake_case（例如 event_count）。

Google Play 管理中心

适用于 Google Play 的 BigQuery Data Transfer Service 连接器会定期更新，以支持 Google Play 引入的新报告和当前报告的变更。

以下各部分按发布日期概述了这些变更。

2025 年 12 月 1 日

Google Play 计划对收入报告进行以下更改。相应更改将反映在 BigQuery 表 p_Earnings_suffix 中。以下部分中列出了这些变更。

重命名的列

以下 Google Play 列将被重命名。

弃用的列 新列
Base_Plan_ID Base_Plan_or_Purchase_Option_ID
Product_id Package_ID

列值更改

列 Product_Type 将从数值表示形式更改为人类可读的字符串。

新列

系统会在“收入”报告中添加一个新列 Sales_Channel。此字段提供有关销售来源的信息。

Salesforce Bulk API

适用于 Salesforce 的 BigQuery Data Transfer Service 连接器会定期更新，以支持 Salesforce Bulk API 引入的变更。

以下部分概述了 Salesforce 连接器更新到新版 Bulk API 时所发生的变更。更改按发布日期进行整理，每个条目都提供了您需要做出的更改的信息，以便您继续从 Salesforce 接收数据。

2025 年 10 月 14 日

在 Salesforce 连接器正式版发布后，Salesforce 连接器现在使用 Salesforce Bulk API V1 版本 64.0。Salesforce Bulk API V1 版本 53.0 中支持的多个字段已不再受支持。

已弃用的字段 

下表显示了在 Salesforce 连接器正式版发布时弃用的字段，以及与每个字段关联的 sObject 名称。

已弃用的字段 sObject名称
EffectiveDate MobSecurityCertPinConfig
PermissionsAllowObjectDetectionTraining Profile
PermissionsAllowObjectDetection Profile
PermissionsAllowObjectDetectionTraining PermissionSet
PermissionsAllowObjectDetection PermissionSet
MaximumPermissionsAllowObjectDetectionTraining PermissionSetLicense
MaximumPermissionsAllowObjectDetection PermissionSetLicense
PermissionsAllowObjectDetectionTraining UserPermissionAccess
PermissionsAllowObjectDetection UserPermissionAccess
PermissionsAllowObjectDetectionTraining MutingPermissionSet
PermissionsAllowObjectDetection MutingPermissionSet
OptionsHstsHeaders Domain
UserPreferencesHideInvoicesRedirectConfirmation User
UserPreferencesHideStatementsRedirectConfirmation User
UserPreferencesHideInvoicesRedirectConfirmation UserChangeEvent
UserPreferencesHideStatementsRedirectConfirmation UserChangeEvent

YouTube Reporting API

适用于 YouTube 内容所有者和 YouTube 频道的 BigQuery Data Transfer Service 连接器会定期更新，以支持 YouTube Reporting API 引入的新报告并弃用旧报告。

以下部分概述了 YouTube Reporting API 推出新报告时所发生的变更。更改按发布日期进行整理，每个条目都提供了您需要做出的更改的信息，以便您继续从 YouTube 接收数据。

2025 年 9 月 22 日

YouTube 内容所有者连接器和 YouTube 频道连接器计划推出新报告并弃用旧报告，以反映 YouTube Shorts 观看次数变化。 以下部分中列出了这些变更。

新报告计划于 2025 年 7 月 7 日开始推出。您无需采取任何行动即可获取新报告。旧报告的弃用计划于 2025 年 9 月 22 日开始。

YouTube 内容所有者连接器 - 已弃用的表

对于 YouTube 内容所有者连接器，下表展示了将会弃用并替换为具有更新的架构的新表的 BigQuery 表。已弃用的表和新表都将在 2025 年 9 月 22 日之前填充，以便留出时间进行迁移。2025 年 9 月 22 日之后，系统将仅填充新表。suffix 的值是您在创建转移作业时配置的表后缀。

已弃用的表 新表
p_content_owner_asset_basic_a2_suffix p_content_owner_asset_basic_a3_suffix
p_content_owner_asset_combined_a2_suffix p_content_owner_asset_combined_a3_suffix
p_content_owner_asset_device_os_a2_suffix p_content_owner_asset_device_os_a3_suffix
p_content_owner_asset_playback_location_a2_suffix p_content_owner_asset_playback_location_a3_suffix
p_content_owner_asset_province_a2_suffix p_content_owner_asset_province_a3_suffix
p_content_owner_asset_traffic_source_a2_suffix p_content_owner_asset_traffic_source_a3_suffix
p_content_owner_basic_a3_suffix p_content_owner_basic_a4_suffix
p_content_owner_combined_a2_suffix p_content_owner_combined_a3_suffix
p_content_owner_device_os_a2_suffix p_content_owner_device_os_a3_suffix
p_content_owner_playback_location_a2_suffix p_content_owner_playback_location_a3_suffix
p_content_owner_playlist_basic_a1_suffix p_content_owner_playlist_basic_a2_suffix
p_content_owner_playlist_combined_a1_suffix p_content_owner_playlist_combined_a2_suffix
p_content_owner_playlist_device_os_a1_suffix p_content_owner_playlist_device_os_a2_suffix
p_content_owner_playlist_playback_location_a1_suffix p_content_owner_playlist_playback_location_a2_suffix
p_content_owner_playlist_province_a1_suffix p_content_owner_playlist_province_a2_suffix
p_content_owner_playlist_traffic_source_a1_suffix p_content_owner_playlist_traffic_source_a2_suffix
p_content_owner_province_a2_suffix p_content_owner_province_a3_suffix
p_content_owner_subtitles_a2_suffix p_content_owner_subtitles_a3_suffix
p_content_owner_traffic_source_a2_suffix p_content_owner_traffic_source_a3_suffix
p_content_owner_shorts_ad_revenue_summary_a1_suffix p_content_owner_shorts_ad_revenue_summary_a2_suffix
p_content_owner_shorts_country_ad_revenue_summary_a1_suffix p_content_owner_shorts_country_ad_revenue_summary_a2_suffix
p_content_owner_shorts_day_ad_revenue_summary_a1_suffix p_content_owner_shorts_day_ad_revenue_summary_a2_suffix
p_content_owner_shorts_global_ad_revenue_summary_a1_suffix p_content_owner_shorts_global_ad_revenue_summary_a2_suffix

YouTube 频道连接器 - 已弃用的表

对于 YouTube 频道连接器，下表展示了将会弃用并替换为具有更新的架构的新表的 BigQuery 表。已弃用的表和新表都将在 2025 年 9 月 22 日之前填充，以便留出时间进行迁移。2025 年 9 月 22 日之后，系统将仅填充新表。suffix 的值是您在创建转移作业时配置的表后缀。

已弃用的表 新表
p_channel_basic_a2_suffix p_channel_basic_a3_suffix
p_channel_combined_a2_suffix p_channel_combined_a3_suffix
p_channel_device_os_a2_suffix p_channel_device_os_a3_suffix
p_channel_playback_location_a2_suffix p_channel_playback_location_a3_suffix
p_channel_province_a2_suffix p_channel_province_a3_suffix
p_channel_subtitles_a2_suffix p_channel_subtitles_a3_suffix
p_channel_traffic_source_a2_suffix p_channel_traffic_source_a3_suffix
p_playlist_basic_a1_suffix p_playlist_basic_a2_suffix
p_playlist_combined_a1_suffix p_playlist_combined_a2_suffix
p_playlist_device_os_a1_suffix p_playlist_device_os_a2_suffix
p_playlist_playback_location_a1_suffix p_playlist_playback_location_a2_suffix
p_playlist_province_a1_suffix p_playlist_province_a2_suffix
p_playlist_traffic_source_a1_suffix p_playlist_traffic_source_a2_suffix

更新的表架构

新表将包含一个名为 engaged_views 的新列。如需详细了解此指标，请参阅 Shorts 观看次数变化。