# Display & Video 360

Source: https://pilot.braike.com/en/docs/regies/dv360

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_`.

<Callout title="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.
</Callout>

<Callout title="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](/en/docs/limites-et-forfaits#ecritures).
</Callout>

## Tool families [#familles]

| Family | Tools |
| --- | ---: |
| [Other tools](#autres) | 16 |
| [Create and change (€29)](#modification) | 17 |
| [Delete (€29)](#suppression) | 6 |

## Other tools [#autres]

### `dv360_create_report_query` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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) [#modification]

Served with the €29 plan.

### `dv360_archive_campaign` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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` [#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) [#suppression]

Served with the €29 plan. A deletion targets one object at a time.

### `dv360_bulk_update_line_items` [#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` [#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` [#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` [#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` [#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` [#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). |
