Method: adPlays.createWithExternalIds

Erstellt eine Anzeigenwiedergabe mit externen IDs.

  • Gibt die neu erstellte Anzeige zurück, falls erfolgreich.
  • Gibt den Fehlercode INVALID_ARGUMENT zurück, wenn die externe ID des Anzeigenblocks, die externe ID des Auftrags, die externe ID der Zeile oder die externe ID des Creative-Assets angegeben ist.
  • Gibt den Fehlercode INVALID_ARGUMENT zurück, wenn bereits eine Anzeige für denselben Anzeigenblock, denselben Auftrag, dieselbe Zeile und dasselbe Creative mit derselben Startzeit existiert.
  • Gibt den Fehlercode NOT_FOUND zurück, wenn keine übereinstimmende externe ID für Anzeigenblock, externe ID des Auftrags, externe ID der Zeile oder externe ID des Creative-Assets gefunden wird.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
Felder
lineExternalId

string

Erforderlich. Die externe ID der Zeile, zu der diese Anzeige gehört. Format: 123.
orderExternalId

string

Erforderlich. Die externe ID des Auftrags, zu dem diese Anzeige wiedergegeben wird. Format: 456.
adUnitExternalId

string

Erforderlich. Die externe ID des Anzeigenblocks, in dem diese Anzeige ausgeliefert wurde. Format: 789.
creativeAssetExternalId

string

Erforderlich. Die externe ID des Creatives, das diese Anzeige wiedergegeben hat. Format: 3210.
startTime

string (Timestamp format)

Erforderlich. Zeitpunkt, zu dem die Wiedergabe der Anzeige gestartet wurde (einschließlich) Muss in der Vergangenheit und in den letzten 3 Tagen liegen.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Erforderlich. Zeitpunkt, zu dem die Anzeigenwiedergabe beendet wurde (exklusiv). Sollte in der Vergangenheit und nach der Startzeit liegen.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
recordTime

string (Timestamp format)

Optional. Zeitpunkt, zu dem diese Anzeigenwiedergabe erfasst wurde. Sollte in der Vergangenheit und nach der Endzeit liegen.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
impressions

number

Erforderlich. Gesamtzahl der Impressionen.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von AdPlay.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.