Method: advertisers.lineItems.bulkUpdate

Mehrere Werbebuchungen werden aktualisiert.

Anfragen an diesen Endpunkt können nicht gleichzeitig mit den folgenden Anfragen gestellt werden, 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 Anzeigenblockobjekt mit den zu aktualisierenden Feldern und den neuen Werten, die allen in lineItemIds angegebenen Anzeigenblöcken 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 Werbebuchungen, die erfolgreich aktualisiert wurden.
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. Unnötige Änderungen, die praktisch keine Auswirkungen auf Werbebuchungen haben, werden beispielsweise übersprungen. Die entsprechenden Werbebuchungs-IDs können hier verfolgt 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 OAuth 2.0-Übersicht.