Method: customers.customerClientLinks.mutate

Crée ou met à jour un lien vers un client client. Les états des opérations sont renvoyés.

Liste des erreurs générées: AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError ManagerLinkError MutateError NewResourceCreationError QuotaErrorRequestError

Requête HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/customerClientLinks:mutate

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. Identifiant du client dont l'association avec le client est 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 
{
  "operation": {
    object (CustomerClientLinkOperation)
  },
  "validateOnly": boolean
}
Champs
operation

object (CustomerClientLinkOperation)

Obligatoire. Opération à effectuer sur le CustomerClientLink individuel.
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 à un objet mutate CustomerClientLink.

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

Représentation JSON 
{
  "result": {
    object (MutateCustomerClientLinkResult)
  }
}
Champs
result

object (MutateCustomerClientLinkResult)

Un résultat qui identifie la ressource affectée par la demande de 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 la présentation d'OAuth 2.0.

CustomerClientLinkOperation

Opération unique (création, mise à jour) sur CustomerClientLink.

Représentation JSON 
{
  "updateMask": string,

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

string (FieldMask format)

FieldMask qui détermine les champs de ressources modifiés dans 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 mutate. operation ne peut être qu'un des éléments suivants :
create

object (CustomerClientLink)

Opération de création: aucun nom de ressource n'est attendu pour le nouveau lien.
update

object (CustomerClientLink)

Opération de mise à jour: le lien doit contenir un nom de ressource valide.

MutateCustomerClientLinkResult

Résultat de la opération de mutation d'un lien client unique.

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

string

Est renvoyé pour les opérations réussies.