Method: advertisers.lineItems.bulkUpdate

Aktualizuje wiele elementów zamówienia.

Żądań wysyłanych do tego punktu końcowego nie można wysyłać równocześnie z tymi żądaniami, które aktualizują ten sam element zamówienia:

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

string (int64 format)

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

string (int64 format)

Wymagany. Identyfikatory elementów zamówienia do zaktualizowania.
targetLineItem

object (LineItem)

Wymagany. Obiekt elementu zamówienia zawierający pola do zaktualizowania i nowe wartości do przypisania do wszystkich elementów zamówienia określonych w lineItemIds”.
updateMask

string (FieldMask format)

Wymagany. Maska pola określająca, które pola mają zostać zaktualizowane.

Obecnie obsługiwane są tylko te pola:

Jest to lista w pełni kwalifikowanych nazw pól rozdzielonych przecinkami. Przykład: "user.displayName,photo".

Treść odpowiedzi

Komunikat odpowiedzi dla 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 zostały pominięte podczas aktualizacji. Na przykład niepotrzebne zmiany, które nie spowodują żadnych zmian w elementach zamówienia, zostaną pominięte, a odpowiednie identyfikatory elementów zamówienia można śledzić tutaj.
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 sekcji OAuth 2.0 Overview.