Method: customers.keywordPlanCampaignKeywords.mutate

Crée, met à jour ou supprime des mots clés de campagnes du plan de mots clés. Les états des opérations sont renvoyés.

Liste des erreurs générées: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanAdGroupKeywordError KeywordPlanCampaignKeywordError QuotaError RequestError ResourceCountLimitExceededError

Requête HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/keywordPlanCampaignKeywords: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 mots clés de la campagne 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 (KeywordPlanCampaignKeywordOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Champs
operations[]

object (KeywordPlanCampaignKeywordOperation)

Obligatoire. Liste des opérations à effectuer sur les mots clés individuels des campagnes du plan de mots clés.
partialFailure

boolean

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

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 pour la modification du mot clé d'une campagne de plan de mots clés.

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

Représentation JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateKeywordPlanCampaignKeywordResult)
    }
  ]
}
Champs
partialFailureError

object (Status)

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.
results[]

object (MutateKeywordPlanCampaignKeywordResult)

Tous les résultats pour 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.