Method: customers.campaignCriteria.mutate

Crée, met à jour ou supprime des critères. Les états des opérations sont renvoyés.

Liste des erreurs générées: AdxError AuthenticationError AuthorizationError CampaignCriterionError CollectionSizeError ContextError CriterionError DatabaseError DistinctError FieldError FieldMaskError FunctionError HeaderError IdError InternalError MutateError NewResourceCreationError NotEmptyError NullError OperationAccessDeniedError OperatorError QuotaError RangeError RegionCodeError RequestError ResourceCountLimitExceededError SizeLimitError StringFormatError StringLengthError

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. ID du client dont les critères sont modifiés.

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 (CampaignCriterionOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Champs
operations[]

object (CampaignCriterionOperation)

Obligatoire. Liste des opérations à effectuer sur des critères individuels.
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.
responseContentType

enum (ResponseContentType)

Paramètre du type de contenu de la réponse. Détermine si la ressource modifiable ou uniquement le nom de la ressource doit être renvoyé après la mutation.

Corps de la réponse

Message de réponse pour la modification des critères de campagne.

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

object (MutateCampaignCriterionResult)

Tous les résultats de la 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 OAuth 2.0 Overview.