Aktualizuje wiele elementów zamówienia.
Żądania wysyłane do tego punktu końcowego nie mogą być wysyłane jednocześnie z tymi żądaniami powodującymi aktualizację tego samego elementu zamówienia:
lineItems.bulkEditAssignedTargetingOptions
lineItems.patch
assignedTargetingOptions.create
assignedTargetingOptions.delete
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:bulkUpdate
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
advertiserId |
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 |
---|
{
"lineItemIds": [
string
],
"targetLineItem": {
object ( |
Pola | |
---|---|
lineItemIds[] |
To pole jest wymagane. Identyfikatory elementów zamówienia do zaktualizowania. |
targetLineItem |
To pole jest wymagane. Obiekt elementu zamówienia zawierający pola do zaktualizowania i nowe wartości do przypisania do wszystkich elementów zamówienia określonych w elemencie |
updateMask |
To pole jest wymagane. Maska pola określająca pola do zaktualizowania. Obecnie obsługiwane są tylko te pola: Jest to lista rozdzielonych przecinkami pełnych i jednoznacznych nazw pól. Przykład: |
Treść odpowiedzi
Komunikat odpowiedzi dla obiektu LineItemService.BulkUpdateLineItems.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"skippedLineItemIds": [
string
],
"errors": [
{
object ( |
Pola | |
---|---|
updatedLineItemIds[] |
Identyfikatory zaktualizowanych elementów zamówienia. |
failedLineItemIds[] |
Identyfikatory elementów zamówienia, których nie udało się zaktualizować. |
skippedLineItemIds[] |
Identyfikatory elementów zamówienia, które są pomijane podczas aktualizacji. Na przykład niepotrzebne mutacje, które w rzeczywistości nie spowodują, że zmiany w elementach zamówienia zostaną pominięte, a w tym miejscu będzie można śledzić odpowiadające im identyfikatory elementów zamówienia. |
errors[] |
Błędy zwrócone przez elementy zamówienia, których nie udało się zaktualizować. |
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.