BigQuery Data Transfer Service のデータソースの変更ログ
このページでは、BigQuery Data Transfer Service のデータソース スキーマとスキーマ マッピングの変更について詳しく説明します。BigQuery Data Transfer Service コネクタに関して近く予定されている変更については、このページでデータソース（Google Ads API や Facebook Ads API など）または特定のテーブル名や値を検索してください。
Google 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 日
| 影響を受けるテーブル | 非推奨の列 | 新しい列 |
|---|---|---|
|
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 |
|
|
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 |
|
|
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 が入力されます。