Usar o serviço individual de um recurso é a maneira mais direta de fazer mutações nele, mas também a menos flexível.
Endpoints de mutação
Usar um serviço específico de recursos é a maneira mais direta de fazer mutações. Cada recurso mutável tem um serviço correspondente e um conjunto de operações que permitem criar, atualizar ou remover o recurso.
Suponha que você queira criar um novo Campaign
.
Você criaria um novo objeto Campaign
, colocaria em um CampaignOperation
e enviaria para o endpoint CampaignService.MutateCampaigns
.
Você pode fazer isso com qualquer um dos serviços da API Google Ads. Por exemplo, se você quiser
mudar um AdGroup
, transmita um
AdGroupOperation
que contenha o
AdGroup
mutado para o
endpoint AdGroupService.MutateAdGroups
.
Da mesma forma, se quiser modificar um CampaignCriterion
, use um
CampaignCriterionOperation
e envie para o endpoint
CampaignCriterionService.MutateCampaignCriteria
.
Como o campo operations
da solicitação pode ser repetido, uma única solicitação de mutação
pode conter várias operações. No entanto, cada operação é tratada de forma independente de todas as outras, portanto, não é permitido fazer referências cruzadas.
Isso contrasta com o método de mutação em massa
(GoogleAdsService.Mutate
),
em que operações na mesma solicitação podem referenciar entidades de outras
operações.