Method: advertisers.lineItems.bulkUpdate

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:

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/v2/advertisers/{advertiserId}/lineItems:bulkUpdate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
advertiserId

string (int64 format)

To pole jest 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)

To pole jest wymagane. Identyfikatory elementów zamówienia do zaktualizowania.
targetLineItem

object (LineItem)

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

string (FieldMask format)

To pole jest wymagane. Maska pola wskazująca pola do zaktualizowania.

Obecnie obsługiwane są tylko te pola:

Jest to rozdzielona przecinkami lista pełnych i jednoznacznych nazw pól. 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 pomijanych w przypadku aktualizacji. Na przykład niepotrzebne mutacje, które w rezultacie nie spowodują, że zmiany 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 omówieniu protokołu OAuth 2.0.