GOgoogle
buyers

POST /v1/buyers/{buyersId}/finalizedDeals/{finalizedDealsId}:addCreative

Changed on

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 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. This method only applies to programmatic guaranteed deals. Maximum number of 1000 creatives can be added to a finalized deal.

Request

  • Base URL
    https://authorizedbuyersmarketplace.googleapis.com
  • URL
    https://authorizedbuyersmarketplace.googleapis.com/v1/buyers/{buyersId}/finalizedDeals/{finalizedDealsId}:addCreative
  • Auth
    OAuth 2 and OAuth 2
    Implicit: https://accounts.google.com/o/oauth2/auth
    Scopes: https://www.googleapis.com/auth/authorized-buyers-marketplace
    Authorization code: https://accounts.google.com/o/oauth2/auth
    Token URL: https://accounts.google.com/o/oauth2/token scopes: https://www.googleapis.com/auth/authorized-buyers-marketplace

Path parameters

buyersIdstring required
finalizedDealsIdstring required

Request body

creativestring

Name of the creative to add to the finalized deal, in the format buyers/{buyerAccountId}/creatives/{creativeId}. See creative.name.

Response

Successful response

dealServingStatus'DEAL_SERVING_STATUS_UNSPECIFIED' | 'ACTIVE' | 'ENDED' | 'PAUSED_BY_BUYER' | 'PAUSED_BY_SELLER'

Serving status of the deal.

namestring

The resource name of the finalized deal. Format: buyers/{accountId}/finalizedDeals/{finalizedDealId}

readyToServeboolean

Whether the Programmatic Guaranteed deal is ready for serving.

Changes