BigQuery Data Transfer Service のデータソースの変更ログ

このページでは、BigQuery Data Transfer Service のデータソース スキーマとスキーマ マッピングの変更について詳しく説明します。BigQuery Data Transfer Service コネクタに関して近く予定されている変更については、このページでデータソース（Google Ads API や Facebook Ads API など）または特定のテーブル名や値を検索してください。

Google 広告用 BigQuery Data Transfer Service では、新しい列をサポートし、新しい Google Ads API バージョンによる変更に対応するための定期的な更新が行われます。Google 広告用 BigQuery Data Transfer Service コネクタでは、Google 広告コネクタでサポートされている API バージョンが使用されます。

次のセクションでは、Google Ads API の新しいバージョンに更新する際の変更点について説明します。変更点はリリース日ごとにまとめられています。各エントリには、Google 広告から引き続きデータを受信するために行う必要のある変更についての情報が記載されています。

Google Ads API のリリース スケジュールの詳細については、スケジュールをご覧ください。

2025 年 1 月 20 日

Google 広告の転送では、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 広告の転送では、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 が入力されます。更新後も既存のクエリが機能するようにするには、クエリを更新して 2 つの列のいずれかを選択します。たとえば、SQL クエリに次のステートメントがあるとします。

segments_product_bidding_category_level1

正しい列を指定する次のステートメントに置き換えます。

IFNULL(segments_product_category_level1, segments_product_bidding_category_level1)

2024 年 6 月 24 日以降に作成された転送構成では、常に新しい列が使用されます。非推奨の列はテーブル スキーマに残りますが、null が入力されます。