Na API Google Ads, alguns campos de mensagem são definidos como objetos de mensagem vazios,
como campaign.manual_cpm,
ou podem ter apenas campos opcionais que não precisam ser definidos, por exemplo,
campaign.manual_cpc Definir estas
é importante para informar à API qual estratégia de lances usar para o dado
campanha, mas não é intuitivo quando as mensagens estão vazias.
Ao atualizar o campo campaign.name, que é uma string, definimos o campo
atualizando-o diretamente como se fosse um atributo normal de objeto Python:
campaign.name = "Test campaign value"
campaign.manual_cpc é um campo aninhado, o que significa que ele contém
outra mensagem protobuf e não um tipo primitivo, como uma string. Você
também pode atualizar os campos diretamente:
campaign.manual_cpc.enhanced_cpc_enabled = True
Isso vai informar à API que a campanha tem uma estratégia de lances de manual_cpc
com o CPC otimizado ativado.
Mas e se você quiser usar manual_cpm, que fica vazio? Ou manual_cpc
sem ativar o CPC otimizado? Para fazer isso, será necessário copiar um
instância vazia da classe na campanha, por exemplo:
client = GoogleAdsClient.load_from_storage()
empty_cpm = client.get_type('ManualCpm')
client.copy_from(campaign.manual_cpm, empty_cpm)
Observe como manual_cpm é especificado para o objeto campaign:
name {
value: "Test campaign value"
}
manual_cpm {
}
O campo manual_cpm está definido, mas nenhum dos campos tem valores. Ao enviar
solicitação à API que usa esse padrão, você pode verificar se está definindo o
objeto de mensagem vazio corretamente ativando logging e inspecionando o
payload da solicitação.
Por fim, você precisará adicionar manualmente esse campo ao objeto
update_mask: O assistente da máscara de campo não tem mecanismo para determinar o
diferença entre um campo que foi definido explicitamente como um objeto vazio e uma
que não foi definido.
from google.api_core.protobuf_helpers import field_mask
campaign_operation.create = campaign
campaign_operation.update_mask = field_mask(None, campaign)
# Here we manually add the "manual_cpm" field
campaign_operation.update_mask.append("manual_cpm")