Method: customers.customInterests.mutate

Crée ou met à jour des centres d'intérêt personnalisés. Les états des opérations sont renvoyés.

Liste des erreurs générées: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. ID du client dont les centres d'intérêt personnalisés sont modifiés.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "operations": [
    {
      object (CustomInterestOperation)
    }
  ],
  "validateOnly": boolean
}
Champs
operations[]

object (CustomInterestOperation)

Obligatoire. Liste des opérations à effectuer sur des centres d'intérêt personnalisés individuels.
validateOnly

boolean

Si la valeur est "true", la requête est validée, mais pas exécutée. Seules les erreurs sont renvoyées, et non les résultats.

Corps de la réponse

Message de réponse pour la modification d'un intérêt personnalisé.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "results": [
    {
      object (MutateCustomInterestResult)
    }
  ]
}
Champs
results[]

object (MutateCustomInterestResult)

Tous les résultats de la mutation.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.

CustomInterestOperation

Une seule opération (création, modification) sur un intérêt personnalisé.

Représentation JSON 
{
  "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.
}
Champs
updateMask

string (FieldMask format)

Masque de champ qui détermine les champs de ressources à modifier lors d'une mise à jour.

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo"
Champ d'union operation. L'opération de modification. operation ne peut être qu'un des éléments suivants :
create

object (CustomInterest)

Opération de création: aucun nom de ressource n'est attendu pour le nouveau centre d'intérêt personnalisé.
update

object (CustomInterest)

Opération de mise à jour: l'intérêt personnalisé doit avoir un nom de ressource valide.

MutateCustomInterestResult

Résultat de la mutation d'intérêt personnalisé.

Représentation JSON 
{
  "resourceName": string
}
Champs
resourceName

string

Retourné pour les opérations réussies.