Modificações do serviço de recursos

Usar o serviço individual de um recurso é a maneira mais direta de fazer a mutação, mas também a menos flexível.

Endpoints de mutação

Usar um serviço específico de recurso é a maneira mais direta de fazer a mutação. 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 dentro de um CampaignOperation e o enviaria para o endpoint CampaignService.MutateCampaigns.

Você pode fazer isso em qualquer um dos serviços da API Google Ads. Por exemplo, se você quiser mutar um AdGroup, transmita um AdGroupOperation contendo o AdGroup mutado para o endpoint AdGroupService.MutateAdGroups.

Da mesma forma, se você quiser modificar um CampaignCriterion, use um CampaignCriterionOperation e o 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 independentemente de todas as outras, portanto, nenhuma referência cruzada é permitida.

Isso contrasta com o método de mutação em massa (GoogleAdsService.Mutate), em que as operações na mesma solicitação podem referenciar entidades de outras operações.