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:
insertionOrderType
zamówienia reklamowegoautomationType
zamówienia reklamowego- Podana wartość
lineItemType
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/v2/advertisers/{advertiserId}/lineItems:generateDefault
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
advertiserId |
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 ( |
Pola | |
---|---|
insertionOrderId |
Wymagane. Unikalny identyfikator zamówienia reklamowego, do którego należy element zamówienia. |
displayName |
Wymagane. Wyświetlana nazwa elementu zamówienia. Musi być zakodowany w standardzie UTF-8 i maksymalnym rozmiarze 240 bajtów. |
lineItemType |
Wymagane. Typ elementu zamówienia. |
mobileApp |
Aplikacja mobilna promowana przez element zamówienia. Ma to zastosowanie tylko wtedy, gdy |
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.