Method: customers.merchantCenterLinks.mutate

Met à jour l'état ou supprime une association à un compte Merchant Center.

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

Requête HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/merchantCenterLinks:mutate

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. Identifiant du client faisant l'objet de la 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 (MerchantCenterLinkOperation)
  },
  "validateOnly": boolean
}
Champs
operation

object (MerchantCenterLinkOperation)

Obligatoire. L'opération à effectuer sur le lien
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 concernant la mutation d'une association à Merchant Center

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 (MutateMerchantCenterLinkResult)
  }
}
Champs
result

object (MutateMerchantCenterLinkResult)

Résultat de 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.

MerchantCenterLinkOperation

Une seule mise à jour concernant une association à Merchant Center.

Représentation JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (MerchantCenterLink)
  },
  "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 permettant d'effectuer operation ne peut être que l'un des éléments suivants:
update

object (MerchantCenterLink)

Opération de mise à jour: le lien Merchant Center doit comporter un nom de ressource valide.
remove

string

Opération de suppression: un nom de ressource pour le lien Merchant Center supprimé est attendu, au format suivant:

customers/{customerId}/merchantCenterLinks/{merchantCenterId}

MutateMerchantCenterLinkResult

Résultat de la mutation de l'association à Merchant Center.

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

string

Retourné pour les opérations réussies.