Method: advertisers.lineItems.generateDefault

Tworzy nowy element zamówienia z ustawieniami (w tym kierowaniem) odziedziczonymi z zamówienia reklamowego i z ceną ENTITY_STATUS_DRAFT entityStatus. Jeśli operacja się uda, zwraca nowo utworzony element zamówienia. Wartości domyślne są oparte na tych 3 polach:

Elementów zamówienia typu YouTube i sieć partnerów wideo Google nie można tworzyć ani aktualizować za pomocą interfejsu API.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
advertiserId

string (int64 format)

Wymagane. Identyfikator reklamodawcy, do którego należy ten element zamówienia.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
Pola
insertionOrderId

string (int64 format)

Wymagane. Unikalny identyfikator zamówienia reklamowego, do którego należy element zamówienia.
displayName

string

Wymagane. Wyświetlana nazwa elementu zamówienia.

Musi być zakodowany w formacie UTF-8 i mieć maksymalny rozmiar 240 bajtów.
lineItemType

enum (LineItemType)

Wymagane. Typ elementu zamówienia.
mobileApp

object (MobileApp)

Aplikacja mobilna promowana przez element zamówienia.

Ma to zastosowanie tylko wtedy, gdy element lineItemType ma wartość LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL lub LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Czy ten element zamówienia będzie wyświetlać reklamy polityczne w Unii Europejskiej.

Jeśli w przypadku reklamodawcy nadrzędnego ustawiono wartość containsEuPoliticalAds, to w tym polu zostanie przypisana wartość DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, o ile nie określono inaczej.DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING To pole można następnie zaktualizować za pomocą interfejsu, interfejsu API lub plików danych strukturalnych.

To pole musi być przypisane podczas tworzenia nowego elementu zamówienia. W przeciwnym razie żądanie advertisers.lineItems.create nie zostanie zrealizowane.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu LineItem.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.