サポート終了のお知らせ

このページには、API のサポート終了日と廃止日が記載されています。 バージョン個々の機能 ディスプレイとVideo 360 API。

API のサポート終了と廃止日は、 Google 広告デベロッパー ブログ

バージョンの非推奨化

ディスプレイとVideo 360 API バージョンは定期的にリリース、サポート終了、廃止されます。これらの 各ステップは次のように定義されます。

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

以下の表は、ディスプレイ キャンペーンとVideo 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 日から 5 月上旬まで段階的に展開され、最適化されたターゲティングに置き換えられました。ディスプレイ キャンペーンとVideo 360 API と構造化データファイルの動作、推奨される対応については、ブログ投稿で発表されています。
手動トリガー 2023 年 5 月 17 日

Timeline:

  • 2023 年 5 月 17 日: 手動トリガーを使用している広告申込情報は、ディスプレイと動画 360。この日以降に有効な広告申込情報にリンクされている手動トリガーを有効にすると、その広告申込情報では広告が配信されなくなります。
  • 2023 年 8 月 1 日: ディスプレイ&ビデオ 360 API v1 および v2 の advertisers.manualTriggers サービス、ディスプレイ&ビデオ 360 API v1 の LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER 列挙値、ディスプレイ&ビデオ 360 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.list および advertisers.lineItems.list filter および orderBy クエリ パラメータでは、それぞれ budget.budget_segments.date_range.end_dateflight.dateRange.endDate が使用できなくなります。この日以降、filter クエリ パラメータと orderBy クエリ パラメータでこれらのフィールドを使用するリクエストではエラーが返されます。

サービスの中断を避けるため、2023 年 6 月 21 日までに、これら 2 つのフィールドを使用するフィルタと並べ替えロジックをすべて削除してください。

4 つの追加フィールドで advertisers.lineItems.list リクエストをフィルタできるようになりました 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 に対応しなくなります。この設定の既存のすべての広告掲載オーダーの pacingTypePACING_TYPE_AHEAD に更新されます。

サービスが中断されないように、PACING_TYPE_ASAPPACING_PERIOD_FLIGHT を使用して既存の広告掲載オーダーの pacing を更新します。