Modificações do serviço de recursos

Usar o serviço individual de um recurso é a maneira mais simples de modificá-lo, mas também a menos flexível.

Endpoints de modificação

Usar um serviço específico do recurso é a maneira mais simples de modificá-lo. 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 uma nova Campaign. Você criaria um novo Campaign objeto, o colocaria em uma CampaignOperation, e o enviaria ao CampaignService.MutateCampaigns endpoint.

É possível fazer isso para qualquer um dos serviços da API Google Ads. Por exemplo, se você quiser modificar um AdGroup, transmita uma AdGroupOperation que contenha o modificado AdGroup para o AdGroupService.MutateAdGroups endpoint.

Da mesma forma, se você quiser modificar um CampaignCriterion, use um CampaignCriterionOperation e envie-o para o endpoint CampaignCriterionService.MutateCampaignCriteria.

Como o campo operations da solicitação pode ser repetido, uma única solicitação de modificaçã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ência cruzada.

Isso contrasta com o método de modificação em massa (GoogleAdsService.Mutate), em que as operações na mesma solicitação podem fazer referência a entidades de outras operações.