将空消息对象设置为字段

在 Google Ads API 中，某些消息字段用于指明广告系列的出价策略选择。这些模型可以是：

如需更新 campaign.name 等基本字段，请直接设置该字段：

campaign.name = "Test campaign value"

如需更新具有可设置子字段的嵌套消息（例如启用智能点击付费功能时的 campaign.manual_cpc），请按如下方式进行设置：

campaign.manual_cpc.enhanced_cpc_enabled = True

设置真正空白的消息

如需使用出价策略（例如 manual_cpm，这是一个空消息），请执行以下操作：

  1. 获取消息类型 (ManualCpm) 的空实例。
  2. 使用 client.copy_from 将此空实例分配给广告系列的字段。
  3. 手动将字段名称 (manual_cpm) 添加到 CampaignOperation 上的 update_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. 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 {
# }

设置包含可选子字段的消息

如需使用 manual_cpc 作为出价策略，而不启用 enhanced_cpc_enabled，您可以尝试类似于 ManualCpm 的方法。不过，由于 ManualCpc 具有子字段，因此向 update_mask 添加 manual_cpc 会导致 FieldMaskError.FIELD_HAS_SUBFIELDS 错误。如果掩码中的消息包含子字段，则 API 需要更具体的信息。

如需正确设置 campaign.manual_cpc，同时确保 enhanced_cpc_enabled 保持未设置状态，请执行以下操作：

  1. 实例化一个空的 ManualCpc 对象并将其分配给 campaign.manual_cpc。
  2. 手动将 ManualCpc 的每个可变子字段的路径添加到 CampaignOperation 上的 update_mask。在这种情况下，相关子字段为 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.

使用这些模式发送请求时，您可以通过启用日志记录并检查请求来验证载荷。