Nell'API Google Ads alcuni campi dei messaggi sono definiti come oggetti messaggio vuoti,
ad esempio campaign.manual_cpm,
oppure potrebbero avere solo campi facoltativi che non devono essere impostati, ad esempio
campaign.manual_cpc.
L'impostazione di questi campi è importante per indicare all'API quale strategia di offerta utilizzare
per la campagna specificata, ma non è intuitiva quando i messaggi sono vuoti.
Quando aggiorniamo il campo campaign.name, che è una stringa, impostiamo il campo
aggiornandolo direttamente come se fosse un normale attributo dell'oggetto Python:
campaign.name = "Test campaign value"
campaign.manual_cpc è un campo nidificato, il che significa che contiene
un altro messaggio protobuf e non un tipo primitivo, come una stringa. Puoi anche aggiornare direttamente i suoi campi:
campaign.manual_cpc.enhanced_cpc_enabled = True
In questo modo, l'API saprà che questa campagna ha una strategia di offerta manual_cpc
con il CPC ottimizzato attivato.
Ma cosa succede se vuoi utilizzare manual_cpm, che è vuoto? o manual_cpc
senza attivare il CPC ottimizzato? Per farlo, devi copiare un'istanza vuota separata della classe nella campagna, ad esempio:
client = GoogleAdsClient.load_from_storage()
empty_cpm = client.get_type('ManualCpm')
client.copy_from(campaign.manual_cpm, empty_cpm)
Nota come viene specificato manual_cpm per l'oggetto campaign:
name {
value: "Test campaign value"
}
manual_cpm {
}
Il campo manual_cpm è impostato, ma nessuno dei suoi campi ha valori. Quando invii
richieste all'API che utilizzano questo pattern, puoi verificare di impostare
correttamente l'oggetto messaggio vuoto attivando la registrazione e ispezionando il
payload della richiesta.
Infine, dovrai aggiungere manualmente questo campo a update_mask dell'oggetto richiesta. L'helper della maschera di campo non ha alcun meccanismo per determinare la
differenza tra un campo impostato esplicitamente su un oggetto vuoto e un
campo non impostato.
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")