Google Display Video 360 API Updates

A comprehensive guide to the 2025 API changes, v3 sunset deadline, and new v4 capabilities for programmatic advertising

The Google Display & Video 360 API has undergone significant transformations throughout 2025, marking a pivotal moment for developers building programmatic advertising solutions. With the impending sunset of API v3 on October 7, 2025, the platform has accelerated its v4 rollout, introducing powerful new capabilities for asset management, targeting controls, and policy management.

This guide examines the latest API updates, provides actionable migration strategies, and delivers practical code examples to help developers leverage these new features effectively. Whether you're managing YouTube campaigns, Demand Gen ads, or complex audience targeting, understanding these API changes is essential for maintaining robust programmatic advertising infrastructure.

Key 2025 API Updates

Major improvements and new capabilities introduced throughout the year

v3 Sunset & v4 Migration

October 7, 2025 deadline for migrating from v3 to v4, with full feature parity achieved in July 2025 update.

Asset Management

New capabilities for creating and retrieving YouTube and Demand Gen ad assets programmatically.

Targeting Parity

Campaign and insertion order targeting in v4 now matches all v3 functionality.

Policy Management

New adPolicy field exposes policy review status and appeal options for ads.

Structured Data Files

Support for SDF versions 9.1 and 9.2 with enhanced bulk operation capabilities.

Inventory Controls

Programmatic access to video ad inventory settings for YouTube & Partners line items.

Understanding the API Version Transition

From v3 to v4

The Display & Video 360 API ecosystem shifted dramatically in 2025, with Google completing the transition from v3 to v4 as the primary supported version. The July 2025 update brought campaign and insertion order targeting capabilities to v4, achieving full parity with v3 functionality. This milestone was critical because it enabled organizations to fully migrate their integrations without sacrificing any operational capabilities.

The sunset deadline of October 7, 2025, for API v3 represents a firm commitment from Google to consolidate development resources on the v4 platform. Developers who have not yet migrated their integrations must prioritize this transition to avoid service disruptions. The v4 API introduces improved RESTful architecture, enhanced authentication mechanisms, and more consistent endpoint designs that reduce integration complexity.

Architectural Improvements in v4

The v4 API introduces several architectural patterns that distinguish it from its predecessor:

  • Resource-oriented design with clearer mapping between endpoints and Display & Video 360 entities
  • Improved rate limiting with more predictable performance characteristics
  • Consistent OAuth 2.0 implementation supporting both service accounts and user credentials
  • JSON-based formats with consistent naming conventions (camelCase)
  • Standardized error responses with detailed remediation suggestions

These improvements translate to faster development cycles, more reliable integrations, and better overall developer experience when building Display & Video 360 automation. For teams working with custom API integrations, the v4 API provides a more streamlined development experience.

New Asset Management Capabilities

YouTube and Demand Gen Asset Support

The October 2025 update introduced the ability to programmatically create and retrieve assets specifically designed for YouTube and Demand Gen ad formats. This capability represents a significant expansion of the API's creative management functionality, enabling advertisers to automate asset workflows that previously required manual intervention through the Display & Video 360 interface.

Asset types supported include:

  • Video files for TrueView, Bumper, and non-skippable formats
  • Companion banners for display overlays
  • Interactive elements for enhanced engagement
  • Thumbnail images for video discovery

The asset upload process supports chunked uploads for large video files, resume capability for interrupted transfers, and automatic format validation to ensure assets meet YouTube advertising specifications.

Implementation Workflows

Implementing robust asset management workflows involves:

  1. Version tracking for complete audit trails
  2. Custom asset labels for flexible categorization
  3. Chunked uploads for large video files
  4. Status polling for transcoding operations
  5. Conditional requests using ETag headers for efficient synchronization

Performance optimization for asset-intensive operations involves implementing appropriate caching strategies for frequently accessed assets, batching upload requests where supported, and utilizing asynchronous operations for large-scale asset updates. These patterns are essential for teams building scalable media management systems.

Creating YouTube and Demand Gen Assets
1async function createAsset(client, advertiserId, assetData) {2 const response = await client.advertisers.assets.upload({3 advertiserId: advertiserId,4 requestBody: {5 asset: {6 name: assetData.name,7 type: assetData.type, // 'VIDEO', 'IMAGE', 'MEDIA_BUNDLE'8 content: {9 assetUpload: {10 uploadToken: assetData.uploadToken11 }12 },13 youtubeAndPartnersSettings: {14 trackingSettings: {15 clickTrackingEnabled: true,16 viewThroughConversionEnabled: true17 }18 }19 }20 }21 });22 return response.data;23}24 25async function getAssetDetails(client, advertiserId, assetId) {26 const response = await client.advertisers.assets.get({27 advertiserId: advertiserId,28 assetId: assetId29 });30 return response.data;31}

Targeting Enhancements

Campaign and Insertion Order Targeting Parity

The July 2025 update achieved a significant milestone by bringing campaign and insertion order targeting capabilities in v4 to full parity with the v3 API. This parity means developers can now migrate targeting-focused integrations without compromising any functional capabilities, removing the final barrier to complete v4 adoption.

Available targeting options include:

  • Geographic targeting from countries to postal codes with flexible include/exclude logic
  • Demographic targeting including custom affinity and in-market segments
  • Behavioral targeting with extensive audience segments based on user behaviors
  • Audience targeting with Customer Match and Similar Audiences integration

Inventory and Video Ad Controls

Retrieving video ad inventory control settings for YouTube & Partners line items became available through the API in the July 2025 update. These controls enable precise management of where video advertisements appear, ensuring brand safety compliance while maximizing reach across the YouTube inventory ecosystem.

Inventory control capabilities include:

  • Content category exclusions
  • Creator allowlists and blocklists
  • Video-level targeting options
  • Placement performance thresholds
  • Dynamic inventory strategies based on real-time data

Implementing inventory control automation requires understanding the relationship between line item configurations and the broader campaign structure. The API provides hierarchical access patterns that reflect this structure, enabling targeted modifications at appropriate levels while maintaining consistent governance.

Configuring Campaign Targeting and Inventory Controls
1async function setCampaignTargeting(client, advertiserId, campaignId, targetingConfig) {2 const response = await client.advertisers.campaigns.targetingTypes.assignedTargetingOptions.create({3 advertiserId: advertiserId,4 campaignId: campaignId,5 targetingType: targetingConfig.type,6 requestBody: targetingConfig.targetingOption7 });8 return response.data;9}10 11async function setInventoryControls(client, advertiserId, lineItemId, inventorySettings) {12 const response = await client.advertisers.lineItems.patch({13 advertiserId: advertiserId,14 lineItemId: lineItemId,15 updateMask: 'youtubeAndPartnersSettings',16 requestBody: {17 youtubeAndPartnersSettings: {18 videoAdInventoryControl: inventorySettings.controlType,19 excludedContentDetails: inventorySettings.excludedContent,20 inventorySourceFilter: inventorySettings.sourceFilter21 }22 }23 });24 return response.data;25}

Policy Management and Compliance

The New adPolicy Field

The October 2025 update introduced a new adPolicy field in AdGroupAd resources, exposing policy review status and appeal options for YouTube and Demand Gen ads. This addition represents a significant advancement in programmatic policy management, enabling advertisers to monitor compliance status and initiate appeals directly through API integrations.

The adPolicy field provides:

  • Current status: approved, under review, rejected, or appealed
  • Specific policy rules that triggered rejections
  • Available remediation actions for each violation
  • Appeal submission with supporting documentation
  • Appeal status tracking through completion

Building Policy Monitoring Systems

Comprehensive policy monitoring integrates multiple endpoints:

  1. Regular polling of adPolicy fields across all active advertisements
  2. Event-driven updates through status change alerts
  3. Compliance reporting that aggregates policy data across campaigns
  4. Pattern identification for systematic rejection issues
  5. Automated escalation for rejected advertisements with appropriate human oversight

Appeal workflows initiated through the API support submitting appeal requests with supporting documentation, tracking appeal status through completion, and receiving structured responses that explain appeal outcomes. This programmatic access to the appeals process reduces resolution times for legitimate ads caught by overly restrictive policy filters.

Structured Data Files: v9.1 and v9.2 Support

Understanding SDF Updates

The October 2025 update added support for Structured Data Files versions 9.1 and 9.2, expanding the file-based bulk management capabilities of the Display & Video 360 API. Structured Data Files provide efficient mechanisms for bulk operations across large advertiser accounts, enabling sophisticated campaign management workflows that would be impractical through individual API calls.

Version 9.1 introduces:

  • Refined targeting option formats
  • More complex audience segment definitions
  • Improved geographic targeting structures

Version 9.2 adds:

  • Additional fields for inventory control specifications
  • Enhanced creative association metadata
  • Extended format validation rules

SDF Implementation Patterns

Efficient Structured Data File implementations follow these patterns:

  • Incremental updates containing only modified entities
  • Pre-submission validation to catch format errors
  • Granular error handling for partial success scenarios
  • Synchronization cycles for rapidly changing campaigns

Validation workflows should be implemented before file submission to catch format errors, missing required fields, and logical inconsistencies that would cause batch failures. The API provides pre-submission validation endpoints that can be integrated into automated pipeline workflows, enabling quality gates that prevent invalid data from entering the system.

Monitoring Policy Status and Submitting Appeals
1async function checkAdPolicyStatus(client, advertiserId, adGroupAdId) {2 const response = await client.advertisers.adGroupAds.get({3 advertiserId: advertiserId,4 adGroupAdId: adGroupAdId,5 fields: 'adGroupAd.id,adGroupAd.ad.policy'6 });7 return response.data.adGroupAd.ad.policy;8}9 10async function submitPolicyAppeal(client, advertiserId, adGroupAdId, appealDetails) {11 const response = await client.advertisers.adGroupAds.editAssignedTargetingOptions({12 advertiserId: advertiserId,13 adGroupAdId: adGroupAdId,14 targetingType: 'POLICY',15 requestBody: {16 appeal: {17 reason: appealDetails.reason,18 supportingDocumentation: appealDetails.documentation19 }20 }21 });22 return response.data;23}

Migration Strategies and Best Practices

Planning Your v3 to v4 Migration

Migrating from Display & Video 360 API v3 to v4 requires systematic planning to ensure continuity of advertising operations. Begin with a comprehensive audit of all existing API integrations, documenting the specific endpoints, methods, and features currently in use. The official v4 migration guide provides detailed endpoint mappings and code transformation examples.

Prioritize migrating integrations that directly impact active campaigns, ensuring that production advertising operations transition to v4 before the sunset deadline. Establish testing environments that mirror production configurations, enabling thorough validation of migrated integrations before cutover.

Phased Migration Approach

Reduce risk with incremental transitions:

  1. Phase 1: Migrate read-only operations for authentication validation
  2. Phase 2: Move write operations for non-critical campaigns
  3. Phase 3: Monitor for unexpected behaviors
  4. Phase 4: Complete production cutover

Performance Optimization

Maximize API performance through:

  • Batch operations using Structured Data Files
  • Client-side request queuing and rate limiting
  • Exponential backoff for retry scenarios
  • Caching strategies using ETag headers
  • Incremental SDF updates rather than complete account snapshots

These optimization strategies are particularly valuable for enterprise-scale advertising operations managing high-volume programmatic campaigns across multiple markets and channels.

Frequently Asked Questions

Ready to Upgrade Your Display & Video 360 Integration?

Our team of Google Ads API specialists can help you migrate to v4 and implement the new 2025 features for your programmatic advertising campaigns.

Sources

  1. Google Display & Video 360 API Release Notes - Official documentation showing current API version v4 and all 2025 updates
  2. Google Display & Video 360 API v4 Migration Guide - Migration documentation for v3 to v4 transition
  3. Google Display & Video 360 API Technical Support - Support resources for developers
  4. Google Ads Developer Blog - July 2025 Update - Announcement of v3 sunset and targeting parity
  5. Google Ads Developer Blog - October 2025 Update - New features including asset management and policy improvements