Aktualisiert mehrere Werbebuchungen
Anfragen an diesen Endpunkt können nicht gleichzeitig mit den folgenden Anfragen erfolgen, mit denen dieselbe Werbebuchung aktualisiert wird:
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/v3/advertisers/{advertiserId}/lineItems:bulkUpdate
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
advertiserId |
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 ( |
Felder | |
---|---|
lineItemIds[] |
Erforderlich. IDs der zu aktualisierenden Werbebuchungen |
targetLineItem |
Erforderlich. Ein Werbebuchungsobjekt, das die zu aktualisierenden Felder und die neuen Werte enthält, 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 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[] |
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.