Display & Video 360
The 39 tools Pilot MCP serves for Display & Video 360: 16 read-only, and 23 that write with the €29 plan, taken from the server.
Pilot MCP serves 16 read-only tools for Display & Video 360, on every plan. With the €29 plan, it also serves 17 that create or change and 6 that delete. Their names start with dv360_.
What each entry shows
The name, description and parameters come from the list the server serves to your assistant (tools/list). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.
Writing and deleting
Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See Read and write.
Tool families
| Family | Tools |
|---|---|
| Other tools | 16 |
| Create and change (€29) | 17 |
| Delete (€29) | 6 |
Other tools
dv360_create_report_query
Display & Video 360: Create Report Query · read-only · creates an object on each call
Creates a DV360 reporting query (Bid Manager) over the requested period (default LAST_7_DAYS). Returns the query_id to run next with run_report_query. The query stays in Bid Manager: for a one-off report, prefer get_reporting, which deletes its own.
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | yes | Query title. |
metrics | string[] | yes | Metrics, e.g. METRIC_IMPRESSIONS, METRIC_CLICKS, METRIC_REVENUE_ADVERTISER. |
group_bys | string[] | yes | Grouping dimensions, e.g. FILTER_ADVERTISER, FILTER_LINE_ITEM, FILTER_DATE. FILTER_DEVICE_TYPE breaks down by device (Connected TV, Desktop, Smartphone, Tablet): the response then carries tv_connectee, which also states when connected TV is zero. |
filters | object[] | no | Filtres, ex: [{ type: "FILTER_ADVERTISER", value: "123" }]. |
report_type | string | no | Report type (default STANDARD). |
data_range | object | no | Report period: range (preset range) or start_date and end_date (custom period, CUSTOM_DATES). |
account_id | string | no | DV360 advertiser to use when the workspace has several. Default: the first advertiser linked to the workspace. |
dv360_get_advertiser
Display & Video 360: Get Advertiser · read-only · idempotent
Returns the details of a DV360 advertiser (general configuration, currency, status).
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
dv360_get_campaign
Display & Video 360: Get Campaign · read-only · idempotent
Returns the details of a DV360 campaign (goal, flight dates, frequency cap).
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
campaign_id | string | yes | DV360 campaign ID. |
dv360_get_creative
Display & Video 360: Get Creative · read-only · idempotent
Returns the details of a DV360 creative (type, status, dimensions, assets).
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
creative_id | string | yes | Creative ID. |
dv360_get_insertion_order
Display & Video 360: Get Insertion Order · read-only · idempotent
Returns the details of a DV360 insertion order (budget, pacing, optimization objective).
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
insertion_order_id | string | yes | Insertion order ID. |
dv360_get_line_item
Display & Video 360: Get Line Item · read-only · idempotent
Returns the details of a DV360 line item (type, budget, flight, creativeIds).
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
line_item_id | string | yes | Line item ID. |
dv360_get_report
Display & Video 360: Get Report · read-only · creates an object on each call
Fetches the state of a DV360 report (Bid Manager). If state=DONE, downloads and returns the CSV rows (truncation is reported). The temporary query left by get_reporting is deleted once its report is read or has failed.
| Parameter | Type | Required | Description |
|---|---|---|---|
query_id | string | yes | Query ID. |
report_id | string | yes | Report ID (from run_report_query or get_reporting). |
max_rows | integer | no | Maximum rows returned (default 1000, cap 10000). Beyond that, the response says so: truncated, total_rows and a warning. |
account_id | string | no | DV360 advertiser to use when the workspace has several. Default: the first advertiser linked to the workspace. |
dv360_get_reporting
Display & Video 360: Get Reporting · read-only · creates an object on each call
End-to-end DV360 report: creates a temporary query, runs it, waits at most 40 s for the report, reads the CSV and deletes the query. Past the wait, returns query_id and report_id: call get_report later. Custom period (start_date, end_date) or preset range (default LAST_7_DAYS). For connected TV: group_bys with FILTER_DEVICE_TYPE, and the response carries tv_connectee (impressions, spend, with zero stated explicitly).
| Parameter | Type | Required | Description |
|---|---|---|---|
metrics | string[] | yes | Metrics, e.g. METRIC_IMPRESSIONS, METRIC_CLICKS, METRIC_REVENUE_ADVERTISER. |
group_bys | string[] | yes | Grouping dimensions, e.g. FILTER_ADVERTISER, FILTER_LINE_ITEM, FILTER_DATE. FILTER_DEVICE_TYPE breaks down by device (Connected TV, Desktop, Smartphone, Tablet): the response then carries tv_connectee, which also states when connected TV is zero. |
filters | object[] | no | Filtres, ex: [{ type: "FILTER_ADVERTISER", value: "123" }]. |
report_type | string | no | Report type (default STANDARD). |
data_range | object | no | Report period: range (preset range) or start_date and end_date (custom period, CUSTOM_DATES). |
title | string | no | Default: "Pilot ad-hoc report". |
max_rows | integer | no | Maximum rows returned (default 1000, cap 10000). Beyond that, the response says so: truncated, total_rows and a warning. |
timeout_ms | integer | no | Maximum wait, in ms, creation and launch included (default and cap 40000, below the MCP SDK's 60 s). Past it, the tool returns query_id and report_id. |
account_id | string | no | DV360 advertiser to use when the workspace has several. Default: the first advertiser linked to the workspace. |
dv360_list_assigned_targeting
Display & Video 360: List Assigned Targeting · read-only · idempotent
Lists the targeting options assigned to a DV360 line item for a given targeting_type. Follows every page; count is the total read.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
line_item_id | string | yes | Line item ID. |
targeting_type | string | yes | Targeting type, e.g. TARGETING_TYPE_GEO_REGION, TARGETING_TYPE_AGE_RANGE, TARGETING_TYPE_DEVICE_TYPE, TARGETING_TYPE_AUDIENCE_GROUP. |
page_size | integer | no | Items per API request, capped at 200 (100 for insertion orders). The listing follows nextPageToken to the end: this setting changes only the number of requests. |
page_token | string | no | Resume a truncated listing: the `pagination.suite` it returned. |
filter | string | no | Optional filter, e.g. inheritance="NOT_INHERITED". |
dv360_list_campaigns
Display & Video 360: List Campaigns · read-only · idempotent
Lists the DV360 campaigns of an advertiser. Returns the id, displayName, status, goal and flight dates. Follows every page; count is the total read.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
page_size | integer | no | Items per API request, capped at 200 (100 for insertion orders). The listing follows nextPageToken to the end: this setting changes only the number of requests. |
page_token | string | no | Resume a truncated listing: the `pagination.suite` it returned. |
filter | string | no | Optional DV360 filter, e.g. entityStatus="ENTITY_STATUS_ACTIVE". |
dv360_list_creatives
Display & Video 360: List Creatives · read-only · idempotent
Lists the DV360 creatives of an advertiser. Returns the id, displayName, type, status and dimensions. Follows every page; count is the total read.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
page_size | integer | no | Items per API request, capped at 200 (100 for insertion orders). The listing follows nextPageToken to the end: this setting changes only the number of requests. |
page_token | string | no | Resume a truncated listing: the `pagination.suite` it returned. |
filter | string | no | Optional DV360 filter, e.g. entityStatus="ENTITY_STATUS_ACTIVE". |
dv360_list_insertion_orders
Display & Video 360: List Insertion Orders · read-only · idempotent
Lists the DV360 insertion orders (IO) of an advertiser, optionally filtered by campaign. Follows every page; count is the total read.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
campaign_id | string | no | Campaign ID, to list only its insertion orders. |
page_size | integer | no | Items per API request, capped at 200 (100 for insertion orders). The listing follows nextPageToken to the end: this setting changes only the number of requests. |
page_token | string | no | Resume a truncated listing: the `pagination.suite` it returned. |
dv360_list_line_items
Display & Video 360: List Line Items · read-only · idempotent
Lists the DV360 line items of an advertiser, optionally filtered by insertion order. Follows every page; count is the total read.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
insertion_order_id | string | no | Insertion order ID, to list only its line items. |
page_size | integer | no | Items per API request, capped at 200 (100 for insertion orders). The listing follows nextPageToken to the end: this setting changes only the number of requests. |
page_token | string | no | Resume a truncated listing: the `pagination.suite` it returned. |
dv360_run_report_query
Display & Video 360: Run Report Query · read-only · creates an object on each call
Starts a run of an existing DV360 reporting query, over its own period or over data_range. Returns the report_id (state QUEUED or RUNNING). Fetch the rows afterwards with get_report.
| Parameter | Type | Required | Description |
|---|---|---|---|
query_id | string | yes | ID of the query to run. |
data_range | object | no | Report period: range (preset range) or start_date and end_date (custom period, CUSTOM_DATES). |
account_id | string | no | DV360 advertiser to use when the workspace has several. Default: the first advertiser linked to the workspace. |
dv360_search_targeting_options
Display & Video 360: Search Targeting Options · read-only · idempotent
Searches DV360 targeting options of one type by text: a region (TARGETING_TYPE_GEO_REGION), a point of interest (TARGETING_TYPE_POI) or a business chain (TARGETING_TYPE_BUSINESS_CHAIN), the three types the API can search. Returns the targeting_option_id that create_targeting and update_line_item_targeting expect. Follows every page; count is the total read.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | ID of the advertiser in whose context to search (required by the API). |
targeting_type | string | yes | Values: "TARGETING_TYPE_GEO_REGION", "TARGETING_TYPE_POI", "TARGETING_TYPE_BUSINESS_CHAIN". |
query | string | yes | Search text: a place, even a word prefix ("Lyo"); for a point of interest, a name, an address or coordinates ("45.7578,4.8320"); for a business chain, its full name. |
region_query | string | no | TARGETING_TYPE_BUSINESS_CHAIN only: the region in which to search for the chain ("Lyon"). |
page_size | integer | no | Items per API request, capped at 200 (100 for insertion orders). The listing follows nextPageToken to the end: this setting changes only the number of requests. |
page_token | string | no | Resume a truncated listing: the `pagination.suite` it returned. |
dv360_validate_operation
Display & Video 360: Validate Operation · read-only · idempotent
Validates a DV360 operation on the client side (the API has no native validate). On create: every field the v4 API requires and its conditions (starting status, frequency cap, budget segments, bid strategy and its performanceGoalType, EU political advertising declaration). On update: immutable fields. Use it BEFORE a create/update to avoid an API error.
| Parameter | Type | Required | Description |
|---|---|---|---|
entity | string | yes | Entity the operation applies to. Values: "campaign", "insertionOrder", "lineItem", "creative". |
operation | string | yes | Operation to validate. Values: "create", "update". |
payload | object | yes | Operation body (API camelCase keys, e.g. displayName, optimizationObjective). |
account_id | string | no | DV360 advertiser to use when the workspace has several. Default: the first advertiser linked to the workspace. |
Create and change (€29)
Served with the €29 plan.
dv360_archive_campaign
Display & Video 360: Archive Campaign · create or change, €29 plan · creates an object on each call
Archives a DV360 campaign (patch entityStatus=ENTITY_STATUS_ARCHIVED). Treated as a deletion on this server, so it is served at the Admin level only. Required before delete.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
campaign_id | string | yes | ID of the campaign to archive. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_archive_insertion_order
Display & Video 360: Archive Insertion Order · create or change, €29 plan · creates an object on each call
Archives a DV360 insertion order (patch entityStatus=ENTITY_STATUS_ARCHIVED). Required before delete.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
insertion_order_id | string | yes | Insertion order ID. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_archive_line_item
Display & Video 360: Archive Line Item · create or change, €29 plan · creates an object on each call
Archives a DV360 line item (patch entityStatus=ENTITY_STATUS_ARCHIVED). Required before delete.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
line_item_id | string | yes | Line item ID. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_assign_creative_to_line_item
Display & Video 360: Assign Creative to Line Item · create or change, €29 plan · creates an object on each call
Assigns one or more creatives to a DV360 line item. Reads the LI, merges creativeIds, patches with updateMask=creativeIds. (The API has no assignment sub-resource.)
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
line_item_id | string | yes | Line item ID. |
creative_ids | string[] | yes | IDs of the creatives to assign. |
replace | boolean | no | If true, replaces the existing list instead of merging. Default: false. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_create_campaign
Display & Video 360: Create Campaign · create or change, €29 plan · creates an object on each call
Creates a DV360 campaign with every field the v4 API requires: goal and its performance goal, start date, frequency cap. Starts paused by default. Shared guard: dry run by default, then dry_run=false and confirm=true.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
display_name | string | yes | Campaign name (240 bytes at most). |
campaign_goal_type | string | yes | REQUIRED. Campaign goal. Values: "CAMPAIGN_GOAL_TYPE_APP_INSTALL", "CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS", "CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION", "CAMPAIGN_GOAL_TYPE_ONLINE_ACTION". |
performance_goal | object | yes | REQUIRED. Campaign performance goal. |
flight_start_date | object | yes | REQUIRED. Planned start date { year, month, day }, today or later (advertiser time zone). |
flight_end_date | object | no | Planned end date, optional. |
planned_spend_micros | any | no | Planned spend over the period, in micros: used for tracking, does not limit delivery. |
frequency_cap | object | yes | REQUIRED. Frequency cap: { unlimited: true }, or { max_impressions, time_unit, time_unit_count }. |
entity_status | string | no | Initial status (default ENTITY_STATUS_PAUSED; a campaign has no draft status). Values: "ENTITY_STATUS_ACTIVE", "ENTITY_STATUS_PAUSED". Default: "ENTITY_STATUS_PAUSED". |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_create_creative
Display & Video 360: Create Creative · create or change, €29 plan · creates an object on each call
Creates a DV360 creative with the fields the v4 API requires: name, status, hosting, type, dimensions, and through `creative` the assets and exitEvents (plus thirdPartyTag or vastTagUrl for a third-party creative). The payload varies widely with the type (display, video, native…). Shared guard: dry run by default, then dry_run=false and confirm=true.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
display_name | string | yes | Creative name (240 bytes at most). |
creative_type | string | yes | REQUIRED, immutable. E.g. CREATIVE_TYPE_STANDARD, CREATIVE_TYPE_VIDEO, CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_EXPANDABLE, CREATIVE_TYPE_AUDIO. |
hosting_source | string | yes | REQUIRED. Where the creative is hosted. Values: "HOSTING_SOURCE_HOSTED", "HOSTING_SOURCE_THIRD_PARTY", "HOSTING_SOURCE_CM", "HOSTING_SOURCE_RICH_MEDIA". |
dimensions | object | no | REQUIRED. Dimensions { width_pixels, height_pixels }; set to 0 x 0 automatically for CREATIVE_TYPE_VIDEO, CREATIVE_TYPE_AUDIO and CREATIVE_TYPE_NATIVE_VIDEO. |
creative | object | no | Raw creative fields for the type, merged into the payload: assets and exitEvents (REQUIRED by the API), thirdPartyTag (third-party STANDARD or EXPANDABLE creative), vastTagUrl (third-party VIDEO or AUDIO creative), expandingDirection, thirdPartyUrls…. |
entity_status | string | no | Initial status (default ENTITY_STATUS_ACTIVE; a creative serves only through an active line item). Values: "ENTITY_STATUS_ACTIVE", "ENTITY_STATUS_PAUSED". Default: "ENTITY_STATUS_ACTIVE". |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_create_insertion_order
Display & Video 360: Create Insertion Order · create or change, €29 plan · creates an object on each call
Creates a DV360 insertion order as a draft (ENTITY_STATUS_DRAFT, the only status accepted at creation), with every field the v4 API requires: optimization objective, KPI, frequency cap, pacing and budget segments. Shared guard: dry run by default, then dry_run=false and confirm=true.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
campaign_id | string | yes | ID of the parent campaign (immutable afterwards). |
display_name | string | yes | Insertion order name (240 bytes at most). |
optimization_objective | string | yes | REQUIRED. Optimization objective of the insertion order. Values: "CONVERSION", "CLICK", "BRAND_AWARENESS", "CUSTOM", "NO_OBJECTIVE". |
kpi | object | yes | REQUIRED. The KPI of the insertion order (the "goal" in the DV360 interface). |
budget_unit | string | no | Budget in currency (default) or in impressions; immutable afterwards. Values: "BUDGET_UNIT_CURRENCY", "BUDGET_UNIT_IMPRESSIONS". Default: "BUDGET_UNIT_CURRENCY". |
budget_automation_type | string | no | Automatic budget optimization (API default: NONE). Values: "INSERTION_ORDER_AUTOMATION_TYPE_NONE", "INSERTION_ORDER_AUTOMATION_TYPE_BUDGET", "INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET". |
budget_segments | object[] | yes | REQUIRED. At least one budget segment, with amount and dates in the future. |
pacing_period | string | no | Values: "PACING_PERIOD_DAILY", "PACING_PERIOD_FLIGHT". Default: "PACING_PERIOD_FLIGHT". |
pacing_type | string | no | PACING_TYPE_ASAP cannot be combined with PACING_PERIOD_FLIGHT. Values: "PACING_TYPE_AHEAD", "PACING_TYPE_ASAP", "PACING_TYPE_EVEN". Default: "PACING_TYPE_EVEN". |
daily_max_micros | any | no | Daily spend cap in micros, for a currency budget. |
frequency_cap | object | yes | REQUIRED. Frequency cap: { unlimited: true }, or { max_impressions, time_unit, time_unit_count }. |
integration_code | string | no | External identifier, carried into reports (integrationDetails.integrationCode). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_create_line_item
Display & Video 360: Create Line Item · create or change, €29 plan · creates an object on each call
Creates a DV360 line item as a draft (ENTITY_STATUS_DRAFT, the only status accepted at creation), with every field the v4 API requires: flight, budget, pacing, frequency cap, partner revenue model, bid strategy and EU political advertising declaration. Shared guard: dry run by default, then dry_run=false and confirm=true.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
insertion_order_id | string | yes | ID of the parent insertion order (immutable afterwards). |
display_name | string | yes | Line item name (240 bytes at most). |
line_item_type | string | yes | REQUIRED, immutable. E.g. LINE_ITEM_TYPE_DISPLAY_DEFAULT, LINE_ITEM_TYPE_VIDEO_DEFAULT, LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL. |
flight_date_type | string | no | INHERITED: the insertion order's dates; CUSTOM: flight_start_date and flight_end_date. Default: CUSTOM if dates are given, INHERITED otherwise. Values: "LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED", "LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM". |
flight_start_date | object | no | Start date (CUSTOM flight), in the future. |
flight_end_date | any | no | End date (CUSTOM flight), in the future. |
budget_allocation_type | string | yes | REQUIRED. AUTOMATIC exists only if the insertion order allocates its budget automatically; FIXED requires budget_max_micros. Values: "LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC", "LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED", "LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED". |
budget_max_micros | string | no | Maximum budget in micros (50 EUR = "50000000"), REQUIRED with FIXED. |
pacing_period | string | no | Values: "PACING_PERIOD_DAILY", "PACING_PERIOD_FLIGHT". Default: "PACING_PERIOD_FLIGHT". |
pacing_type | string | no | Values: "PACING_TYPE_AHEAD", "PACING_TYPE_ASAP", "PACING_TYPE_EVEN". Default: "PACING_TYPE_EVEN". |
daily_max_micros | any | no | Daily spend cap in micros, for a currency budget. |
frequency_cap | object | no | REQUIRED except for LINE_ITEM_TYPE_DEMAND_GEN. { unlimited: true }, or { max_impressions, time_unit, time_unit_count }: on a line item, the cap counts impressions. |
partner_revenue_model | object | yes | REQUIRED. Partner revenue model (markup applied to the media cost). |
bid_strategy | object | yes | REQUIRED. Bid strategy of the line item. |
contains_eu_political_ads | string | yes | REQUIRED. European Union political advertising declaration: ask the user, never assume it. Without it, the API refuses the creation. Values: "CONTAINS_EU_POLITICAL_ADVERTISING", "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING". |
integration_code | string | no | External identifier, carried into reports (integrationDetails.integrationCode). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_create_targeting
Display & Video 360: Create Targeting · create or change, €29 plan · creates an object on each call
Creates an assigned targeting option on a DV360 line item. The `details` body varies with the targeting_type (e.g. deviceTypeDetails, ageRangeDetails, geoRegionDetails).
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
line_item_id | string | yes | Line item ID. |
targeting_type | string | yes | Targeting type (e.g. TARGETING_TYPE_DEVICE_TYPE). |
details | object | yes | Raw details field in the API's format, e.g. { deviceTypeDetails: { deviceType: 'DEVICE_TYPE_DESKTOP' } }. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_duplicate_line_item
Display & Video 360: Duplicate Line Item · create or change, €29 plan · creates an object on each call
Duplicates a DV360 line item (POST lineItems:duplicate). Creates a copy in the same insertion order.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
line_item_id | string | yes | ID of the line item to duplicate. |
target_display_name | string | no | Name of the copy (optional). |
contains_eu_political_ads | string | no | EU political advertising declaration of the copy (`DuplicateLineItemRequest.containsEuPoliticalAds`); when absent, the advertiser's default declaration applies. Values: "CONTAINS_EU_POLITICAL_ADVERTISING", "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING". |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_set_insertion_order_budget
Display & Video 360: Set Insertion Order Budget · create or change, €29 plan · creates an object on each call
Replaces the budget segments of a DV360 insertion order (patch budget.budgetSegments + updateMask).
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
insertion_order_id | string | yes | Insertion order ID. |
budget_unit | string | no | BUDGET_UNIT_CURRENCY or BUDGET_UNIT_IMPRESSIONS. Default: "BUDGET_UNIT_CURRENCY". |
budget_segments | object[] | yes | |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_set_line_item_budget
Display & Video 360: Set Line Item Budget · create or change, €29 plan · creates an object on each call
Sets the budget of a DV360 line item to an amount (FIXED allocation, patch budget + updateMask). The amount is required. The API refuses this change when the parent insertion order allocates its budget automatically (LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC exists only in that case).
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
line_item_id | string | yes | Line item ID. |
budget_max_micros | string | yes | REQUIRED. Maximum budget in micros of the advertiser's currency (50 EUR = "50000000"), or in impressions if the insertion order budgets in impressions. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_update_campaign
Display & Video 360: Update Campaign · create or change, €29 plan · creates an object on each call
Updates a DV360 campaign (patch + updateMask). Provide only the fields to change.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
campaign_id | string | yes | ID of the campaign to update. |
display_name | string | no | New name (optional). |
entity_status | string | no | Nouveau statut, ex: ENTITY_STATUS_ACTIVE / ENTITY_STATUS_PAUSED. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_update_creative
Display & Video 360: Update Creative · create or change, €29 plan · creates an object on each call
Updates a DV360 creative (patch + updateMask). Provide display_name/entity_status and/or raw fields through `creative` + `update_mask`.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
creative_id | string | yes | Creative ID. |
display_name | string | no | |
entity_status | string | no | |
creative | object | no | Additional raw fields to patch (they must be listed in update_mask). |
update_mask | string[] | no | Additional fields to include in the updateMask (for the fields of `creative`). |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_update_insertion_order
Display & Video 360: Update Insertion Order · create or change, €29 plan · creates an object on each call
Updates a DV360 insertion order (patch + updateMask). Provide only the fields to change.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
insertion_order_id | string | yes | Insertion order ID. |
display_name | string | no | |
entity_status | string | no | Ex: ENTITY_STATUS_ACTIVE / ENTITY_STATUS_PAUSED. |
optimization_objective | string | no | |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_update_line_item
Display & Video 360: Update Line Item · create or change, €29 plan · creates an object on each call
Updates a DV360 line item (patch + updateMask). Provide only the fields to change.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
line_item_id | string | yes | Line item ID. |
display_name | string | no | |
entity_status | string | no | Ex: ENTITY_STATUS_ACTIVE / ENTITY_STATUS_PAUSED. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_update_line_item_targeting
Display & Video 360: Update Line Item Targeting · create or change, €29 plan · creates an object on each call
Bulk-edits the targeting of one or more DV360 line items (bulkEditAssignedTargetingOptions, multi-line-item in v4): create and/or delete assignedTargetingOptions by type. A partial failure is reported as such: ok=false, partial_failure=true and the list of rejected line items.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
line_item_ids | string[] | yes | IDs of the line items whose targeting is edited (the v4 API is multi-line-item). |
create_requests | object[] | no | Targeting options to create, grouped by targeting_type. |
delete_requests | object[] | no | Targeting options to delete, by targeting_type + ids. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
Delete (€29)
Served with the €29 plan. A deletion targets one object at a time.
dv360_bulk_update_line_items
Display & Video 360: Bulk Update Line Items · delete, €29 plan, one object at a time · creates an object on each call
Bulk-updates several DV360 line items with the same patch (POST lineItems:bulkUpdate). Bulk action. Through it the API can change only the status and the EU political advertising declaration. A partial failure is reported as such: ok=false, partial_failure=true and the list of rejected line items.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
line_item_ids | string[] | yes | IDs of the line items to update. |
entity_status | string | no | New status to apply to all of them (a line item never goes back to draft). Values: "ENTITY_STATUS_ACTIVE", "ENTITY_STATUS_PAUSED", "ENTITY_STATUS_ARCHIVED". |
contains_eu_political_ads | string | no | New EU political advertising declaration, to apply to all of them. Values: "CONTAINS_EU_POLITICAL_ADVERTISING", "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING". |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_delete_campaign
Display & Video 360: Delete Campaign · delete, €29 plan, one object at a time · creates an object on each call
PERMANENTLY DELETES a DV360 campaign. The API requires archiving first: this tool archives, then deletes. IRREVERSIBLE.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
campaign_id | string | yes | ID of the campaign to delete. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_delete_creative
Display & Video 360: Delete Creative · delete, €29 plan, one object at a time · creates an object on each call
PERMANENTLY DELETES one DV360 creative. The API requires archiving first: this tool archives, then deletes. IRREVERSIBLE.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
creative_id | string | yes | ID of the creative to delete. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_delete_insertion_order
Display & Video 360: Delete Insertion Order · delete, €29 plan, one object at a time · creates an object on each call
PERMANENTLY DELETES a DV360 insertion order (archives first, then deletes). IRREVERSIBLE.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
insertion_order_id | string | yes | Insertion order ID. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_delete_line_item
Display & Video 360: Delete Line Item · delete, €29 plan, one object at a time · creates an object on each call
PERMANENTLY DELETES a DV360 line item (archives first, then deletes). IRREVERSIBLE.
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
line_item_id | string | yes | Line item ID. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |
dv360_delete_targeting
Display & Video 360: Delete Targeting · delete, €29 plan, one object at a time · creates an object on each call
Deletes an assigned targeting option from a DV360 line item (it cannot be patched: delete it, then create it again).
| Parameter | Type | Required | Description |
|---|---|---|---|
advertiser_id | string | yes | DV360 advertiser ID. |
line_item_id | string | yes | Line item ID. |
targeting_type | string | yes | Targeting type of the option. |
assigned_targeting_option_id | string | yes | ID of the assigned targeting option to delete. |
dry_run | boolean | no | If true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done. |
confirm | boolean | no | Must be true to actually run a destructive or bulk action (delete/archive/bulk). |