サポート終了のお知らせ

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

API の非推奨と廃止日については、Google 広告デベロッパー ブログでもお知らせします。

バージョンの非推奨化

ディスプレイ＆ビデオ 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 広告デベロッパー ブログをご覧ください。

次の表に、発表済みのすべての機能の非推奨を示します。非推奨の開始日、非推奨の説明、推奨されるアクション、関連するドキュメントへのリンクが記載されています。

機能 初回発効日 説明
ターゲットの拡張 2023 年 3 月 25 日 ターゲットの拡張機能が最適化されたターゲティングに置き換えられました。2023 年 3 月 25 日から 2023 年 5 月上旬にかけて段階的に展開されました。ディスプレイ＆ビデオ 360 API と構造化データファイルの動作に関する関連する変更と推奨される対応については、ブログ投稿で発表されています。
手動トリガー 2023 年 5 月 17 日

タイムライン:

  • 2023 年 5 月 17 日: 手動トリガーを使用する広告申込情報のディスプレイ＆ビデオ 360 での配信が停止されます。この日以降に、有効な広告申込情報にリンクされている手動トリガーを有効にしても、広告申込情報では広告が配信されません。
  • 2023 年 8 月 1 日: DV360 API v1 と v2 の advertisers.manualTriggers サービス、DV360 API v1 の LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER 列挙値、DV360 API v1 の LineItemFlight.triggerId フィールドのサポートが終了します。この日以降、これらのサービスまたはフィールドに対するリクエストはエラーを返します。

おすすめの対処法:

  • 広告申込情報の配信の開始と停止に手動トリガーを使用することを直ちに停止します。
  • advertisers.manualTriggers サービスへのリクエストの作成を停止します。
  • 手動トリガーを使用して、すべての広告申込情報の flight.flightDateType フィールドと flight.triggerId フィールドを更新します。
Installed App と New Mobile Devices GoogleAudience タイプ 2023 年 5 月 20 日

タイムライン:

  • 2023 年 5 月 20 日: GoogleAudienceType が GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS または GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES の GoogleAudience リソースを、広告申込情報または広告掲載オーダーのオーディエンス ターゲティングに割り当てることができなくなります。これらのオーディエンスを広告申込情報のオーディエンス ターゲティングに割り当てるリクエストはエラーを返します。これには、作成された広告申込情報のオーディエンス ターゲティングに非推奨のオーディエンスが含まれる場合、advertisers.lineItems.duplicate リクエストと advertisers.lineItems.generateDefault リクエストが含まれます。
  • 2023 年 6 月 8 日: 影響を受けるオーディエンスは、すべての広告申込情報と広告掲載オーダーのターゲティング、およびすべての組み合わせオーディエンスから削除されます。これらのオーディエンスが削除されたときに広告を配信できなくなった広告申込情報は、一時停止されます。この日以降、これらのオーディエンスは googleAudiences サービスを使用して取得できなくなります。

推奨されるタスク:

  • 広告申込情報のターゲティングを今後更新する際は、影響を受けるオーディエンスの使用を直ちに停止することをおすすめします。
  • 影響を受けるすべてのユーザーを、既存の広告申込情報と広告掲載オーダーのターゲティングから削除します。オーディエンス ターゲティングの更新については、対象グループに関するガイドをご覧ください。
アクティビティに基づくタイプとフリークエンシー キャップ タイプ FirstAndThirdPartyAudience 2023 年 5 月 20 日

タイムライン:

  • 2023 年 5 月 20 日: AudienceType が ACTIVITY_BASED または FREQUENCY_CAP の FirstAndThirdPartyAudience リソースを、広告申込情報または広告掲載オーダーのオーディエンス ターゲティングに割り当てることができなくなります。これらのオーディエンスを広告申込情報のオーディエンス ターゲティングに割り当てるリクエストはエラーを返します。これには、作成された広告申込情報のオーディエンス ターゲティングに非推奨のオーディエンスが含まれる場合、advertisers.lineItems.duplicate リクエストと advertisers.lineItems.generateDefault リクエストが含まれます。
  • 2023 年 6 月 8 日: 影響を受けるオーディエンスは、すべての広告申込情報と広告掲載オーダーのターゲティング、およびすべての組み合わせオーディエンスから削除されます。これらのオーディエンスが削除されたときに広告を配信できなくなった広告申込情報は、一時停止されます。この日以降、これらのオーディエンスは firstAndThirdPartyAudiences サービスを使用して取得できなくなります。

推奨されるタスク:

  • 広告申込情報のターゲティングを今後更新する際は、影響を受けるオーディエンスの使用を直ちに停止することをおすすめします。
  • 影響を受けるすべてのユーザーを、既存の広告申込情報と広告掲載オーダーのターゲティングから削除します。オーディエンス ターゲティングの更新については、対象グループに関するガイドをご覧ください。
既存の API 割り当て上限 2023 年 5 月 30 日

2023 年 5 月 30 日に、既存の使用量上限は、次の処理を行うハイブリッド割り当て構造に置き換えられます。

  1. プロジェクトごとの 1 日あたりのリクエスト数の割り当てがなくなります。
  2. 対象となるメソッドに対して、広告主、プロジェクトごとの 1 分あたりのリクエスト数の割り当てを設定します。

この新しい上限により、API の使用の柔軟性が高まり、広告主間でリクエストを並列化できるようになります。この変更の詳細については、既存の割り当て上限に関するドキュメントをご覧ください。
LIST フィルタの異なるフィールドの制限間の OR 演算子の使用

 2023 年 6 月 21 日

2023 年 6 月 21 日より、LIST リクエストの filter パラメータで、異なるフィールドの制限の間に OR 論理演算子を使用できなくなります。

たとえば、フィルタ文字列 lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" で識別されるリソースは、次のフィルタ文字列を使用して 2 つの LIST リクエストで取得する必要があります。

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

論理演算子の制限について詳しくは、LIST リクエストをフィルタリングする方法に関するガイドをご覧ください。

サービスの中断を避けるため、2023 年 6 月 21 日より前に、既存の LIST 呼び出しの filter クエリ パラメータを確認し、OR 論理演算子が正しく使用されていることを確認してください。
budget.budget_segments.date_range.end_date フィールドと flight.dateRange.endDate フィールドでリスト リクエストをフィルタまたは並べ替える機能

初回有効期限が更新されました

 2023 年 6 月 21 日

2023 年 6 月 21 日をもって、budget.budget_segments.date_range.end_date と flight.dateRange.endDate は、それぞれ advertisers.insertionOrders.list と advertisers.lineItems.list filter と orderBy のクエリ パラメータで受け入れられなくなります。この日以降、filter と orderBy のクエリ パラメータでこれらのフィールドを使用するリクエストはエラーを返します。

サービスの中断を避けるため、2023 年 6 月 21 日までに、これらの 2 つのフィールドを使用するフィルタと順序付けのロジックをすべて削除してください。
advertisers.lineItems.list リクエストを 4 つの追加フィールドでフィルタする機能 2023 年 6 月 21 日

2023 年 6 月 21 日をもって、advertisers.lineItems.list では次のフィールドによるフィルタリングがサポートされなくなります。

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

サービスの中断を避けるため、2023 年 6 月 21 日より前に、これらの 4 つのフィールドを使用するすべてのフィルタ ロジックを削除してください。
成果ベースの購入 2023 年 8 月 1 日

2023 年 8 月 1 日に、結果ベースの購入を使用する広告申込情報（billableOutcome フィールドの値が BILLABLE_OUTCOME_PAY_PER_CLICK または BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION のもの）とその子広告申込情報はアーカイブされます。

この変更は、次のリクエストに影響します。
クリエイティブ リソースの publisherReviewStatuses フィールド 2024 年 6 月 26 日

2024 年 6 月 26 日より、publisherReviewStatuses フィールドは廃止され、Creative リソースの取得時に空になります。
YouTube とパートナーの広告申込情報のコンテンツ ターゲティング 2024 年 9 月 30 日

2024 年 9 月 30 日をもって、YouTube とパートナーの広告申込情報で、次のターゲティング タイプの値が廃止されます。

廃止されるターゲティング オプションは、既存の広告申込情報のターゲティングから自動的に削除されます。これらの値は、広告主レベルのターゲティングで引き続き使用できます。

サービスが中断されないようにするには、廃止日までに既存の YouTube とパートナーの広告申込情報からこのターゲティングを削除してください。
Oracle のファーストパーティ オーディエンスとサードパーティ オーディエンス 2024 年 9 月 30 日

2024 年 9 月 30 日に、Oracle の FirstAndThirdPartyAudience リソースソースの提供が終了します。サービス終了後は、これらのオーディエンスは既存のリソース ターゲティングと組み合わせオーディエンスから削除されます。広告申込情報のターゲットが廃止予定のオーディエンスのみである場合、または廃止予定のオーディエンスをネガティブ ターゲットに設定している場合、この更新により、その広告申込情報は自動的に一時停止されます。

サービスの中断を避けるため、サービス終了日までに、既存の広告申込情報のオーディエンス ターゲティングと組み合わせオーディエンスから Oracle オーディエンスを特定して削除してください。
一部の入札戦略の広告申込情報で最適化されたターゲティング 2024 年 9 月 30 日

2024 年 9 月 30 日をもって、一部の入札戦略を使用する LineItem リソースは、最適化されたターゲティングと互換性がなくなります。この変更により、targetingExpansion.enableOptimizedTargeting が True に設定され、bidStrategy.maximizeSpendAutoBid.performanceGoalType が BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA、BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN、BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED のいずれかに設定されている LineItem リソース、または bidStrategy.performanceGoalAutoBid.performanceGoalType が BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM に設定されている LineItem リソースは、targetingExpansion.enableOptimizedTargeting が False に設定されるように更新されます。

サービスの中断を避けるため、これらの入札戦略を使用している広告申込情報で最適化されたターゲティングが有効になっていないことを確認し、必要に応じて更新してください。
広告掲載オーダーの「掲載期間 - できるだけ早く」Pacing 2024 年 11 月 5 日

2024 年 11 月 5 日より、広告掲載オーダーの pacing フィールドを設定する際に、PACING_TYPE_ASAP は PACING_PERIOD_FLIGHT と互換性がなくなります。この構成の既存のすべての広告掲載オーダーの pacingType が PACING_TYPE_AHEAD に更新されます。

サービスの中断を避けるため、PACING_TYPE_ASAP と PACING_PERIOD_FLIGHT を使用して、既存の広告申込情報の pacing を更新します。
フリークエンシー キャップの期間が 30 日を超える 2025 年 2 月 28 日

2025 年 2 月 28 日:

  • LineItem、InsertionOrder、Campaign リソースを作成または更新して、timeUnit フィールドが TIME_UNIT_LIFETIME に設定されているか、timeUnit フィールドが TIME_UNIT_MONTH に設定され、timeUnitCount フィールドが 2 に設定されている FrequencyCap オブジェクトを使用するリクエストは、400 エラーを返します。
  • 広告申込情報、広告掲載オーダー、キャンペーンの構造化データファイルで、「フリークエンシー期間」列の値が「期間」または「月」で、「フリークエンシー数」列の値が「2」の場合、ファイルのアップロード時に作成または更新が失敗します。
  • 既存のキャンペーン、広告掲載オーダー、広告申込情報は、フリークエンシー キャップの期間が 30 日以下になるように更新されます。

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

  • フリークエンシー キャップの期間が 30 日を超える既存のキャンペーン、広告掲載オーダー、広告申込情報のリソースを、30 日以下に更新します。
  • ディスプレイ＆ビデオ 360 API または構造化データファイルを使用してキャンペーン、広告掲載オーダー、広告申込情報の各リソースを作成または更新する際に、フリークエンシー キャップの期間が 30 日を超えて設定されていないことを確認します。
固定入札を使用する広告申込情報の最適化されたターゲティング 2025 年 3 月 6 日

2025 年 3 月 6 日:

  • LineItem リソースを作成または更新して、BiddingStrategy フィールド fixedBid と TargetingExpansionConfig フィールド enableOptimizedTargeting を true に設定するリクエストは、400 エラーを返します。
  • 「入札戦略タイプ」列の値が「固定」で、「最適化されたターゲティング」列の値が「True」の広告申込情報構造化データファイルのエントリは、ファイルのアップロード時に作成または更新されません。
  • 固定入札を使用する既存の広告申込情報は、最適化されたターゲティングが無効になるよう更新されます。

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

  • 固定入札と最適化されたターゲティングの両方を使用する既存の広告申込情報リソースを更新します。
  • ディスプレイ＆ビデオ 360 API または構造化データファイルを使用して広告申込情報リソースを作成または更新する際に、統合で固定入札戦略と最適化されたターゲティングが設定されていないことを確認します。
firstAndThirdPartyAudiences.list のデフォルトのページサイズの更新 2025 年 3 月 6 日

2025 年 3 月 6 日に、firstAndThirdPartyAudiences.list リクエストのデフォルトのページサイズが 100 から 5,000 に更新されます。

サービスの中断を避けるため、統合を更新して、firstAndThirdPartyAudiences.list リクエストの pageSize クエリ パラメータを希望のページサイズに設定してください。
新しい sdfdownloadtasks.create パートナー/広告主の不一致エラー 2025 年 3 月 6 日

2025 年 3 月 6 日より、親エンティティ フィルタを使用して、設定された partnerId の子ではない広告主でフィルタする sdfdownloadtasks.create リクエストは、400 エラーを返すようになります。
SDF での YouTube リーチ広告申込情報の制限 2025 年 3 月 24 日

2025 年 3 月 24 日より、構造化データファイルで広告申込情報を作成または更新する際に、より広範な広告フォーマットを使用する必要があります。これは、次のことを意味します。

  • SDF v6 と v7 では、Subtype 値が「リーチ」の新しい広告申込情報ファイル エントリの作成はサポートされなくなりました。
  • Subtype 値が「リーチ」の SDF 広告申込情報ファイル内の新しいエントリでは、TrueView Video Ad Formats 列に「レスポンシブ」の値を使用する必要があります。Subtype 値が「リーチ」のエントリは、TrueView Video Ad Formats 列の値を更新できません。
  • SDF の広告申込情報ファイルで Subtype 値が「リーチ」の新しいエントリを作成する場合は、TrueView Video Ad Inventory Control 列に値を入力する必要があります。
カスタム入札アルゴリズムと Floodlight アクティビティの不一致 2025 年 4 月 1 日

2025 年 4 月 1 日:

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

  • カスタム入札アルゴリズムを割り当てる前または割り当てと同時に、関連する Floodlight アクティビティが広告申込情報に割り当てられていることを確認します。
  • 既存のカスタム入札アルゴリズムは、更新を試みる前にすべての広告申込情報から割り当てが解除されます。
自社オーディエンスの有効期間を無期限に設定 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 リソースに反映されます。
構造化データ ファイルの動画アクション キャンペーン 2025 年 4 月 22 日

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

サービスの中断を避けるため、動画アクション キャンペーンではなくデマンド ジェネレーションを使用するように統合を更新してください。
構造化データ ファイルのデマンド ジェネレーション広告申込情報で動画パートナーの広告在庫ソースが必要 2025 年 4 月 22 日

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

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

  • 統合を更新して、すべてのデマンド ジェネレーション広告申込情報のエントリに「動画パートナー」の値を含めます。
  • SDF v8.1 広告グループの列 Demand Gen Inventory Source Strategy と Demand Gen Enabled Inventory Sources を使用して、広告グループ単位でデマンド ジェネレーションのインベントリ ソースを管理できるように統合を更新します。
広告申込情報の構造化データファイルの [入札単価の乗数] 列 2025 年 5 月 1 日

2025 年 5 月 1 日以降、広告申込情報の構造化データファイルで「入札単価調整比」列を設定しようとすると、ファイル アップロード時にリソースの作成または更新が失敗します。
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 列に関連します。
広告申込情報で 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 を使用して既存の広告申込情報の地域ターゲティングを更新する前に、広告申込情報を更新して申告を行ってください。