Method: adPlays.create

Page Summary

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

• A successful request returns the newly created ad play in the response body.

• Potential errors include INVALID_ARGUMENT for invalid inputs or existing ad plays, and NOT_FOUND for missing IDs.

• The process requires authorization using the https://www.googleapis.com/auth/doubleclickbidmanager OAuth scope.

• HTTP request
• Request body
• Response body
• Authorization Scopes
• Examples

Creates an ad play.

• Returns the newly created ad play if successful.
• Returns error code INVALID_ARGUMENT if invalid ad unit, order, line, or creative are specified.
• Returns error code INVALID_ARGUMENT 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 id, order id, line id, or creative asset id found.

HTTP request

POST https://dv360outofhomeseller.googleapis.com/v1beta1/adPlays

The URL uses gRPC Transcoding syntax.

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.