Method: sellers.adPlays.create

  • This page details how to create an ad play using a POST request to the specified API endpoint.

  • Input can be provided as resource names or external IDs, but not both simultaneously.

  • A successful request returns the newly created ad play, while various error codes indicate specific issues such as invalid arguments, existing ad plays, or unfound resources.

  • Authorization requires the https://www.googleapis.com/auth/doubleclickbidmanager OAuth scope.

Creates an ad play.

  • Input could be either a set of resource names or a set of external ids.
  • Returns the newly created ad play if successful.
  • Returns error code INVALID_ARGUMENT if invalid ad unit, order, line, or creative are specified. For example, ad unit resource name is not in format sellers/111/adUnits/123.
  • Returns error code ALREADY_EXISTS if an ad play for the same ad unit, order, line, and creative with the same startTime already exists.
  • Returns error code NOT_FOUND if no matching ad unit, order, line, or creative asset found.
  • Returns error code FAILED_PRECONDITION if the request contains both resource name and external id.

HTTP request

POST https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adPlays

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The seller resource name. Format: sellers/{seller}

Request body

The request body contains an instance of AdPlay.

Response body

If successful, the response body contains a newly created instance of AdPlay.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/doubleclickbidmanager

For more information, see the OAuth 2.0 Overview.