サポート終了のお知らせ

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

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

バージョンの非推奨化

Display & Video 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 月上旬に段階的にリリースされました。Display & 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 列挙値、DV360 API v1 の LineItemFlight.triggerId フィールドが廃止されます。この日以降、これらのサービスまたはこれらのフィールドに対してリクエストを行うと、エラーが返されます。 おすすめの対処法: 手動トリガーによる広告申込情報の配信の開始と停止は直ちに停止します。 advertisers.manualTriggers サービスに対するリクエストを停止します。 手動トリガーを使用して、すべての広告申込情報の flight.flightDateType フィールドと flight.triggerId フィールドを更新します。
[インストール済みアプリと新しいモバイル デバイス] GoogleAudience の種類	2023 年 5 月 20 日	Timeline: 2023 年 5 月 20 日: 広告申込情報または広告掲載オーダーのオーディエンス ターゲティングに、GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS または GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES の GoogleAudienceType の GoogleAudience リソースを割り当てることができなくなります。広告申込情報でこれらのオーディエンスを広告申込情報のオーディエンス ターゲティングに割り当てると、エラーが返されます。これには、作成した広告申込情報のオーディエンス ターゲティングにサポート終了済みのオーディエンスが含まれる場合、advertisers.lineItems.duplicate リクエストと advertisers.lineItems.generateDefault リクエストが含まれます。 2023 年 6 月 8 日: 影響を受けるオーディエンスは、すべての広告申込情報と広告掲載オーダーのターゲティング、およびすべての統合オーディエンスから削除されます。これらのオーディエンスが削除されたときに広告申込情報から広告を配信できない場合、その広告申込情報は一時停止されます。この日以降は、これらのオーディエンスを googleAudiences サービスを使用して取得することもできなくなります。 推奨されるタスク: 広告申込情報のターゲティングを今後変更する場合は、影響を受けるオーディエンスの使用を直ちに停止することをおすすめします。 影響を受けるすべてのオーディエンスを既存の広告申込情報と広告掲載オーダーのターゲティングから削除します。オーディエンス ターゲティングの更新方法については、ターゲット オーディエンスに関するガイドをご覧ください。
アクティビティ ベースとフリークエンシー キャップの FirstAndThirdPartyAudience タイプ	2023 年 5 月 20 日	Timeline: 2023 年 5 月 20 日: 広告申込情報または広告掲載オーダーのオーディエンス ターゲティングに、ACTIVITY_BASED または FREQUENCY_CAP の AudienceType の FirstAndThirdPartyAudience リソースを割り当てることができなくなります。広告申込情報でこれらのオーディエンスを広告申込情報のオーディエンス ターゲティングに割り当てると、エラーが返されます。これには、作成した広告申込情報のオーディエンス ターゲティングにサポート終了済みのオーディエンスが含まれる場合、advertisers.lineItems.duplicate リクエストと advertisers.lineItems.generateDefault リクエストが含まれます。 2023 年 6 月 8 日: 影響を受けるオーディエンスは、すべての広告申込情報と広告掲載オーダーのターゲティング、およびすべての統合オーディエンスから削除されます。これらのオーディエンスが削除されたときに広告申込情報から広告を配信できない場合、その広告申込情報は一時停止されます。この日以降は、これらのオーディエンスを firstAndThirdPartyAudiences サービスを使用して取得することもできなくなります。 推奨されるタスク: 広告申込情報のターゲティングを今後変更する場合は、影響を受けるオーディエンスの使用を直ちに停止することをおすすめします。 影響を受けるすべてのオーディエンスを既存の広告申込情報と広告掲載オーダーのターゲティングから削除します。オーディエンス ターゲティングの更新方法については、ターゲット オーディエンスに関するガイドをご覧ください。
既存の API 割り当て上限	2023 年 5 月 30 日	2023 年 5 月 30 日に、既存の使用量上限は、以下を行うハイブリッド割り当て構造に置き換えられます。 プロジェクトごとの 1 日あたりのリクエスト数の割り当てがなくなります。 対象となるメソッドに、1 プロジェクト、1 広告主、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 で定義）を使用している広告掲載オーダーと、その子広告申込情報はアーカイブされます。 この変更は以下のリクエストに影響します。 成果ベースの購入を使用する広告掲載オーダーを advertisers.insertionOrders.create で作成しようとすると、400 エラーが返されます advertisers.lineItems.create、advertisers.lineItems.duplicate、advertisers.lineItems.generateDefault を使用して、成果ベースの購入を使用している広告掲載オーダーに広告申込情報を作成しようとすると、400 エラーが返されます。 アーカイブされたリソースはデフォルトでは LIST リクエストに含まれないため、影響を受けるリソースはデフォルトで advertisers.insertionOrders.list メソッドと advertisers.lineItems.list メソッドで返されなくなります。