Method: advertisers.lineItems.generateDefault

Tworzy nowy element zamówienia z ustawieniami (w tym kierowaniem) odziedziczonymi z zamówienia reklamowego i entityStatus (ENTITY_STATUS_DRAFT). Zwraca nowo utworzony element zamówienia, jeśli operacja się uda. Domyślne wartości zależą od tych 3 pól:

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)

To pole jest 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)

To pole jest wymagane. Unikalny identyfikator zamówienia reklamowego, do którego należy element zamówienia.
displayName

string

To pole jest wymagane. Wyświetlana nazwa elementu zamówienia.

Musi być zakodowany w formacie UTF-8 o maksymalnym rozmiarze 240 bajtów.
lineItemType

enum (LineItemType)

To pole jest wymagane. Typ elementu zamówienia.
mobileApp

object (MobileApp)

Aplikacja mobilna promowana przez element zamówienia.

Ma zastosowanie tylko wtedy, gdy 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 protokołu OAuth 2.0.