Method: buyers.finalizedDeals.addCreative
Add creative to be used in the bidding process for a finalized deal. For programmatic guaranteed deals, it's recommended that you associate at least one approved creative with the deal before calling finalizedDeals.setReadyToServe, to help reduce the number of bid responses filtered because they don't contain approved creatives. Creatives successfully added to a deal can be found in the Realtime-bidding Creatives API [creative.deal_ids][google.ads.realtimebidding.v1.Creative.deal_ids]. This method only applies to programmatic guaranteed deals. Maximum number of 1000 creatives can be added to a finalized deal.
HTTP request
POST https://authorizedbuyersmarketplace.googleapis.com/v1/{deal=buyers/*/finalizedDeals/*}:addCreative
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
deal |
string
Required. Name of the finalized deal in the format of: buyers/{accountId}/finalizedDeals/{dealId}
|
Request body
The request body contains data with the following structure:
| JSON representation |
{
"creative": string
} |
| Fields |
creative |
string
Name of the creative to add to the finalized deal, in the format buyers/{buyerAccountId}/creatives/{creativeId}. See [creative.name][google.ads.realtimebidding.v1.Creative.name].
|
Response body
If successful, the response body contains an instance of FinalizedDeal.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/authorized-buyers-marketplace
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-18 UTC.
[null,null,["Last updated 2024-09-18 UTC."],[[["This guide outlines how to add a creative to a finalized programmatic guaranteed deal using the Authorized Buyers Marketplace API."],["You must associate at least one approved creative with a deal before finalizing it."],["Creatives are managed and viewed through the Realtime-bidding Creatives API."],["A maximum of 1000 creatives can be added to a single finalized deal."],["The process involves sending an HTTP POST request with the deal and creative information."]]],["**Core Content Summary:**\n\nThis document outlines how to add creatives to finalized programmatic guaranteed deals using the Authorized Buyers Marketplace API. It details the required HTTP POST request, including the specific URL structure, path parameter (`deal`), and JSON request body containing the `creative` name. The operation requires OAuth authorization and returns the updated `FinalizedDeal` object upon success. Up to 1000 creatives are allowed per deal.\n\n**Creative for Bidding Process:**\n\n\"To maximize your programmatic guaranteed deal performance, ensure you associate at least one approved creative via our API's `addCreative` method. This optimizes bid responses and leverages our Real-time Bidding Creatives API. Streamline your deal execution by pre-loading creatives before finalizing your deal.\"\n"]]
