在 Google Ads API 中,某些消息字段被定义为空消息对象,例如 campaign.manual_cpm
;或者它们可能只有无需设置的可选字段,例如 campaign.manual_cpc
。设置这些字段对于告知 API 将对给定广告系列使用何种出价策略非常重要,但在消息为空时并不直观。
更新字符串形式的 campaign.name
字段时,我们会直接更新该字段,就像它是一个普通 Python 对象特性一样:
campaign.name = "Test campaign value"
campaign.manual_cpc
是一个嵌套字段,这意味着它包含另一条 protobuf 消息,而不是字符串等基元类型。您也可以直接更新其字段:
campaign.manual_cpc.enhanced_cpc_enabled = True
这将告知 API 此广告系列的出价策略已启用 manual_cpc
,且启用了智能点击付费。
但是,如果您想使用空的 manual_cpm
,该怎么办?还是manual_cpc
,而未启用智能点击付费?为此,您需要将该类的单独空实例复制到广告系列中,例如:
client = GoogleAdsClient.load_from_storage()
empty_cpm = client.get_type('ManualCpm')
client.copy_from(campaign.manual_cpm, empty_cpm)
请注意如何为 campaign
对象指定 manual_cpm
:
name {
value: "Test campaign value"
}
manual_cpm {
}
已设置 manual_cpm
字段,但该字段均未设置值。向使用此模式的 API 发送请求时,您可以启用日志记录并检查请求载荷,以验证是否正确设置了空消息对象。
最后,您需要将此字段手动添加到请求对象的 update_mask
中。字段掩码帮助程序没有能够确定明确设置为空对象的字段与尚未设置的字段之间的差异。
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")