Announced Deprecations

Timeline:

• May 17, 2023: Line items using manual triggers will stop serving in Display & Video 360. If you activate a manual trigger linked to an active line item after this date, the line item won't serve ads.
• August 1, 2023: advertisers.manualTriggers service in DV360 API v1 and v2, LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER enum value in DV360 API v1, and the LineItemFlight.triggerId field in DV360 API v1 will sunset. After this date, requests made to these services or to these fields will return an error.

Recommended actions:

• Immediately stop using manual triggers to start and stop line item serving.
• Stop making requests to the advertisers.manualTriggers service.
• Update the flight.flightDateType and flight.triggerId fields for all line items using manual triggers.

Timeline:

• May 20, 2023: You will no longer be able to assign GoogleAudience resources with a GoogleAudienceType of GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS or GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES to line item or insertion order audience targeting. Requests assigning these audiences to a line item's audience targeting will return an error. This includes advertisers.lineItems.duplicate and advertisers.lineItems.generateDefault requests, if the created line item would include deprecated audiences in its audience targeting.
• June 8, 2023: Impacted audiences will be removed from all line item and insertion order targeting and from all combined audiences. If a line item is not able to serve ads when these audiences are removed, they will be paused. On this date, these audiences will also no longer be retrievable using the googleAudiences service.

Recommended Tasks:

• We recommend that you immediately stop using impacted audiences when making future updates to your line item targeting.
• Remove all impacted audiences from existing line item and insertion order targeting. Read about updating audience targeting in our Target Audiences guide.

Timeline:

• May 20, 2023: You will no longer be able to assign FirstAndThirdPartyAudience resources with a AudienceType of ACTIVITY_BASED or FREQUENCY_CAP to line item or insertion order audience targeting. Requests assigning these audiences to a line item's audience targeting will return an error. This includes advertisers.lineItems.duplicate and advertisers.lineItems.generateDefault requests, if the created line item would include deprecated audiences in its audience targeting.
• June 8, 2023: Impacted audiences will be removed from all line item and insertion order targeting and from all combined audiences. If a line item is not able to serve ads when these audiences are removed, they will be paused. On this date, these audiences will also no longer be retrievable using the firstAndThirdPartyAudiences service.

Recommended Tasks:

• We recommend that you immediately stop using impacted audiences when making future updates to your line item targeting.
• Remove all impacted audiences from existing line item and insertion order targeting. Read about updating audience targeting in our Target Audiences guide.

On May 30, 2023, existing usage limits will be replaced with a hybrid quota structure that does the following:

1. Eliminates the requests per day per project quota.
2. Institutes a requests per minute per advertiser per project quota for qualifying methods.

These new limits will allow greater flexibility in API usage and enable parallelization of requests across advertisers. Details of this change are in our existing quota limit documentation.

On June 21, 2023, LIST request filter parameters will no longer allow OR logical operators to be used between restrictions of different fields.

For example, resources identified with filter string lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" must instead be retrieved using two LIST requests with the following filter strings:

• lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
• insertionOrderId="123"

Reference our how-to guide on filtering LIST requests for more details on the restrictions of logical operators.

Review the filter query parameters of all your existing LIST calls and verify that they are using the OR logical operator correctly before June 21, 2023 to avoid an interruption of service.

Initial Effective Date updated

On June 21, 2023, budget.budget_segments.date_range.end_date and flight.dateRange.endDate will no longer be accepted fields in advertisers.insertionOrders.list and advertisers.lineItems.list filter and orderBy query parameters, respectively. After this date, requests using these fields in the filter and orderBy query parameters will return an error.

Remove all filter and order logic using these two fields before June 21, 2023 to avoid an interruption of service.

On June 21, 2023, advertisers.lineItems.list will no longer support filtering by the following fields:

• flight.triggerId
• targetedChannelId
• targetedNegativeKeywordListId
• warningMessages

Remove all filter logic using these four fields before June 21, 2023 to avoid an interruption of service.

On August 1, 2023, insertion orders using outcome based buying, defined by a billableOutcome field value of BILLABLE_OUTCOME_PAY_PER_CLICK or BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, and their child line items will be archived.

This change will affect the following requests:

• Attempting to use advertisers.insertionOrders.create to create an insertion order using outcome based buying will return a 400 error
• Attempting to use advertisers.lineItems.create, advertisers.lineItems.duplicate, or advertisers.lineItems.generateDefault to create a line item under an insertion order using outcome based buying will return a 400 error
• Given that archived resources are not included in LIST requests by default, impacted resources will no longer be returned by advertisers.insertionOrders.list and advertisers.lineItems.list methods by default.

Starting on June 26, 2024, the publisherReviewStatuses field will sunset and will be empty when retrieving Creative resources.

On September 30, 2024, the following values for the identified targeting types will sunset for YouTube & Partners line items:

• 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

Sunset targeting options will automatically be removed from existing line item targeting. These values will still be available for use in advertiser-level targeting.

To avoid any interruption of service, remove this targeting from any existing YouTube & Partners line items before the sunset date.

On September 30, 2024, FirstAndThirdPartyAudience resources sources from Oracle will sunset. Upon sunset, these audiences will be removed from any existing resource targeting and combined audience. If a line item either only targets sunset audiences or negatively targets any sunset audiences, this update will automatically pause that line item.

To avoid any interruption of service, identify and remove any Oracle audiences from existing line item audience targeting and combined audiences before the sunset date.

On September 30, 2024, LineItem resources using a subset of bid strategies will no longer be compatible with optimized targeting. With this change, LineItem resources with targetingExpansion.enableOptimizedTargeting set to True and bidStrategy.maximizeSpendAutoBid.performanceGoalType set to BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN, or BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED or bidStrategy.performanceGoalAutoBid.performanceGoalType set to BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM will be updated to set targetingExpansion.enableOptimizedTargeting to False.

To avoid any interruption of service, update and verify that your line items using these bid strategies don't have optimized targeting turned on.

On November 5, 2024, PACING_TYPE_ASAP will no longer be compatible with PACING_PERIOD_FLIGHT when setting the insertion order pacing field. The pacingType for all existing insertion orders with this configuration will be updated to PACING_TYPE_AHEAD.

To avoid any interruption of service, update the pacing of any existing insertion orders using PACING_TYPE_ASAP and PACING_PERIOD_FLIGHT.

On February 28, 2025:

• Requests creating or updating LineItem, InsertionOrder, and Campaign resources to use a FrequencyCap object with either a timeUnit field set to TIME_UNIT_LIFETIME or a timeUnit field set to TIME_UNIT_MONTH and a timeUnitCount field set to 2 will return a 400 error.
• Entries in Line Item, Insertion Order, and Campaign Structured Data Files with either the "Frequency Period" column value of "Lifetime" or the "Frequency Period" column value of "Months" and "Frequency Amount" column value of "2" will fail to create or update on file upload.
• Existing campaigns, insertion orders, and line items will be updated to use a frequency cap period 30 days or less.

To avoid any interruption of service:

• Update existing campaign, insertion order, and line item resources that use a frequency cap period over 30 days to be 30 days or less.
• Verify that your integration is not setting a frequency cap period over 30 days when creating or updating campaign, insertion order, or line item resources using Display & Video 360 API or Structured Data Files.

On March 6, 2025:

• Requests creating or updating LineItem resources to set the BiddingStrategy field fixedBid and the TargetingExpansionConfig field enableOptimizedTargeting to true will return a 400 error.
• Entries in Line Item Structured Data Files with the "Bid Strategy Type" column value of "Fixed" and the "Optimized Targeting" column value of "True" will fail to create or update on file upload.
• Existing line items using fixed bidding will be updated to turn off optimized targeting.

To avoid any interruption of service:

• Update existing line item resources that use both fixed bidding and optimized targeting.
• Verify that your integration is not setting a fixed bidding strategy and optimized targeting when creating or updating line item resources using Display & Video 360 API or Structured Data Files.

On March 6, 2025, the default page size for firstAndThirdPartyAudiences.list requests will be updated from 100 to 5000.

To avoid an interruption of service, update your integration to set the pageSize query parameter of your firstAndThirdPartyAudiences.list requests to your preferred page size.

On March 6, 2025, sdfdownloadtasks.create requests that use a parent entity filter to filter by advertisers that are not children of the set partnerId will start to return a 400 error.

On March 24, 2025, Structured Data Files will require the use of more expansive ad formats when creating or updating line items. This means the following:

• SDF v6 and v7 no longer support creating new Line Item file entries with a Subtype value "Reach".
• New entries in SDF Line Item files with Subtype value "Reach" must use a "Responsive" value in the TrueView Video Ad Formats column. Existing entries with Subtype value "Reach" can't update their TrueView Video Ad Formats column value.
• New entries in SDF Line Item files with Subtype value "Reach" requires population of the TrueView Video Ad Inventory Control column.

On April 1, 2025:

• advertisers.lineItems.create requests attempting to set the floodlightActivityConfigs field of the ConversionCountingConfig object and the customBiddingAlgorithmId field of MaximizeSpendBidStrategy or PerformanceGoalBidStrategy objects that don't use matching floodlight activities will return a 400 error.
• advertisers.lineItems.patch requests attempting to update the floodlightActivityConfigs field of the ConversionCountingConfig object while the customBiddingAlgorithmId field of MaximizeSpendBidStrategy or PerformanceGoalBidStrategy objects is set will return a 400 error.
• Entries in Line Item Structured Data Files that attempt to update the "Conversion Floodlight Activity Ids" column when the "Algorithm Id" column is set will fail to update on file upload.
• customBiddingAlgorithms.patch, customBiddingAlgorithms.rules.create, customBiddingAlgorithms.scripts.create requests for CustomBiddingAlgorithm resources that are assigned to a line item will return an error.

To avoid any interruption of service, update your integration to:

• Verify that the relevant floodlight activities are assigned to a line item before or at the same time as the assigning of a custom bidding algorithm.
• Existing custom bidding algorithms are unassigned from all line items before attempting to be updated.

On April 7, 2025, FirstAndThirdPartyAudience resources will no longer allow infinite audience membership duration. firstAndThirdPartyAudiences.create and firstAndThirdPartyAudiences.patch requests setting the membershipDurationDays field value to 10,000 will return a 400 error. Existing audiences with a membershipDurationDays field value of 10,000 will be updated to 540 and the new membership duration will be retroactively applied to existing memberships. This will expire all memberships older than 540 days.

To avoid any interruption of service:

• Verify that your integration is not setting the membershipDurationDays field value of new or existing audiences to 10,000.
• Refresh the memberships of your existing Customer Match audiences using firstAndThirdPartyAudiences.editCustomerMatchMembers.
• Regularly refresh your Customer Match audience memberships to make sure that the list size of your audiences don't get smaller unintentionally.

In v4, this change is reflected in FirstPartyAndPartnerAudience resources.

On April 22, 2025, you will no longer be able to create Line items for video action campaigns using Structured Data Files, as they are being upgraded to Demand Gen. Line item entries attempting to be uploaded with a Subtype column value of "Action" and a Type column value of "TrueView" will fail.

To avoid any interruption of service, update your integration to use Demand Gen instead of video action campaigns.

Starting April 22, 2025, you will be required to include the value "Video Partners" in the TrueView Inventory Source Targeting column of line item entries that have a Type column value of "Demand Gen". Once this enforcement begins, the value will be backfilled for existing line items and included when downloading new Structured Data Files.

To avoid any interruption of service:

• Update your integration to include the "Video Partners" value in all Demand Gen line item entries.
• Update your integration to manage Demand Gen inventory sources at the Ad Group level using SDF v8.1 Ad Group columns Demand Gen Inventory Source Strategy and Demand Gen Enabled Inventory Sources.

On May 1, 2025, entries in Line Item Structured Data Files that attempt to set the "Bid Multipliers" column will fail to create or update resource on file upload.

On June 12, 2025, content category configurations for individual YouTube & partners line items will no longer be modifiable level as part of an update to brand suitability experience. Content category settings will instead be solely controlled at the advertiser-level. To accommodate this change, the following changes will be made to the Display & Video 360 API and Structured Data Files:

• The contentCategory field in YoutubeAndPartnersSettings objects of YouTube & partners LineItem resources will no longer be updated. It will be removed entirely at a later date.
• The TrueView Content Filter column in Line Item SDFs will no longer be writable.

• Retrieve the effectiveContentCategory field in place of the contentCategory field when reviewing YouTube & partners line items in the API.
• Stop modifying the TrueView Content Filter column when updating SDF line item entries. Keep the column empty when creating new line items.

Starting on June 12, 2025, you will no longer be able to update the budget settings for line items with parent insertion orders set to optimize using automated bid strategies.

• In API: Check if a line item's parent InsertionOrder has either bidStrategy.maximizeSpendAutoBid or bidStrategy.performanceGoalAutoBid set. If so, don't attempt to update the LineItem budget field using advertisers.lineItems.patch.
• In SDF: Check if the SDF entry for the line item's parent insertion order has its Insertion Order Optimization column set to TRUE. If so, don't attempt to update the Budget Type or Budget Amount columns for the line item SDF entry.

Starting June 12, 2025, we will remove an existing restriction for URLs targeted in SDF entries that restricted newer sites from being included. Instead, SDF will match API and UI behavior and allow the targeting of URLs as long as they are correctly formatted.