Method: advertisers.lineItems.generateDefault

Tworzy nowy element zamówienia z ustawieniami (w tym kierowaniem) odziedziczonymi z zamówienia reklamowego i elementu entityStatus (ENTITY_STATUS_DRAFT). W przypadku powodzenia zwraca nowo utworzony element zamówienia. Dostępne są wartości domyślne oparte na 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)
  }
}
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.

Dotyczy to tylko sytuacji, gdy element lineItemType ma wartość LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL lub LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.

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 artykule Omówienie OAuth 2.0.