アーカイブされた機能の非推奨

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 列に値を入力する必要があります。

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

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

サービスの中断を避けるため、統合を更新して、firstAndThirdPartyAudiences.list リクエストの pageSize クエリ パラメータを希望のページサイズに設定してください。

2025 年 3 月 6 日:

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

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

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

2025 年 2 月 28 日:

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

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

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

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

サービスの中断を避けるため、PACING_TYPE_ASAP と PACING_PERIOD_FLIGHT を使用して、既存の広告申込情報の pacing を更新します。

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 に設定されるように更新されます。

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

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

サービスの中断を避けるため、廃止日までに既存の広告申込情報のオーディエンス ターゲティングと組み合わせたオーディエンスから Oracle オーディエンスを特定して削除してください。

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
• CONTENT_RATING_TIER_FAMILIES
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION:
• SENSITIVE_CATEGORY_EMBEDDED_VIDEO
• SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

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

サービスの中断を避けるため、廃止日より前に、既存の YouTube とパートナーの広告申込情報からこのターゲティングを削除してください。

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

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 メソッドから返されなくなります。

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

• flight.triggerId
• targetedChannelId
• targetedNegativeKeywordListId
• warningMessages

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

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

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 つのフィールドを使用するフィルタと順序付けのロジックをすべて削除してください。

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

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

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

タイムライン:

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

推奨されるタスク:

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

タイムライン:

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

推奨されるタスク:

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

タイムライン:

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

おすすめの対処法:

• 広告申込情報の配信の開始と停止に手動トリガーを使用することを直ちに停止します。
• advertisers.manualTriggers サービスへのリクエストを停止します。
• 手動トリガーを使用して、すべての広告申込情報の flight.flightDateType フィールドと flight.triggerId フィールドを更新します。