canonical: https://jentic.com/apis/googleapis.com/displayvideo

# Google Display & Video 360 API

Google Display & Video 360 (DV360) is the demand-side platform for programmatic media buying across display, video, audio, and connected TV. The API exposes advertisers, campaigns, insertion orders, line items, creatives, audiences, channels, and inventory sources so trading desks can automate planning, activation, optimisation, and reporting at scale. With 150 endpoints, it covers the full workflow from advertiser setup through bid strategy and creative trafficking on the buy side.

## For AI agents

Plan, activate, and optimise programmatic media buying across DSP campaigns, line items, creatives, and audiences.

## Scope

Does not handle ad serving, floodlight conversions, or search ads - use for Display & Video 360 programmatic buying and trading only.

## Capabilities

- Create insertion orders and line items with bid strategies and pacing
- Upload creatives and assign them to line items across formats
- Manage first-party audiences, channels, and negative keyword lists
- Configure inventory sources and deal IDs for guaranteed and PMP buys
- Bulk-edit line item targeting via batch endpoints
- Download structured reports on campaign delivery and pacing

## Use cases

### Programmatic Campaign Activation

Trading desks use DV360 API to spin up entire campaign trees programmatically - advertiser, campaign, insertion orders, line items, creatives - instead of clicking through the UI. The /v2/advertisers/{advertiserId}/campaigns and /lineItems endpoints accept structured payloads that mirror the planning brief, so a 50-line-item launch goes out in minutes.

Example prompt: Create a Standard line item under campaign 12345 for advertiser 67890 with a CPM bid of $5, daily budget $100, and a frequency cap of 3 per user per day.

### Bulk Targeting Updates

When a brand-safety event or creative refresh demands updating hundreds of line items, the bulk-edit endpoints under /v2/advertisers/{advertiserId}/lineItems:bulkEditAssignedTargetingOptions let traders apply geo, content category, and viewability changes in a single call. This avoids manual rework and keeps the live campaign aligned with policy.

Example prompt: Bulk-edit assigned targeting on line items 100, 101, 102 under advertiser 67890 to exclude content category news and add geo target US-CA.

### Audience and Channel Management

Use the audiences and channels endpoints to maintain first-party data activations and inventory channels at scale. List existing audiences before activating, create channels grouped by inventory quality, and assign them to line items so spend flows to the right placements without one-off UI work.

Example prompt: List all audiences under advertiser 67890 with type FIRST_PARTY, then assign audience 9999 as a positive targeting option to line item 200.

### Agent-Driven Pacing Audits

Through Jentic, an AI agent can sweep all active campaigns each morning, list under-pacing line items via the DV360 API, and surface a pacing report to the trader. Credentials are scoped per agent run by your Jentic One instance - the trader sees a ranked list of line items needing attention without exposing OAuth secrets.

Example prompt: Use Jentic to list line items for advertiser 67890 with status ENTITY_STATUS_ACTIVE, fetch their pacing data, and return a list of those pacing below 70 percent of plan.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /v2/advertisers | List advertisers accessible to the caller |
| GET | /v2/advertisers/{+advertiserId}/campaigns | List campaigns under an advertiser |
| POST | /v2/advertisers/{+advertiserId}/lineItems | Create a new line item |
| GET | /v2/advertisers/{+advertiserId}/channels | List inventory channels for an advertiser |
| GET | /v2/advertisers/{+advertiserId}/assets | List creative assets for an advertiser |

## Key resources

- **advertisers** — Manage DV360 advertisers under partners
- **campaigns** — Create and manage advertising campaigns under advertisers
- **insertionOrders** — Group line items into insertion orders with budgets
- **lineItems** — Manage individual buying units with bid strategies and targeting
- **creatives** — Upload and manage display, video, and audio creatives
- **audiences** — Activate first-party and Google audiences for targeting
- **channels** — Define inventory channels for line item targeting

## Why Jentic

- **Setup:** Wiring the Display & Video 360 API by hand means standing up Google OAuth2 with the right scopes, targeting displayvideo.googleapis.com, and threading advertiser and campaign ids through every programmatic-buying call yourself. Through Jentic you install once, import the Display & Video 360 API from the API Directory, store the OAuth credential once, and your agent calls it.
- **Permission scoping:** Display & Video 360 puts the advertiser id in the URL path (/v2/advertisers/{advertiserId}/...), so a rule can pin your agent to one advertiser: it can list and read campaigns, channels, and assets there and nothing else. You choose the operations it may call, so write operations like creating line items are not included unless you add them.
- **Credential handling:** Your Google OAuth credential for Display & Video 360 is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'list campaigns for an advertiser' or 'create a line item', and Jentic returns the matching Display & Video 360 operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **DoubleClick Bid Manager API** — Reporting API that pairs with DV360 trading operations
- **Campaign Manager 360 API** — Ad-server side that handles trafficking and floodlight conversions
- **Authorized Buyers API** — RTB-level bidder integration - lower-level than DV360

## FAQ

### What authentication does the Display & Video 360 API use?

OAuth 2.0 with the display-video and doubleclickbidmanager scopes. Through Jentic, OAuth tokens are scoped per agent run and stored encrypted in your Jentic One instance, so service-account JSON keys never enter the agent runtime.

### Can I bulk-edit line item targeting through the API?

Yes. The lineItems:bulkEditAssignedTargetingOptions endpoint under /v2/advertisers/{advertiserId} accepts a list of line item IDs plus add/remove targeting payloads, applying changes in one transactional call.

### What are the rate limits for the DV360 API?

DV360 enforces a default of 240 queries per minute per project per advertiser, with stricter limits on bulk and creative-upload endpoints. Quotas are visible in the Google Cloud Console and can be raised on request for high-volume traders.

### How do I list line items through Jentic?

Search 'list DV360 line items', load the schema for /v2/advertisers/{advertiserId}/lineItems, then execute it with your advertiser ID. Jentic returns the parsed line item array with bid strategy and pacing fields.

### Does DV360 support Connected TV and audio buying?

Yes. Line items support video and audio formats including CTV, with creative formats and inventory sources tagged for those environments. The same lineItem and creative endpoints handle the full set of formats.

### Is the Display & Video 360 API free?

DV360 itself is enterprise-licensed through Google Marketing Platform (sales-led) - there is no usage charge for the API on top of the platform fee. Underlying media spend is charged separately through invoicing.

### Can I limit what my agent is allowed to do with the Display & Video 360 API?

Yes. Because your Jentic One instance is self-hosted, your own rules decide which Display & Video 360 operations and credentials the agent may use. Since the advertiser id sits in the URL path (/v2/advertisers/{advertiserId}/...), a rule can pin the agent to a single advertiser, letting it list and read that advertiser's campaigns, channels, and assets and nothing else. You choose the operations it may call, so write actions such as creating a line item are excluded unless you explicitly add them.