サポート終了のお知らせ

このページでは、ディスプレイ&ビデオ 360 API の API バージョン個々の機能のサポート終了日と廃止日を示します。

API の非推奨と廃止日については、Google Ads Developer Blog でもお知らせします。

バージョンの非推奨化

ディスプレイ&ビデオ 360 API のバージョンは定期的にリリース、非推奨、廃止されます。これらのステップは次のように定義されます。

  • リリース: バージョンがアルファ版またはベータ版のステータスを終了し、安定版と見なされます。このバージョンに新機能が追加される可能性はあります。
  • サポート終了: バージョンが廃止され、サポート終了日(廃止日)が発表されます。サポート終了日までに、新しいバージョンに移行する必要があります。このバージョンでは、機能の追加はリリースされなくなります。
  • 廃止: このバージョンはサポートされなくなります。このバージョンに対して行われたリクエストはエラーを返します。

この表には、既存のすべてのコア ディスプレイ&ビデオ 360 API バージョン、リリース日、サポート終了日と廃止日(発表されている場合)が一覧表示されます。

API バージョン リリース日 サポート終了日 廃止日 移行ガイド
v4 2025 年 3 月 27 日
v3 2023 年 10 月 31 日 2025 年 4 月 2 日 2025 年 10 月 7 日 v3 から v4 に移行する
v2 2022 年 12 月 6 日 2024 年 2 月 15 日 2024 年 9 月 3 日 v2 から v3 への移行
v1 2020 年 3 月 9 日 2023 年 3 月 13 日 2023 年 9 月 14 日 v1 から v2 への移行

機能の非推奨

今後の重要な機能の非推奨化に関するお知らせについては、Google 広告デベロッパー ブログをご覧ください。

次の表に、ライブ バージョンに影響する発表済みの機能の非推奨をすべて示します。最初の有効日、非推奨の説明、推奨されるアクション、関連ドキュメントへのリンクが記載されています。

機能 初回発効日 説明
ディスプレイ&ビデオ 360 API と構造化データファイルでの広告掲載オーダーとキャンペーンのターゲティング管理 2026 年 2 月 23 日

2026 年 2 月 23 日に、ディスプレイ&ビデオ 360 で広告掲載オーダーとキャンペーンのターゲティングが廃止されます。この変更に合わせて、ディスプレイ&ビデオ 360 API と構造化データファイル(SDF)が変更されます。ディスプレイ&ビデオ 360 API では、メソッドのサブセットが廃止され、呼び出されるとエラーが返されます。SDF では、[広告掲載オーダー] ファイルと [キャンペーン] ファイルのターゲティング列は、ダウンロード時に自動入力されなくなり、アップロード時に空白のままにしておく必要があります。広告申込情報の作成時に、ターゲティングを広告申込情報に直接割り当てることをおすすめします。

次の Display & Video 360 API メソッドは、呼び出されると 404 エラーを返します。

次の列に値が割り当てられているキャンペーンの SDF エントリは、アップロードに失敗します。

  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Environment Targeting

次の列に値が割り当てられている挿入オーダーの SDF エントリは、アップロード時に失敗します。

  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Proximity Targeting
  • Proximity Location List Targeting
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Device Targeting - Include
  • Device Targeting - Exclude
  • Browser Targeting - Include
  • Browser Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Channel Targeting - Include
  • Channel Targeting - Exclude
  • Site Targeting - Include
  • Site Targeting - Exclude
  • App Targeting - Include
  • App Targeting - Exclude
  • App Collection Targeting - Include
  • App Collection Targeting - Exclude
  • Category Targeting - Include
  • Category Targeting - Exclude
  • Content Genre Targeting - Include
  • Content Genre Targeting - Exclude
  • Keyword Targeting - Include
  • Keyword Targeting - Exclude
  • Keyword List Targeting - Exclude
  • Audience Targeting - Include
  • Audience Targeting - Exclude
  • Affinity & In Market Targeting - Include
  • Affinity & In Market Targeting - Exclude
  • Custom List Targeting
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Daypart Targeting
  • Daypart Targeting Time Zone
  • Environment Targeting
  • Viewability Omid Targeting Enabled
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Position Targeting - Audio Position In Content
  • Video Player Size Targeting
  • Content Duration Targeting
  • Content Stream Type Targeting
  • Audio Content Type Targeting
  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Connection Speed Targeting
  • Carrier Targeting - Include
  • Carrier Targeting - Exclude
広告申込情報で EU の政治広告を配信するかどうかを申告する 2025 年 9 月 8 日

2025 年 9 月 8 日より、ディスプレイ&ビデオ 360 API または SDF を使用して新しい広告申込情報を作成する際に、欧州連合の政治広告を配信するかどうかを申告する必要があります。これらの宣言は次の方法で行うことができます。

親広告主に EU の政治広告を配信する広告申込情報が含まれない場合は、ディスプレイ&ビデオ 360 API の Advertiser リソースの containsEuPoliticalAds フィールドを使用して、広告主レベルで申告できます。このフィールドが DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING に設定されている場合、広告主のすべての新しい広告申込情報には、特に指定がない限り同じ値が割り当てられます。また、広告主のすべての既存の広告申込情報には、値がまだ設定されていない場合は同じ値が使用されるように更新されます。項目の宣言は、作成後いつでも UI、API、SDF を使用して更新できます。

広告主レベルで申告できない場合、または広告主の配下で EU の政治広告が配信される可能性があると申告した場合は、サービスの中断を避けるため、2025 年 9 月 8 日までにディスプレイ&ビデオ 360 API と SDF の統合を更新してください。

  • advertisers.lineItems.create リクエストを行うときに、新しい LineItem リソースの containsEuPoliticalAds フィールドを設定します。
  • advertisers.lineItems.duplicate リクエストと advertisers.lineItems.generateDefault リクエストの本文で containsEuPoliticalAds フィールドを設定します。
  • 構造化データファイル バージョン 9 を使用するように移行し、アップロード時に新しい広告申込情報の Contains EU Political Ads 列を Yes または No に設定します。詳しい手順については、v9 移行ガイドをご覧ください。
  • ディスプレイ&ビデオ 360 API または SDF を使用して既存の広告申込情報の地域ターゲティングを更新する前に、広告申込情報を更新して申告を行います。
YouTube とパートナーの広告申込情報のコンテンツ カテゴリの設定 2025 年 6 月 12 日

2025 年 6 月 12 日より、ブランド適合性エクスペリエンスの更新の一環として、個々の YouTube とパートナーの広告申込情報のコンテンツ カテゴリ設定を変更できなくなります。コンテンツ カテゴリの設定は、広告主レベルでのみ管理されるようになります。この変更に対応するため、ディスプレイ&ビデオ 360 API と構造化データファイルに次の変更が加えられます。

サービスの中断を避けるため、以下の点にご注意ください。
  • API で YouTube とパートナーの広告申込情報を確認する際は、contentCategory フィールドの代わりに effectiveContentCategory フィールドを取得します。
  • SDF 広告申込情報のエントリを更新する際に、TrueView Content Filter 列の変更を停止します。新しい広告申込情報を作成する場合は、この列を空白のままにします。
広告掲載オーダーの最適化による広告申込情報の予算の更新 2025 年 6 月 12 日

2025 年 6 月 12 日より、親広告掲載オーダーが自動入札戦略を使用して最適化するように設定されている広告申込情報の予算設定を更新できなくなります。

サービスの中断を避けるため:
構造化データファイルのサイト制限 2025 年 6 月 12 日

2025 年 6 月 12 日より、SDF エントリでターゲットに設定された URL に関する既存の制限が解除されます。この制限により、新しいサイトが対象に含まれないようになっていました。代わりに、SDF は API と UI の動作を一致させ、URL が正しい形式であれば、URL のターゲティングを許可します。

これは、広告掲載オーダー ファイルと広告申込情報ファイルの Site Targeting - Include 列と Site Targeting - Exclude 列に関連します。
広告申込情報の構造化データファイルの [入札単価の乗数] 列 2025 年 5 月 1 日

2025 年 5 月 1 日以降、広告申込情報の構造化データファイルで「入札単価調整比」列を設定しようとすると、ファイル アップロード時にリソースの作成または更新が失敗します。

構造化データ ファイルのデマンド ジェネレーション広告申込情報で動画パートナーの広告在庫ソースが必要 2025 年 4 月 22 日

2025 年 4 月 22 日より、Type 列の値が「デマンド ジェネレーション」の広告申込情報エントリの TrueView Inventory Source Targeting 列に「動画パートナー」という値を含める必要があります。この適用が開始されると、既存の広告申込情報に値がバックフィルされ、新しい構造化データファイルをダウンロードする際に値が含まれるようになります。

サービスの中断を避けるには:

  • 統合を更新して、すべてのデマンド ジェネレーション広告申込情報の項目に「動画パートナー」の値を含めます。
  • SDF v8.1 広告グループの列 Demand Gen Inventory Source StrategyDemand Gen Enabled Inventory Sources を使用して、広告グループ単位でデマンド ジェネレーションのインベントリ ソースを管理するように統合を更新します。
構造化データ ファイルの動画アクション キャンペーン 2025 年 4 月 22 日

2025 年 4 月 22 日以降、動画アクション キャンペーンの広告申込情報は、構造化データファイルを使用して作成できなくなります。これは、デマンド ジェネレーションにアップグレードされるためです。Subtype 列の値が「Action」で、Type 列の値が「TrueView」の広告申込情報エントリをアップロードしようとすると、失敗します。

サービスの中断を避けるため、動画アクション キャンペーンではなくデマンド ジェネレーションを使用するように統合を更新してください。

自社オーディエンスの有効期間を無期限に設定 2025 年 4 月 7 日

2025 年 4 月 7 日以降、FirstAndThirdPartyAudience リソースではオーディエンス メンバーシップの期間を無期限に設定できなくなります。membershipDurationDays フィールドの値を 10,000 に設定する firstAndThirdPartyAudiences.create リクエストと firstAndThirdPartyAudiences.patch リクエストは、400 エラーを返します。membershipDurationDays フィールドの値が 10,000 の既存のオーディエンスは 540 に更新され、新しいメンバーシップ期間が既存のメンバーシップに遡及適用されます。これにより、540 日以上経過したメンバーシップはすべて期限切れになります。

サービスの中断を避けるには:

  • 統合によって、新規または既存のオーディエンスの membershipDurationDays フィールドの値が 10,000 に設定されていないことを確認します。
  • firstAndThirdPartyAudiences.editCustomerMatchMembers を使用して、既存のカスタマー マッチ オーディエンスのメンバーシップを更新します。
  • オーディエンスのリストサイズが意図せず小さくならないように、カスタマー マッチ オーディエンスのメンバーシップを定期的に更新してください。

v4 では、この変更は FirstPartyAndPartnerAudience リソースに反映されます。

カスタム入札アルゴリズムと Floodlight アクティビティの不一致 2025 年 4 月 1 日

2025 年 4 月 1 日:

サービスの中断を避けるため、インテグレーションを次のように更新してください。

  • カスタム入札アルゴリズムを割り当てる前または割り当てと同時に、関連する Floodlight アクティビティが広告申込情報に割り当てられていることを確認します。
  • 既存のカスタム入札アルゴリズムは、更新を試みる前にすべての広告申込情報から割り当てが解除されます。

以前の機能の非推奨化

ディスプレイ&ビデオ 360 API のサポート終了バージョンに影響する廃止の発表については、廃止のアーカイブをご覧ください。