Method: advertisers.lineItems.generateDefault

Erstellt eine neue Werbebuchung mit Einstellungen (einschließlich Targeting), die vom Anzeigenauftrag übernommen wurden, und einem ENTITY_STATUS_DRAFT entityStatus. Bei Erfolg wird die neu erstellte Werbebuchung zurückgegeben. 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/v3/advertisers/{advertiserId}/lineItems:generateDefault

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
advertiserId

string (int64 format)

Erforderlich. 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 von 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.