Method: adPlays.createWithExternalIds

Consente di riprodurre un annuncio con ID esterni.

  • In caso di esito positivo, restituisce la riproduzione dell'annuncio appena creata.
  • Restituisce il codice di errore INVALID_ARGUMENT se vengono specificati un ID esterno dell'unità pubblicitaria, un ID esterno dell'ordine, un ID esterno della riga o un ID esterno dell'asset della creatività non valido.
  • Restituisce il codice di errore INVALID_ARGUMENT se esiste già un annuncio riprodotto per la stessa unità pubblicitaria, lo stesso ordine, la stessa riga e la stessa creatività con la stessa ora di inizio.
  • Restituisce il codice di errore NOT_FOUND se non è stato trovato alcun ID esterno dell'unità pubblicitaria, ID esterno dell'ordine, ID esterno della riga o ID esterno dell'asset della creatività corrispondente.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
Campi
lineExternalId

string

Obbligatorio. L'ID esterno della riga a cui appartiene questa riproduzione annuncio. Formato: 123.
orderExternalId

string

Obbligatorio. L'ID esterno dell'ordine a cui appartiene questa riproduzione dell'annuncio. Formato: 456.
adUnitExternalId

string

Obbligatorio. L'ID esterno dell'unità pubblicitaria in cui è stata pubblicata la riproduzione dell'annuncio. Formato: 789.
creativeAssetExternalId

string

Obbligatorio. L'ID esterno della creatività pubblicata da questo annuncio. Formato: 3210.
startTime

string (Timestamp format)

Obbligatorio. Ora di inizio della riproduzione dell'annuncio (incluso). Deve essere nel passato e negli ultimi 3 giorni.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Obbligatorio. Ora di fine della riproduzione dell'annuncio (esclusiva). Deve essere nel passato e dopo l'ora di inizio.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
recordTime

string (Timestamp format)

(Facoltativo) L'ora in cui è stata registrata la riproduzione dell'annuncio. Deve essere nel passato e deve essere successiva all'ora di fine.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
impressions

number

Obbligatorio. Numero totale di impressioni.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di AdPlay.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.