Method: advertisers.lineItems.bulkUpdate

Aktualisiert mehrere Werbebuchungen.

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

„YouTube und Partner“-Werbebuchungen können nicht über die API erstellt oder aktualisiert werden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
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 Zeilenpostenobjekt mit den zu aktualisierenden Feldern und den neuen Werten, die allen in lineItemIds angegebenen Zeilenposten 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 vollständig 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 der erfolgreich aktualisierten Werbebuchungen.
failedLineItemIds[]

string (int64 format)

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

string (int64 format)

Die IDs der Werbebuchungen, die bei Updates übersprungen werden. Beispielsweise werden unnötige Mutationen, die keine Änderungen an Werbebuchungen zur Folge haben, übersprungen. Die entsprechenden Werbebuchungs-IDs können hier nachverfolgt werden.
errors[]

object (Status)

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.