サポート終了のお知らせ

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 フィールドを更新します。

Timeline:

• 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 サービスを使用して取得できなくなります。

推奨される作業:

• 広告申込情報のターゲティングを今後更新する際は、影響を受けるオーディエンスの使用を直ちに停止することをおすすめします。
• 既存の広告申込情報と広告掲載オーダーのターゲティングから、影響を受けるすべてのオーディエンスを削除します。オーディエンス ターゲティングの更新について詳しくは、ターゲット オーディエンス ガイドをご覧ください。

Timeline:

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

推奨される作業:

• 広告申込情報のターゲティングを今後更新する際は、影響を受けるオーディエンスの使用を直ちに停止することをおすすめします。
• 既存の広告申込情報と広告掲載オーダーのターゲティングから、影響を受けるすべてのオーディエンスを削除します。オーディエンス ターゲティングの更新について詳しくは、ターゲット オーディエンス ガイドをご覧ください。

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

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

この新しい制限により、API をより柔軟に使用できるようになり、広告主間でのリクエストの並列処理が可能になります。この変更の詳細については、既存の割り当て上限に関するドキュメントをご覧ください。

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 論理演算子が正しく使用されていることをご確認ください。

最初の発効日を更新

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

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

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

• flight.triggerId
• targetedChannelId
• targetedNegativeKeywordListId
• warningMessages

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

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 メソッドによって返されなくなります。

2024 年 6 月 26 日より、publisherReviewStatuses フィールドは廃止され、Creative リソースを取得する際に空になります。

2024 年 9 月 30 日、特定された YouTube とパートナーの広告申込情報:

• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION:
• CONTENT_RATING_TIER_UNRATED
• CONTENT_RATING_TIER_GENERAL
• CONTENT_RATING_TIER_PARENTAL_GUIDANCE
• CONTENT_RATING_TIER_TEENS
• CONTENT_RATING_TIER_MATURE
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION:
• SENSITIVE_CATEGORY_EMBEDDED_VIDEO
• SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

廃止されるターゲティング オプションは、既存の広告申込情報のターゲティングから自動的に削除されます。

サービスが中断されないようにするには、既存の YouTube からこのターゲット設定を削除してください。パートナーの広告申込情報が廃止日より前になっています。

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

サービスが中断されないようにするには、廃止日までに、既存の広告申込情報のオーディエンス ターゲティングと統合オーディエンスから Oracle オーディエンスを特定して削除してください。

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、または bidStrategy.performanceGoalAutoBid.performanceGoalType が BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM に設定されている LineItem リソースは、targetingExpansion.enableOptimizedTargeting が False に更新されます。

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

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

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