Method: customers.customInterests.mutate

Erstellt oder aktualisiert benutzerdefinierte Interessen. Es werden Vorgangsstatus zurückgegeben.

Liste der geworfenen Fehler: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError

HTTP-Anfrage

POST https://googleads.googleapis.com/v19/customers/{customerId}/customInterests:mutate

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

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

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object (CustomInterestOperation)

Erforderlich. Die Liste der Vorgänge, die auf einzelne benutzerdefinierte Interessen angewendet werden sollen.
validateOnly

boolean

Wenn „true“, wird die Anfrage validiert, aber nicht ausgeführt. Es werden nur Fehler zurückgegeben, keine Ergebnisse.

Antworttext

Antwortnachricht für die Änderung von benutzerdefinierten Interessen

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

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

object (MutateCustomInterestResult)

Alle Ergebnisse der Mutation.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

CustomInterestOperation

Ein einzelner Vorgang (Erstellen, Aktualisieren) für ein benutzerdefiniertes Interesse.

JSON-Darstellung 
{
  "updateMask": string,

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

string (FieldMask format)

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

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

object (CustomInterest)

Vorgang „Erstellen“: Für das neue benutzerdefinierte Interesse wird kein Ressourcenname erwartet.
update

object (CustomInterest)

Aktualisierungsvorgang: Der benutzerdefinierte Interessenschwerpunkt muss einen gültigen Ressourcennamen haben.

MutateCustomInterestResult

Das Ergebnis für das benutzerdefinierte Interesse wird verändert.

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

string

Wird bei erfolgreichen Vorgängen zurückgegeben.