サポート終了のお知らせ

このページでは、Display & Video 360 API のAPI バージョン個々の機能のサポート終了日と廃止日を示します。

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

バージョンの非推奨

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

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

以下の表に、既存のコア ディスプレイ&ビデオ 360 API のバージョン、リリース日、非推奨と廃止の日付(発表されている場合)を示します。

API バージョン リリース日 サポート終了日 廃止日 移行ガイド
v3 2023 年 10 月 31 日
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 日

Timeline:

  • 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 フィールドを更新します。
インストール済みのアプリと新しいモバイル デバイスのGoogleAudience タイプ 2023 年 5 月 20 日

Timeline:

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

推奨されるタスク:

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

Timeline:

  • 2023 年 5 月 20 日: AudienceTypeACTIVITY_BASED または FREQUENCY_CAPFirstAndThirdPartyAudience リソースを、広告申込情報または広告掲載オーダーのオーディエンス ターゲティングに割り当てることができなくなります。これらのオーディエンスを広告申込情報のオーディエンス ターゲティングに割り当てるリクエストはエラーを返します。これには、作成する広告申込情報のオーディエンス ターゲティングに非推奨のオーディエンスが含まれる場合の 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 日をもって、advertisers.insertionOrders.listadvertisers.lineItems.listfilterorderBy クエリ パラメータで、budget.budget_segments.date_range.end_dateflight.dateRange.endDate のフィールドが使用できなくなります。この日以降、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.enableOptimizedTargetingTrue に設定され、bidStrategy.maximizeSpendAutoBid.performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVABIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TENBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED に設定されているか、bidStrategy.performanceGoalAutoBid.performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM に設定されている LineItem リソースは更新され、targetingExpansion.enableOptimizedTargetingFalse に設定されます。

サービスの中断を避けるため、これらの入札戦略を使用している広告申込情報を更新し、最適化されたターゲティングが有効になっていないことを確認してください。

広告掲載オーダーの掲載期間 - できるだけ早く Pacing 2024 年 11 月 5 日

2024 年 11 月 5 日をもって、広告掲載オーダーの pacing フィールドを設定する場合、PACING_TYPE_ASAPPACING_PERIOD_FLIGHT に対応しなくなります。この構成の既存の広告掲載オーダーの pacingType はすべて PACING_TYPE_AHEAD に更新されます。

サービスの中断を避けるため、PACING_TYPE_ASAPPACING_PERIOD_FLIGHT を使用して、既存の広告掲載オーダーの pacing を更新します。

フリークエンシー キャップの期間が 30 日を超えている 2025 年 2 月 28 日

2025 年 2 月 28 日:

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

サービスの中断を避けるため、次の点にご注意ください。

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

2025 年 3 月 6 日:

  • LineItem リソースを作成または更新するリクエストで、BiddingStrategy フィールドを fixedBid に、TargetingExpansionConfig フィールドを enableOptimizedTargeting に設定すると、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 エラーを返すようになります。

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

2025 年 4 月 1 日:

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

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

自社オーディエンスの有効期間は無制限 2025 年 4 月 7 日

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

サービスの中断を避けるため、次の点にご注意ください。

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

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

広告申込情報の構造化データファイルの [入札単価調整額] 列 2025 年 5 月 1 日

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