Method: customers.adGroupAssetSets.mutate

Crée ou supprime des ensembles d'assets de groupe d'annonces. Les états des opérations sont renvoyés.

Requête HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/adGroupAssetSets: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 ensembles d'assets de groupe d'annonces 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 (AdGroupAssetSetOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Champs
operations[]

object (AdGroupAssetSetOperation)

Obligatoire. Liste des opérations à effectuer sur des ensembles d'assets de groupes d'annonces spécifiques.
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 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, et non les résultats.
responseContentType

enum (ResponseContentType)

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

Corps de la réponse

Message de réponse pour la modification d'un ensemble d'éléments de groupe d'annonces

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

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

object (MutateAdGroupAssetSetResult)

Tous les résultats de la mutation.
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 au sein des 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.

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.

AdGroupAssetSetOperation

Une seule opération (création, suppression) sur un ensemble d'assets d'un groupe d'annonces.

Représentation JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (AdGroupAssetSet)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Champs
Champ d'union operation. L'opération de modification. operation ne peut être qu'un des éléments suivants :
create

object (AdGroupAssetSet)

Opération de création : aucun nom de ressource n'est attendu pour l'ensemble d'assets du nouveau groupe d'annonces.
remove

string

Opération de suppression : un nom de ressource pour l'ensemble d'assets du groupe d'annonces supprimé est attendu, au format suivant : customers/{customerId}/adGroupAssetSets/{adGroupId}~{asset_set_id}.

MutateAdGroupAssetSetResult

Le résultat de l'ensemble d'éléments du groupe d'annonces est modifié.

Représentation JSON 
{
  "resourceName": string,
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  }
}
Champs
resourceName

string

Renvoyé pour les opérations réussies.
adGroupAssetSet

object (AdGroupAssetSet)

L'asset de groupe d'annonces muté ne contient que des champs modifiables après la mutation. Le champ ne sera renvoyé que lorsque responseContentType est défini sur "MUTABLE_RESOURCE".