- 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
- AdGroupAssetSetOperation
- MutateAdGroupAssetSetResult
- Essayer
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 |
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 ( |
Champs | |
---|---|
operations[] |
Obligatoire. Liste des opérations à effectuer sur des ensembles d'assets de groupes d'annonces individuels. |
partialFailure |
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 |
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 |
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 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 ( |
Champs | |
---|---|
results[] |
Tous les résultats de la mutation. |
partialFailureError |
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. |
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.
AdGroupAssetSetOperation
Une seule opération (création, suppression) sur un ensemble d'assets de groupe d'annonces.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union operation . L'opération de modification. operation ne peut être qu'un des éléments suivants : |
|
create |
Opération de création: aucun nom de ressource n'est attendu pour l'ensemble d'assets du nouveau groupe d'annonces. |
remove |
Opération de suppression: un nom de ressource pour l'ensemble d'assets du groupe d'annonces supprimé est attendu, au format suivant: |
MutateAdGroupAssetSetResult
Le résultat de l'ensemble d'éléments du groupe d'annonces est modifié.
Représentation JSON |
---|
{
"resourceName": string,
"adGroupAssetSet": {
object ( |
Champs | |
---|---|
resourceName |
Retourné pour les opérations réussies. |
adGroupAssetSet |
Composant de groupe d'annonces muté avec uniquement des champs modifiables après la mutation. Le champ ne sera renvoyé que lorsque responseContentType est défini sur "MUTABLE_RESOURCE". |