Method: buyers.finalizedDeals.addCreative

  • This page provides documentation for the addCreative method, which adds a creative to a finalized deal for use in the bidding process.

  • The addCreative method is recommended for programmatic guaranteed deals before setting them to ready to serve to reduce filtered bid responses.

  • Up to 1000 creatives can be added to a single finalized deal using this method.

  • The request requires the deal parameter in the path and a request body containing the creative name.

  • The response body will contain an instance of FinalizedDeal if the request is successful.

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