Method: customers.accountLinks.mutate

Crée ou supprime une association de compte. À partir de la version 5, la création n'est plus prise en charge via AccountLinkService.MutateAccountLink. Utilisez plutôt AccountLinkService.CreateAccountLink.

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

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. ID du client 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 (AccountLinkOperation)
  },
  "partialFailure": boolean,
  "validateOnly": boolean
}
Champs
operation

object (AccountLinkOperation)

Obligatoire. Opération à effectuer sur le lien.
partialFailure

boolean

Si la valeur est définie sur "true", les opérations réussies sont effectuées et les opérations non valides renvoient des erreurs. Si la valeur est "false", toutes les opérations sont effectuées dans une seule transaction si et seulement si elles sont toutes valides. La valeur par défaut est "false".
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 de l'association de compte.

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 (MutateAccountLinkResult)
  },
  "partialFailureError": {
    object (Status)
  }
}
Champs
result

object (MutateAccountLinkResult)

Résultat de la mutation.
partialFailureError

object (Status)

Erreurs liées aux échecs d'opérations en mode échec partiel. N'est renvoyé que lorsque "partialFailure" est défini sur "true" et que toutes les erreurs se produisent dans les opérations. Si des erreurs se produisent en dehors des opérations (par exemple, des erreurs d'authentification), nous renvoyons une erreur au niveau de l'RPC.

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.

AccountLinkOperation

Une seule mise à jour sur une association de compte.

Représentation JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (AccountLink)
  },
  "remove": string
  // 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. Opération à effectuer. operation ne peut être qu'un des éléments suivants :
update

object (AccountLink)

Opération de mise à jour: le nom de la ressource de l'association de compte doit être valide.
remove

string

Opération de suppression: un nom de ressource pour l'association de compte à supprimer est attendu, au format suivant:

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

Le résultat de l'association de comptes est modifié.

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

string

Retourné pour les opérations réussies.