Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

Mit der Bulk-Bearbeitung können Sie Targeting-Optionen für mehrere Anzeigengruppen bearbeiten.

Derselbe Satz von Lösch- und Erstellungsanfragen wird auf alle angegebenen Anzeigengruppen angewendet. Konkret werden durch den Vorgang die zugewiesenen Targeting-Optionen in BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests aus jeder Anzeigengruppe gelöscht und dann die zugewiesenen Targeting-Optionen in BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests erstellt.

Diese Methode wird nur für Demand Gen-Anzeigengruppen unterstützt.

HTTP-Anfrage

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroups:bulkEditAssignedTargetingOptions

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
advertiserId

string (int64 format)

Erforderlich. Die ID des Werbetreibenden, zu dem die Anzeigengruppen gehören.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "adGroupIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
Felder
adGroupIds[]

string (int64 format)

Erforderlich. Die IDs der Anzeigengruppen, zu denen die zugewiesenen Ausrichtungsoptionen gehören. Es können maximal 25 Anzeigengruppen-IDs angegeben werden.

deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

Optional. Die zugewiesenen Ausrichtungsoptionen, die im Batch gelöscht werden sollen, angegeben als Liste von DeleteAssignedTargetingOptionsRequest.

Unterstützte Targeting-Typen:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO
createRequests[]

object (CreateAssignedTargetingOptionsRequest)

Optional. Die zugewiesenen Targeting-Optionen, die im Batch erstellt werden sollen, angegeben als Liste von CreateAssignedTargetingOptionRequest.

Unterstützte Targeting-Typen:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

Antworttext

Antwortnachricht für adGroups.bulkEditAssignedTargetingOptions.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "updatedAdGroupIds": [
    string
  ],
  "failedAdGroupIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Felder
updatedAdGroupIds[]

string (int64 format)

Nur Ausgabe. Die IDs der Anzeigengruppen, die aktualisiert wurden.

failedAdGroupIds[]

string (int64 format)

Nur Ausgabe. Die IDs der Anzeigengruppen, die nicht aktualisiert werden konnten.

errors[]

object (Status)

Nur Ausgabe. Die Fehlerinformationen für jede Anzeigengruppe, die nicht aktualisiert werden konnte.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/display-video

Weitere Informationen finden Sie unter OAuth 2.0 Overview.