Impostare gli oggetti messaggio vuoti come campi

Nell'API Google Ads, alcuni campi dei messaggi vengono utilizzati per indicare una scelta di strategia di offerta per un Campaign. Ad esempio:

Tieni presente che i campi della strategia di offerta in Campaign appartengono a un bidding_strategy oneof gruppo. L'impostazione di una nuova strategia di offerta come manual_cpm o manual_cpc cancella implicitamente qualsiasi strategia di offerta configurata in precedenza in quel gruppo oneof.

Per aggiornare un campo primitivo come campaign.name, impostalo direttamente:

campaign.name = "Test campaign value"

Per aggiornare un messaggio nidificato con sotto campi impostabili, come campaign.manual_cpc quando si abilita il CPC ottimizzato, impostalo come segue:

campaign.manual_cpc.enhanced_cpc_enabled = True

Impostare messaggi veramente vuoti

Per utilizzare una strategia di offerta come manual_cpm, che è un messaggio vuoto:

  1. Ottieni un'istanza vuota del tipo di messaggio (ManualCpm).
  2. Utilizza client.copy_from per assegnare questa istanza vuota al campo della campagna.
  3. Aggiungi manualmente il nome del campo (manual_cpm) a update_mask su CampaignOperation. L' helper della maschera di campo non è in grado di rilevare automaticamente che un messaggio vuoto è stato impostato in modo esplicito.
from google.ads.googleads import util
from google.ads.googleads.client import GoogleAdsClient
from google.api_core.protobuf_helpers import field_mask

client = GoogleAdsClient.load_from_storage()
# Assume 'campaign' is an existing Campaign object you are updating.

# 1. Get an empty ManualCpm type.
empty_cpm = client.get_type("ManualCpm")

# 2. Copy it to the campaign's manual_cpm field.
client.copy_from(campaign.manual_cpm, empty_cpm)

# 3. Create the operation and manually add "manual_cpm" to the update_mask.
campaign_operation = client.get_type("CampaignOperation")
client.copy_from(campaign_operation.update, campaign)
client.copy_from(
    campaign_operation.update_mask,
    field_mask(None, util.convert_proto_plus_to_protobuf(campaign)),
)
campaign_operation.update_mask.paths.append("manual_cpm")

# The resulting proto sent to the API will include:
# manual_cpm {
# }

Impostare messaggi con sotto campi facoltativi

Per utilizzare manual_cpc come strategia di offerta senza abilitare enhanced_cpc_enabled, puoi provare un approccio simile a ManualCpm. Tuttavia, poiché ManualCpc ha sottocampi, l'aggiunta di manual_cpc a update_mask genera un FieldMaskError.FIELD_HAS_SUBFIELDS errore. L'API richiede una maggiore specificità quando un messaggio nella maschera ha sotto campi.

Per impostare correttamente campaign.manual_cpc assicurandoti che enhanced_cpc_enabled rimanga non impostato:

  1. Crea un'istanza di un oggetto vuoto ManualCpc e copialo in campaign.manual_cpc utilizzando client.copy_from.
  2. Aggiungi manualmente il percorso a ogni sotto campo modificabile di ManualCpc a update_mask in CampaignOperation. In questo caso, il sotto campo pertinente è enhanced_cpc_enabled.
from google.ads.googleads import util
from google.ads.googleads.client import GoogleAdsClient
from google.api_core.protobuf_helpers import field_mask

client = GoogleAdsClient.load_from_storage()
# Assume 'campaign' is an existing Campaign object you are updating.

# 1. Copy an empty ManualCpc object into campaign.manual_cpc.
client.copy_from(campaign.manual_cpc, client.get_type("ManualCpc"))

# 2. Manually add the subfield path to the update_mask.
campaign_operation = client.get_type("CampaignOperation")
client.copy_from(campaign_operation.update, campaign)
client.copy_from(
    campaign_operation.update_mask,
    field_mask(None, util.convert_proto_plus_to_protobuf(campaign)),
)

# For ManualCpc, because it has subfields, you must specify the subfield
# path in the update_mask. This tells the API you are updating something
# within manual_cpc. By not setting enhanced_cpc_enabled on the campaign
# object, it defaults to false.
campaign_operation.update_mask.paths.append("manual_cpc.enhanced_cpc_enabled")

# The update_mask paths will include: ['manual_cpc.enhanced_cpc_enabled']
# This correctly signals to the API that ManualCpc is the chosen strategy,
# with enhanced_cpc_enabled in its default state.

Quando invii richieste utilizzando questi pattern, puoi verificare il payload abilitando la registrazione e ispezionando la richiesta.