Method: sellers.adPlays.create

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


The URL uses gRPC Transcoding syntax.

Path parameters



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:


For more information, see the OAuth 2.0 Overview.