Method: customers.customerManagerLinks.mutate

Met à jour les associations des gestionnaires de clientèle. Les états des opérations sont renvoyés.

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

Requête HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/customerManagerLinks: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 les associations de compte de gestion de clientèle 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 (CustomerManagerLinkOperation)
    }
  ],
  "validateOnly": boolean
}
Champs
operations[]

object (CustomerManagerLinkOperation)

Obligatoire. Liste des opérations à effectuer sur les différents liens de gestion de clientèle.
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 à une opération de mutate CustomerManagerLink.

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

object (MutateCustomerManagerLinkResult)

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.

CustomerManagerLinkOperation

Met à jour l'état d'un CustomerManagerLink. Les actions suivantes sont possibles: 1. L'opération de mise à jour dont l'état est ACTIVE accepte une invitation en attente. 2. L'opération de mise à jour dont l'état est REFUSE refuse une invitation en attente. 3. L'opération de mise à jour dont l'état est INACTIVE met fin à l'association au gestionnaire.

Représentation JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (CustomerManagerLink)
  }
  // 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 :
update

object (CustomerManagerLink)

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

MutateCustomerManagerLinkResult

Résultat de la mutation de l'association du gestionnaire de clients.

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

string

Retourné pour les opérations réussies.