Utiliser le service individuel d'une ressource est le moyen le plus simple de la modifier, mais aussi le moins flexible.
Points de terminaison de mutation
L'utilisation d'un service spécifique aux ressources est la méthode la plus simple pour effectuer une mutation. Chaque ressource mutable est associée à un service et à un ensemble d'opérations qui vous permettent de créer, de mettre à jour ou de supprimer la ressource.
Supposons que vous souhaitiez créer un Campaign
.
Vous devez créer un objet Campaign
, le placer dans un CampaignOperation
, puis l'envoyer au point de terminaison CampaignService.MutateCampaigns
.
Vous pouvez le faire pour n'importe quel service de l'API Google Ads. Par exemple, si vous souhaitez modifier un AdGroup
, vous devez transmettre un AdGroupOperation
contenant le AdGroup
modifié au point de terminaison AdGroupService.MutateAdGroups
.
De même, si vous souhaitez modifier un CampaignCriterion
, vous devez utiliser un CampaignCriterionOperation
et l'envoyer au point de terminaison CampaignCriterionService.MutateCampaignCriteria
.
Étant donné que le champ operations
de la requête peut être répété, une seule requête mutate peut contenir plusieurs opérations. Toutefois, chaque opération est traitée indépendamment des autres. Aucune référence croisée n'est donc autorisée.
Cela contraste avec la méthode de mutation groupée (GoogleAdsService.Mutate
), où les opérations d'une même requête peuvent faire référence à des entités d'autres opérations.