- 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
- CustomerAssetSetOperation
- MutateCustomerAssetSetResult
- Essayer
Crée ou supprime des ensembles de composants client. Les états des opérations sont renvoyés.
Requête HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}/customerAssetSets:mutate
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
customerId |
Obligatoire. Identifiant du client dont les ensembles de composants du client 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 ensembles de composants spécifiques à chaque client. |
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 en 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. |
responseContentType |
Paramètre de type de contenu de la réponse. Détermine si la ressource modifiable ou uniquement son nom doit être renvoyé après la mutation. |
Corps de la réponse
Message de réponse pour une opération de mutate sur l'élément client.
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 pour la méthode mutate. |
partialFailureError |
Erreurs liées aux échecs d'opération en mode d'échec partiel. Renvoyée uniquement lorsque partialFailure = true et que toutes les erreurs se produisent dans les opérations. Si des erreurs se produisent en dehors des opérations (erreurs d'authentification, par exemple), nous renvoyons une erreur au niveau du 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.
CustomerAssetSetOperation
Opération unique (créer, supprimer) sur un ensemble de composants client.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union operation . L'opération mutate. 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 de composants du nouvel ensemble de clients. |
remove |
Opération de suppression: le nom de ressource attendu pour l'ensemble de composants client supprimé doit respecter le format suivant: |
MutateCustomerAssetSetResult
Résultat de la commande mutate de l'ensemble de composants client.
Représentation JSON |
---|
{
"resourceName": string,
"customerAssetSet": {
object ( |
Champs | |
---|---|
resourceName |
Est renvoyé pour les opérations réussies. |
customerAssetSet |
Élément client ayant fait l'objet d'une modification et ne contenant que des champs modifiables après cette opération. Le champ n'est renvoyé que lorsque responseContentType est défini sur "MUTABLE_RESOURCE". |