- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- AccountLinkOperation
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- MutateAccountLinkResult
<ph type="x-smartling-placeholder">
- </ph>
- Représentation JSON
- Essayer
Crée ou supprime une association de comptes. À 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/v17/customers/{customerId}/accountLinks:mutate
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
customerId |
Obligatoire. Identifiant 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 ( |
Champs | |
---|---|
operation |
Obligatoire. Opération à effectuer sur le lien. |
partialFailure |
Si la valeur est "true", des opérations réussies seront effectuées et les opérations non valides renverront des erreurs. Si la valeur est "false", toutes les opérations seront exécutées en une seule transaction si et seulement si elles sont toutes valides. La valeur par défaut est "false". |
validateOnly |
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'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 ( |
Champs | |
---|---|
result |
Résultat pour la méthode mutate. |
partialFailureError |
Erreurs liées aux échecs d'opérations en mode d'échec partiel. N'est renvoyé que lorsque partialFailure est défini sur "true" et que toutes les erreurs se produisent au sein des opérations. Si des erreurs se produisent en dehors des opérations (par exemple, des erreurs d'authentification), une erreur au niveau RPC est renvoyée. |
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.
AccountLinkOperation
Une seule mise à jour sur une association de compte.
Représentation JSON |
---|
{ "updateMask": string, // Union field |
Champs | |
---|---|
updateMask |
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 : |
Champ d'union operation . Opération à effectuer. operation ne peut être qu'un des éléments suivants : |
|
update |
Opération de mise à jour: le lien vers le compte doit disposer d'un nom de ressource valide. |
remove |
Opération de suppression: un nom de ressource pour l'association de compte à supprimer est attendu, au format suivant:
|
MutateAccountLinkResult
Résultat de la modification de l'association de comptes.
Représentation JSON |
---|
{ "resourceName": string } |
Champs | |
---|---|
resourceName |
Renvoyé pour les opérations réussies. |