Aktualisiert mehrere Werbebuchungen
Anfragen an diesen Endpunkt können nicht gleichzeitig mit den folgenden Anfragen erfolgen, um dieselbe Werbebuchung zu aktualisieren:
lineItems.bulkEditAssignedTargetingOptions
lineItems.patch
assignedTargetingOptions.create
assignedTargetingOptions.delete
„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 |
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 ( |
Felder | |
---|---|
lineItemIds[] |
Erforderlich. IDs der zu aktualisierenden Werbebuchungen. |
targetLineItem |
Erforderlich. Ein Werbebuchungsobjekt mit den zu aktualisierenden Feldern und den neuen Werten, die allen in |
updateMask |
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: |
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 ( |
Felder | |
---|---|
updatedLineItemIds[] |
Die IDs erfolgreich aktualisierter Werbebuchungen. |
failedLineItemIds[] |
Die IDs der Werbebuchungen, die nicht aktualisiert werden konnten. |
skippedLineItemIds[] |
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[] |
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.