Method: advertisers.lineItems.generateDefault

Erstellt eine neue Werbebuchung mit Einstellungen (einschließlich Targeting) aus dem Anzeigenauftrag und einem ENTITY_STATUS_DRAFT-entityStatus. Gibt bei Erfolg die neu erstellte Werbebuchung zurück Es gibt Standardwerte, die auf den drei Feldern basieren:

„YouTube und Partner“-Werbebuchungen können nicht mit der API erstellt oder aktualisiert werden.

HTTP-Anfrage

POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems:generateDefault

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameters
advertiserId

string (int64 format)

Erforderlich. Die ID des Werbetreibenden, zu dem diese Werbebuchung gehört.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  }
}
Felder
insertionOrderId

string (int64 format)

Erforderlich. Die eindeutige ID des Anzeigenauftrags, zu dem die Werbebuchung gehört.

displayName

string

Erforderlich. Der Anzeigename der Werbebuchung.

Muss UTF-8-codiert sein und darf maximal 240 Byte groß sein.

lineItemType

enum (LineItemType)

Erforderlich. Der Typ der Werbebuchung.

mobileApp

object (MobileApp)

Die mobile App, die mit der Werbebuchung beworben wird.

Dies gilt nur, wenn lineItemType entweder LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL oder LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL ist.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/display-video

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