Method: advertisers.lineItems.bulkUpdate

Aktualizuje wiele elementów zamówienia.

Żądania do tego punktu końcowego nie mogą być wysyłane równocześnie z tymi żądaniami aktualizowania tego samego elementu zamówienia:

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:bulkUpdate

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
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
Pola
lineItemIds[]

string (int64 format)

Wymagane. Identyfikatory elementów zamówienia do zaktualizowania.

targetLineItem

object (LineItem)

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 lineItemIds.

updateMask

string (FieldMask format)

Wymagane. Maska pola określająca pola do zaktualizowania.

Obecnie obsługiwane są tylko te pola:

Jest to lista pełnych nazw pól rozdzielona przecinkami. Przykład: "user.displayName,photo".

Treść odpowiedzi

Komunikat odpowiedzi na temat elementu LineItemService.BulkUpdateLineItems.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Pola
updatedLineItemIds[]

string (int64 format)

Identyfikatory zaktualizowanych elementów zamówienia.

failedLineItemIds[]

string (int64 format)

Identyfikatory elementów zamówienia, których nie udało się zaktualizować.

skippedLineItemIds[]

string (int64 format)

Identyfikatory elementów zamówienia, które są pomijane przy aktualizacjach. Na przykład niepotrzebne mutacje, które nie spowodują żadnych zmian w elementach zamówienia, zostaną pominięte. W tym miejscu można śledzić odpowiadające im identyfikatory elementów zamówienia.

errors[]

object (Status)

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.