Method: customers.customAudiences.mutate

Benutzerdefinierte Zielgruppen erstellen oder aktualisieren Vorgangsstatus werden zurückgegeben.

Liste der geworfenen Fehler: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError InternalError MutateError OperationAccessDeniedError PolicyViolationError{225PolicyError HeaderErrorRequestError

HTTP-Anfrage

POST https://googleads.googleapis.com/v14/customers/{customerId}/customAudiences:mutate

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Erforderlich. Die ID des Kunden, dessen benutzerdefinierte Zielgruppen geändert werden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "operations": [
    {
      object (CustomAudienceOperation)
    }
  ],
  "validateOnly": boolean
}
Felder
operations[]

object (CustomAudienceOperation)

Erforderlich. Die Liste der Vorgänge, die für einzelne benutzerdefinierte Zielgruppen ausgeführt werden sollen.
validateOnly

boolean

Falls wahr, wird die Anfrage validiert, aber nicht ausgeführt. Es werden nur Fehler zurückgegeben, keine Ergebnisse.

Antworttext

Antwortnachricht für benutzerdefinierte Zielgruppe mutate.

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

JSON-Darstellung 
{
  "results": [
    {
      object (MutateCustomAudienceResult)
    }
  ]
}
Felder
results[]

object (MutateCustomAudienceResult)

Alle Ergebnisse für die mutate.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/adwords

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

CustomAudienceOperation

Ein einzelner Vorgang (Erstellen, Aktualisieren) für eine benutzerdefinierte Zielgruppe.

JSON-Darstellung 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (CustomAudience)
  },
  "update": {
    object (CustomAudience)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Felder
updateMask

string (FieldMask format)

FieldMask, die bestimmt, welche Ressourcenfelder bei einer Aktualisierung geändert werden.

Dies ist eine durch Kommas getrennte Liste voll qualifizierter Feldnamen. Beispiel: "user.displayName,photo".
Union-Feld operation. Der mutate-Vorgang. Für operation ist nur einer der folgenden Werte zulässig:
create

object (CustomAudience)

Erstellungsvorgang: Für die neue benutzerdefinierte Zielgruppe wird kein Ressourcenname erwartet.
update

object (CustomAudience)

Aktualisierungsvorgang: Die benutzerdefinierte Zielgruppe muss einen gültigen Ressourcennamen haben.
remove

string

Entfernen: Es wird ein Ressourcenname für die entfernte benutzerdefinierte Zielgruppe im folgenden Format erwartet:

customers/{customerId}/customAudiences/{custom_audience_id}

MutateCustomAudienceResult

Das Ergebnis der „mutate“-Methode der benutzerdefinierten Zielgruppe.

JSON-Darstellung 
{
  "resourceName": string
}
Felder
resourceName

string

Wird für erfolgreiche Vorgänge zurückgegeben.