PilotMCP
Platforms and tools

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

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.

ParameterTypeRequiredDescription
titlestringyesQuery title.
metricsstring[]yesMetrics, e.g. METRIC_IMPRESSIONS, METRIC_CLICKS, METRIC_REVENUE_ADVERTISER.
group_bysstring[]yesGrouping 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.
filtersobject[]noFiltres, ex: [{ type: "FILTER_ADVERTISER", value: "123" }].
report_typestringnoReport type (default STANDARD).
data_rangeobjectnoReport period: range (preset range) or start_date and end_date (custom period, CUSTOM_DATES).
account_idstringnoDV360 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).

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 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).

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
campaign_idstringyesDV360 campaign ID.

dv360_get_creative

Display & Video 360: Get Creative · read-only · idempotent

Returns the details of a DV360 creative (type, status, dimensions, assets).

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
creative_idstringyesCreative 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).

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
insertion_order_idstringyesInsertion 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).

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
line_item_idstringyesLine 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.

ParameterTypeRequiredDescription
query_idstringyesQuery ID.
report_idstringyesReport ID (from run_report_query or get_reporting).
max_rowsintegernoMaximum rows returned (default 1000, cap 10000). Beyond that, the response says so: truncated, total_rows and a warning.
account_idstringnoDV360 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).

ParameterTypeRequiredDescription
metricsstring[]yesMetrics, e.g. METRIC_IMPRESSIONS, METRIC_CLICKS, METRIC_REVENUE_ADVERTISER.
group_bysstring[]yesGrouping 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.
filtersobject[]noFiltres, ex: [{ type: "FILTER_ADVERTISER", value: "123" }].
report_typestringnoReport type (default STANDARD).
data_rangeobjectnoReport period: range (preset range) or start_date and end_date (custom period, CUSTOM_DATES).
titlestringnoDefault: "Pilot ad-hoc report".
max_rowsintegernoMaximum rows returned (default 1000, cap 10000). Beyond that, the response says so: truncated, total_rows and a warning.
timeout_msintegernoMaximum 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_idstringnoDV360 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
line_item_idstringyesLine item ID.
targeting_typestringyesTargeting type, e.g. TARGETING_TYPE_GEO_REGION, TARGETING_TYPE_AGE_RANGE, TARGETING_TYPE_DEVICE_TYPE, TARGETING_TYPE_AUDIENCE_GROUP.
page_sizeintegernoItems 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_tokenstringnoResume a truncated listing: the `pagination.suite` it returned.
filterstringnoOptional 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
page_sizeintegernoItems 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_tokenstringnoResume a truncated listing: the `pagination.suite` it returned.
filterstringnoOptional 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
page_sizeintegernoItems 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_tokenstringnoResume a truncated listing: the `pagination.suite` it returned.
filterstringnoOptional 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
campaign_idstringnoCampaign ID, to list only its insertion orders.
page_sizeintegernoItems 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_tokenstringnoResume 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
insertion_order_idstringnoInsertion order ID, to list only its line items.
page_sizeintegernoItems 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_tokenstringnoResume 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.

ParameterTypeRequiredDescription
query_idstringyesID of the query to run.
data_rangeobjectnoReport period: range (preset range) or start_date and end_date (custom period, CUSTOM_DATES).
account_idstringnoDV360 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.

ParameterTypeRequiredDescription
advertiser_idstringyesID of the advertiser in whose context to search (required by the API).
targeting_typestringyesValues: "TARGETING_TYPE_GEO_REGION", "TARGETING_TYPE_POI", "TARGETING_TYPE_BUSINESS_CHAIN".
querystringyesSearch 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_querystringnoTARGETING_TYPE_BUSINESS_CHAIN only: the region in which to search for the chain ("Lyon").
page_sizeintegernoItems 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_tokenstringnoResume 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.

ParameterTypeRequiredDescription
entitystringyesEntity the operation applies to. Values: "campaign", "insertionOrder", "lineItem", "creative".
operationstringyesOperation to validate. Values: "create", "update".
payloadobjectyesOperation body (API camelCase keys, e.g. displayName, optimizationObjective).
account_idstringnoDV360 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
campaign_idstringyesID of the campaign to archive.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
insertion_order_idstringyesInsertion order ID.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
line_item_idstringyesLine item ID.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.)

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
line_item_idstringyesLine item ID.
creative_idsstring[]yesIDs of the creatives to assign.
replacebooleannoIf true, replaces the existing list instead of merging. Default: false.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
display_namestringyesCampaign name (240 bytes at most).
campaign_goal_typestringyesREQUIRED. Campaign goal. Values: "CAMPAIGN_GOAL_TYPE_APP_INSTALL", "CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS", "CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION", "CAMPAIGN_GOAL_TYPE_ONLINE_ACTION".
performance_goalobjectyesREQUIRED. Campaign performance goal.
flight_start_dateobjectyesREQUIRED. Planned start date { year, month, day }, today or later (advertiser time zone).
flight_end_dateobjectnoPlanned end date, optional.
planned_spend_microsanynoPlanned spend over the period, in micros: used for tracking, does not limit delivery.
frequency_capobjectyesREQUIRED. Frequency cap: { unlimited: true }, or { max_impressions, time_unit, time_unit_count }.
entity_statusstringnoInitial status (default ENTITY_STATUS_PAUSED; a campaign has no draft status). Values: "ENTITY_STATUS_ACTIVE", "ENTITY_STATUS_PAUSED". Default: "ENTITY_STATUS_PAUSED".
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
display_namestringyesCreative name (240 bytes at most).
creative_typestringyesREQUIRED, immutable. E.g. CREATIVE_TYPE_STANDARD, CREATIVE_TYPE_VIDEO, CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_EXPANDABLE, CREATIVE_TYPE_AUDIO.
hosting_sourcestringyesREQUIRED. Where the creative is hosted. Values: "HOSTING_SOURCE_HOSTED", "HOSTING_SOURCE_THIRD_PARTY", "HOSTING_SOURCE_CM", "HOSTING_SOURCE_RICH_MEDIA".
dimensionsobjectnoREQUIRED. Dimensions { width_pixels, height_pixels }; set to 0 x 0 automatically for CREATIVE_TYPE_VIDEO, CREATIVE_TYPE_AUDIO and CREATIVE_TYPE_NATIVE_VIDEO.
creativeobjectnoRaw 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_statusstringnoInitial 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_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
campaign_idstringyesID of the parent campaign (immutable afterwards).
display_namestringyesInsertion order name (240 bytes at most).
optimization_objectivestringyesREQUIRED. Optimization objective of the insertion order. Values: "CONVERSION", "CLICK", "BRAND_AWARENESS", "CUSTOM", "NO_OBJECTIVE".
kpiobjectyesREQUIRED. The KPI of the insertion order (the "goal" in the DV360 interface).
budget_unitstringnoBudget in currency (default) or in impressions; immutable afterwards. Values: "BUDGET_UNIT_CURRENCY", "BUDGET_UNIT_IMPRESSIONS". Default: "BUDGET_UNIT_CURRENCY".
budget_automation_typestringnoAutomatic budget optimization (API default: NONE). Values: "INSERTION_ORDER_AUTOMATION_TYPE_NONE", "INSERTION_ORDER_AUTOMATION_TYPE_BUDGET", "INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET".
budget_segmentsobject[]yesREQUIRED. At least one budget segment, with amount and dates in the future.
pacing_periodstringnoValues: "PACING_PERIOD_DAILY", "PACING_PERIOD_FLIGHT". Default: "PACING_PERIOD_FLIGHT".
pacing_typestringnoPACING_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_microsanynoDaily spend cap in micros, for a currency budget.
frequency_capobjectyesREQUIRED. Frequency cap: { unlimited: true }, or { max_impressions, time_unit, time_unit_count }.
integration_codestringnoExternal identifier, carried into reports (integrationDetails.integrationCode).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
insertion_order_idstringyesID of the parent insertion order (immutable afterwards).
display_namestringyesLine item name (240 bytes at most).
line_item_typestringyesREQUIRED, immutable. E.g. LINE_ITEM_TYPE_DISPLAY_DEFAULT, LINE_ITEM_TYPE_VIDEO_DEFAULT, LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL.
flight_date_typestringnoINHERITED: 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_dateobjectnoStart date (CUSTOM flight), in the future.
flight_end_dateanynoEnd date (CUSTOM flight), in the future.
budget_allocation_typestringyesREQUIRED. 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_microsstringnoMaximum budget in micros (50 EUR = "50000000"), REQUIRED with FIXED.
pacing_periodstringnoValues: "PACING_PERIOD_DAILY", "PACING_PERIOD_FLIGHT". Default: "PACING_PERIOD_FLIGHT".
pacing_typestringnoValues: "PACING_TYPE_AHEAD", "PACING_TYPE_ASAP", "PACING_TYPE_EVEN". Default: "PACING_TYPE_EVEN".
daily_max_microsanynoDaily spend cap in micros, for a currency budget.
frequency_capobjectnoREQUIRED 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_modelobjectyesREQUIRED. Partner revenue model (markup applied to the media cost).
bid_strategyobjectyesREQUIRED. Bid strategy of the line item.
contains_eu_political_adsstringyesREQUIRED. 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_codestringnoExternal identifier, carried into reports (integrationDetails.integrationCode).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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).

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
line_item_idstringyesLine item ID.
targeting_typestringyesTargeting type (e.g. TARGETING_TYPE_DEVICE_TYPE).
detailsobjectyesRaw details field in the API's format, e.g. { deviceTypeDetails: { deviceType: 'DEVICE_TYPE_DESKTOP' } }.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
line_item_idstringyesID of the line item to duplicate.
target_display_namestringnoName of the copy (optional).
contains_eu_political_adsstringnoEU 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_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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).

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
insertion_order_idstringyesInsertion order ID.
budget_unitstringnoBUDGET_UNIT_CURRENCY or BUDGET_UNIT_IMPRESSIONS. Default: "BUDGET_UNIT_CURRENCY".
budget_segmentsobject[]yes
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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).

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
line_item_idstringyesLine item ID.
budget_max_microsstringyesREQUIRED. Maximum budget in micros of the advertiser's currency (50 EUR = "50000000"), or in impressions if the insertion order budgets in impressions.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
campaign_idstringyesID of the campaign to update.
display_namestringnoNew name (optional).
entity_statusstringnoNouveau statut, ex: ENTITY_STATUS_ACTIVE / ENTITY_STATUS_PAUSED.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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`.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
creative_idstringyesCreative ID.
display_namestringno
entity_statusstringno
creativeobjectnoAdditional raw fields to patch (they must be listed in update_mask).
update_maskstring[]noAdditional fields to include in the updateMask (for the fields of `creative`).
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
insertion_order_idstringyesInsertion order ID.
display_namestringno
entity_statusstringnoEx: ENTITY_STATUS_ACTIVE / ENTITY_STATUS_PAUSED.
optimization_objectivestringno
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
line_item_idstringyesLine item ID.
display_namestringno
entity_statusstringnoEx: ENTITY_STATUS_ACTIVE / ENTITY_STATUS_PAUSED.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
line_item_idsstring[]yesIDs of the line items whose targeting is edited (the v4 API is multi-line-item).
create_requestsobject[]noTargeting options to create, grouped by targeting_type.
delete_requestsobject[]noTargeting options to delete, by targeting_type + ids.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
line_item_idsstring[]yesIDs of the line items to update.
entity_statusstringnoNew 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_adsstringnoNew EU political advertising declaration, to apply to all of them. Values: "CONTAINS_EU_POLITICAL_ADVERTISING", "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING".
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
campaign_idstringyesID of the campaign to delete.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
creative_idstringyesID of the creative to delete.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
insertion_order_idstringyesInsertion order ID.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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.

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
line_item_idstringyesLine item ID.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust 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).

ParameterTypeRequiredDescription
advertiser_idstringyesDV360 advertiser ID.
line_item_idstringyesLine item ID.
targeting_typestringyesTargeting type of the option.
assigned_targeting_option_idstringyesID of the assigned targeting option to delete.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).

On this page