Method: advertisers.lineItems.bulkUpdate

Aktualisiert mehrere Werbebuchungen

Anfragen an diesen Endpunkt können nicht gleichzeitig mit den folgenden Anfragen erfolgen, mit denen dieselbe Werbebuchung aktualisiert wird:

„YouTube und Partner“-Werbebuchungen können nicht mit der 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. 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, das die zu aktualisierenden Felder und die neuen Werte enthält, 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 der Werbebuchungen, die bei Aktualisierungen übersprungen werden. Beispielsweise werden unnötige Änderungen, durch die keine Änderungen an Werbebuchungen zur Folge haben, übersprungen und die zugehörigen 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.