Method: advertisers.lineItems.bulkUpdate

Aktualisiert mehrere Werbebuchungen.

Anfragen an diesen Endpunkt können nicht gleichzeitig mit den folgenden Anfragen zur Aktualisierung derselben Werbebuchung gesendet werden:

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 Werbebuchungsobjekt mit den Feldern, die aktualisiert werden sollen, 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 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 für Aktualisierungen übersprungen werden. Beispielsweise werden unnötige Änderungen, die praktisch keine Änderungen an Werbebuchungen zur Folge haben, ü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.