deals
Create, update, and manage programmatic deals including PMP, PG/PD proposals, ADCP deal flows, and auction packages in Google Ad Manager.
Instructions
Author and manage programmatic deals — PMP, PG/PD proposals, ADCP deal flows, and auction packages.
MODE: mixed (read + write) AUTH: OAuth 2.0 required CREDITS: Reads = 0. Write operations = 0.5–2 credits. ADCP create = 2 credits. OUTPUT: Returns Deal or Proposal objects with id, status, buyerId, floorPrice, targeting, and negotiation state. SIDE EFFECTS: Proposals go through a negotiation workflow — state transitions (reserve, request_buyer_acceptance) trigger buyer notifications. terminate_proposal_negotiations is irreversible. WHEN TO USE: Use deals for programmatic direct (PG/PD), private marketplace (PMP), and ADCP deal creation. For standard direct-sold campaigns, use campaign tool instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Sub-operation to perform: • list_deals: List all programmatic deals on the network. Read-only. • get_deal: Get a specific deal by ID. Read-only. • create_deal: Create a new programmatic deal. Write. • update_deal: Update a deal's floor price or targeting. Write. • list_auctions: List auction packages. Read-only. • get_auction: Get a specific auction package. Read-only. • create_auction: Create an auction package. Write. • update_auction: Update an auction package. Write. • list_buyers: List all programmatic buyers on the network. Read-only. • get_buyer: Get a specific buyer by ID. Read-only. • get_proposal: Get a proposal by ID including its negotiation history. Read-only. • create_proposal: Create a new PG/PD proposal. Write. • update_proposal: Update a proposal's terms, targeting, or pricing. Write. • archive_proposal: Archive a proposal. Destructive write. • request_buyer_acceptance: Send a proposal to the buyer for acceptance. Write — triggers buyer notification. • reserve_proposal: Reserve inventory for a proposal (locks availability). Write. • edit_proposal_for_negotiation: Reopen an accepted proposal for renegotiation. Write. • terminate_proposal_negotiations: Permanently terminate negotiations. Irreversible destructive write. • get_marketplace_comments: Retrieve buyer/seller comments on a proposal. Read-only. • list_proposal_line_items: List line items within a proposal. Read-only. • create_proposal_line_items: Create line items within a proposal. Write. • update_proposal_line_items: Update proposal line items' targeting or pricing. Write. • archive_proposal_line_items: Archive proposal line items. Destructive write. • create_makegoods: Create makegood line items to compensate for underdelivered campaigns. Write. • estimate_deal_cost: Preview the credit cost of a deal operation. Read-only. • adcp_validate: Validate an ADCP deal configuration before creation. Read-only. • adcp_preview: Preview an ADCP deal's reach and estimated delivery. Read-only. • adcp_create: Create an ADCP deal. Write, 2 credits, requires confirmation_token. | |
| network_code | No | GAM network code (e.g. 12345678). Required for all network-scoped operations. Obtain via select_gam_network or list_accessible_networks. |