Method: buyers.finalizedDeals.addCreative

  • 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.

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