BigQuery Data Transfer Service のデータソースの変更ログ
このページでは、BigQuery Data Transfer Service のデータソース スキーマとスキーマ マッピングの変更について詳しく説明します。BigQuery Data Transfer Service コネクタの今後の変更については、このページでデータソース（Google Ads API や Facebook Ads API など）または特定のテーブル名や値を検索してください。
Google Ads API
BigQuery Data Transfer Service for Google Ads は、新しい列をサポートし、また新しい Google Ads API バージョンによる変更に対応するため、定期的に更新されます。BigQuery Data Transfer Service for Google Ads コネクタは、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 日
- 配達日: 未定
Table: p_ads_Campaign_customer_id
| 影響を受ける列 | 古い値（v16） | 新しい値（v18） |
|---|---|---|
| campaign_advertising_channel_type | DISCOVERY | DEMAND_GEN |
Table: 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 |
Table: 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 が入力されます。