- 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
- Essayer
Crée, met à jour ou supprime les groupes d'annonces 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 FieldMaskError HeaderError InternalError KeywordPlanAdGroupError KeywordPlanError MutateError NewResourceCreationErrorRequestErrorResourceCountLimitExceededError
Requête HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}/keywordPlanAdGroups:mutate
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
customerId |
Obligatoire. ID du client dont les groupes d'annonces du plan de mots clés 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 ( |
Champs | |
---|---|
operations[] |
Obligatoire. Liste des opérations à effectuer sur des groupes d'annonces individuels du plan de mots clés. |
partialFailure |
Si la valeur est "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 seront effectuées dans 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 une opération de mutate du groupe d'annonces du 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 ( |
Champs | |
---|---|
partialFailureError |
Erreurs liées à des échecs d'opération en mode échec partiel. Est renvoyé uniquement lorsque partialFailure = true et que toutes les erreurs se produisent à l'intérieur des opérations. Si des erreurs se produisent en dehors des opérations (erreurs d'authentification, par exemple), une erreur au niveau du RPC est renvoyée. |
results[] |
Tous les résultats pour la méthode mutate. L'ordre des résultats est déterminé par l'ordre des mots clés dans la demande d'origine. |
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.