Leere Nachrichtenobjekte als Felder festlegen

In der Google Ads API werden einige Nachrichtenfelder verwendet, um eine Gebotsstrategie für eine Kampagne anzugeben. Beispiele:

Wenn Sie ein primitives Feld wie campaign.name aktualisieren möchten, legen Sie es direkt fest:

campaign.name = "Test campaign value"

Wenn Sie eine verschachtelte Nachricht mit festlegbaren Unterfeldern wie campaign.manual_cpc aktualisieren möchten, z. B. beim Aktivieren des auto-optimierten CPC, gehen Sie so vor:

campaign.manual_cpc.enhanced_cpc_enabled = True

Leere Nachrichten festlegen

So verwenden Sie eine Gebotsstrategie wie manual_cpm, die eine leere Nachricht ist:

  1. Eine leere Instanz des Nachrichtentyps (ManualCpm) abrufen.
  2. Verwenden Sie client.copy_from, um diese leere Instanz dem Feld der Kampagne zuzuweisen.
  3. Fügen Sie den Feldnamen (manual_cpm) manuell dem update_mask im CampaignOperation hinzu. Das Feldmasken-Tool kann nicht automatisch erkennen, dass eine leere Nachricht explizit festgelegt wurde.
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. Manually add "manual_cpm" to the update_mask.
from google.api_core.protobuf_helpers import field_mask
campaign_operation = client.get_type('CampaignOperation')
campaign_operation.update = campaign
campaign_operation.update_mask = field_mask(None, campaign)
campaign_operation.update_mask.paths.append("manual_cpm")

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

Nachrichten mit optionalen Unterfeldern festlegen

Wenn Sie manual_cpc als Gebotsstrategie verwenden möchten, ohne enhanced_cpc_enabled zu aktivieren, können Sie einen ähnlichen Ansatz wie bei ManualCpm verwenden. Da ManualCpc jedoch Unterfelder hat, führt das Hinzufügen von manual_cpc zum update_mask zu einem FieldMaskError.FIELD_HAS_SUBFIELDS-Fehler. Die API erfordert mehr Spezifität, wenn eine Nachricht in der Maske Unterfelder hat.

So legen Sie campaign.manual_cpc richtig fest und sorgen dafür, dass enhanced_cpc_enabled nicht festgelegt wird:

  1. Instanziieren Sie ein leeres ManualCpc-Objekt und weisen Sie es campaign.manual_cpc zu.
  2. Fügen Sie den Pfad zu jedem veränderlichen Unterfeld von ManualCpc manuell dem update_mask im CampaignOperation hinzu. In diesem Fall ist das relevante Unterfeld enhanced_cpc_enabled.
client = GoogleAdsClient.load_from_storage()
# Assume 'campaign' is an existing Campaign object you are updating.

# 1. Instantiate and assign an empty ManualCpc
campaign.manual_cpc = client.get_type('ManualCpc')

# 2. Manually add the subfield path to the update_mask.
from google.api_core.protobuf_helpers import field_mask
campaign_operation = client.get_type('CampaignOperation')
campaign_operation.update = campaign
campaign_operation.update_mask = field_mask(None, 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.

Wenn Sie Anfragen mit diesen Mustern senden, können Sie die Nutzlast überprüfen, indem Sie Logging aktivieren und die Anfrage prüfen.