Method: advertisers.lineItems.bulkUpdate

Aktualisiert mehrere Werbebuchungen

Anfragen an diesen Endpunkt können nicht gleichzeitig mit den folgenden Anfragen erfolgen, um dieselbe Werbebuchung zu aktualisieren:

„YouTube und Partner“-Werbebuchungen können nicht mit der API erstellt oder aktualisiert werden.

HTTP-Anfrage

POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems:bulkUpdate

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameters
advertiserId

string (int64 format)

Erforderlich. Die ID des Werbetreibenden, zu dem diese Werbebuchung gehört.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
Felder
lineItemIds[]

string (int64 format)

Erforderlich. IDs der zu aktualisierenden Werbebuchungen.
targetLineItem

object (LineItem)

Erforderlich. Ein Werbebuchungsobjekt mit den zu aktualisierenden Feldern und den neuen Werten, die allen in lineItemIds angegebenen Werbebuchungen zugewiesen werden sollen.
updateMask

string (FieldMask format)

Erforderlich. Eine Feldmaske, die angibt, welche Felder aktualisiert werden sollen.

Derzeit werden nur die folgenden Felder unterstützt:

Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: "user.displayName,photo".

Antworttext

Antwortnachricht für LineItemService.BulkUpdateLineItems.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Felder
updatedLineItemIds[]

string (int64 format)

Die IDs erfolgreich aktualisierter Werbebuchungen.
failedLineItemIds[]

string (int64 format)

Die IDs der Werbebuchungen, die nicht aktualisiert werden konnten.
skippedLineItemIds[]

string (int64 format)

Die IDs von Werbebuchungen, die zur Aktualisierung übersprungen werden. Beispielsweise werden unnötige Änderungen, die dazu führen, dass keine Änderungen an den Werbebuchungen vorgenommen werden, übersprungen und die entsprechenden Werbebuchungs-IDs können hier erfasst werden.
errors[]

object (Status)

Fehler, die von Werbebuchungen zurückgegeben wurden, die nicht aktualisiert werden konnten

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/display-video

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.