Method: advertisers.lineItems.generateDefault

Erstellt eine neue Werbebuchung mit Einstellungen (einschließlich Targeting), die vom Anzeigenauftrag übernommen werden, und einer ENTITY_STATUS_DRAFT entityStatus. Gibt die neu erstellte Werbebuchung zurück, wenn der Vorgang erfolgreich war. Es gibt Standardwerte für die drei Felder:

„YouTube und Partner“-Werbebuchungen können nicht über die API erstellt oder aktualisiert werden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
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, für die mit der Werbebuchung geworben 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 unter OAuth 2.0 Overview.