Method: customers.customAudiences.mutate

Crée ou met à jour des audiences personnalisées. Les états des opérations sont renvoyés.

Liste des erreurs générées: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError InternalError MutateError OperationAccessDeniedError PolicyViolationErrorQuotaErrorRequestError

Requête HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/customAudiences: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 audiences personnalisées sont en cours de modification.

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 (CustomAudienceOperation)
    }
  ],
  "validateOnly": boolean
}
Champs
operations[]

object (CustomAudienceOperation)

Obligatoire. Liste des opérations à effectuer sur des audiences personnalisées individuelles.
validateOnly

boolean

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

Corps de la réponse

Message de réponse pour la modification de l'audience personnalisée.

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 (MutateCustomAudienceResult)
    }
  ]
}
Champs
results[]

object (MutateCustomAudienceResult)

Tous les résultats pour la méthode mutate.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

CustomAudienceOperation

Une seule opération (création, mise à jour) sur une audience personnalisée.

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

string (FieldMask format)

FieldMask qui détermine les champs de ressource modifiés dans une mise à jour.

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

object (CustomAudience)

Opération de création: aucun nom de ressource n'est attendu pour la nouvelle audience personnalisée.
update

object (CustomAudience)

Opération de mise à jour: l'audience personnalisée doit disposer d'un nom de ressource valide.
remove

string

Opération de suppression: un nom de ressource pour l'audience personnalisée supprimée est attendu, au format suivant:

customers/{customerId}/customAudiences/{custom_audience_id}

MutateCustomAudienceResult

Résultat de la modification de l'audience personnalisée.

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

string

Retourné pour les opérations réussies.