Method: sellers.adPlays.batchCreate

Erstellt neue Anzeigenwiedergaben im Batch.

  • Die maximal zulässige Anzahl von Anzeigenwiedergaben in einem Batch beträgt 1.000.
  • Gibt die neu erstellte Anzeige zurück, wenn sie erfolgreich war.
  • Gibt den Fehlercode INVALID_ARGUMENT zurück, wenn ein ungültiger Anzeigenblock, ein ungültiger Auftrag, eine ungültige Zeile oder ein ungültiges Creative angegeben wurde.
  • Gibt den Fehlercode ALREADY_EXISTS 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 kein übereinstimmender Anzeigenblock, kein entsprechender Auftrag, keine Zeile oder kein passendes Creative-Asset gefunden wird.
  • Gibt den Fehlercode FAILED_PRECONDITION zurück, wenn die Anfrage sowohl den Ressourcennamen als auch die externe ID enthält.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Name der Verkäuferressource. Format: Verkäufer/{Verkäufer}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requests": [
    {
      object (CreateAdPlayRequest)
    }
  ]
}
Felder
requests[]

object (CreateAdPlayRequest)

Erforderlich. Die Anzeige wird wiedergegeben, um zu erstellen.

Die maximal zulässige Anzahl von Anzeigenwiedergaben in einem Batch beträgt 1.000. Der Beginn muss in der Vergangenheit und höchstens 3 Tage vor dem Erstellungsdatum liegen. Das Ende muss in der Vergangenheit und nach dem Beginn liegen.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwort für die Erstellung von Anzeigenwiedergaben im Stapel.

JSON-Darstellung 
{
  "adPlays": [
    {
      object (AdPlay)
    }
  ]
}
Felder
adPlays[]

object (AdPlay)

Die erstellte Anzeige wird wiedergegeben.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

CreateAdPlayRequest

Anfragenachricht für AdPlayService.CreateAdPlay

JSON-Darstellung 
{
  "parent": string,
  "adPlay": {
    object (AdPlay)
  }
}
Felder
parent

string

Erforderlich. Der Name der Verkäuferressource. Format: Verkäufer/{Verkäufer}
adPlay

object (AdPlay)

Erforderlich. Die zu erstellende Anzeige wird abgespielt.

Der Name der Anzeigenwiedergabe wird vom System generiert und darf nicht festgelegt werden. Der Beginn muss in der Vergangenheit und höchstens 3 Tage vor dem Erstellungsdatum liegen. Das Ende muss in der Vergangenheit und nach dem Beginn liegen.