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:
insertionOrderTypezamówienia reklamowegoautomationTypezamó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.