Method: advertisers.lineItems.generateDefault

Erstellt eine neue Werbebuchung mit Einstellungen (einschließlich Targeting), die vom Anzeigenauftrag übernommen wurden, und einem ENTITY_STATUS_DRAFT entityStatus. Gibt die neu erstellte Werbebuchung zurück, wenn der Vorgang erfolgreich war. Es gibt Standardwerte, die auf den drei Feldern basieren:

„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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
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 lang sein.
lineItemType

enum (LineItemType)

Erforderlich. Der Typ der Werbebuchung.
mobileApp

object (MobileApp)

Die mobile App, für die in 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.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Gibt an, ob mit dieser Werbebuchung politische Werbung in der EU ausgeliefert wird.

Wenn containsEuPoliticalAds im übergeordneten Werbetreibenden auf DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING gesetzt wurde, wird diesem Feld DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING zugewiesen, sofern nichts anderes angegeben ist. Dieses Feld kann dann über die Benutzeroberfläche, die API oder Dateien mit strukturierten Daten aktualisiert werden.

Dieses Feld muss beim Erstellen einer neuen Werbebuchung zugewiesen werden. Andernfalls schlägt die advertisers.lineItems.create-Anfrage fehl.

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.