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). Jeśli funkcja się uda, zwraca nowo utworzony element zamówienia. Na podstawie tych 3 pól dostępne są wartości domyślne:

YouTube i Elementów zamówienia typu „Partnerzy” 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 dany 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 standardzie UTF-8 i maksymalnym rozmiarze 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 lineItemType to 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 protokołu OAuth 2.0.