Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

将智能广告系列转换为效果最大化广告系列

在 v25 及更高版本中，您可以使用 SmartCampaignSettingService.GeneratePMaxDraftCampaign 方法将智能广告系列转换为效果最大化广告系列。此方法在 v24 及更低版本中不可用。

转换的运作方式

当您调用 SmartCampaignSettingService.GeneratePMaxDraftCampaign 时，API 会根据请求中提供的智能广告系列配置，生成效果最大化广告系列、预算、素材资源组和素材资源的草稿。生成后，您应先检查、修改和优化新资源，然后再启用广告系列来投放广告。

生成的效果最大化广告系列草稿会使用以下状态值进行初始化：

status 设置为 PAUSED。
其投放资格反映在 primary_status 中。
contains_eu_political_advertising 默认设置为 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING（如果智能广告系列中尚未指定）。如果您的广告系列包含欧盟政治广告，请验证并更新此字段。

这样，您就可以在启用广告系列投放广告之前，检查、修改和增强生成的效果最大化广告系列、预算、素材资源组和素材资源。

新广告系列附带一组占位图，在启用新广告系列之前，需要替换这些占位图。如果请求中支持 image_enabled 字段并将其设置为 true，API 会自动生成图片，而不是使用占位图。您可以在响应的 assets 字段中检查新素材资源，并按照以下步骤替换它们：

查看素材资源要求指南。
按照上传图片素材资源示例上传新图片。
按照将素材资源组与素材资源相关联指南，将新素材资源与草稿广告系列的素材资源组相关联，然后移除占位图的 AssetGroupAsset 链接（在同一原子 mutate 请求中或在关联新素材资源后，以确保始终满足最低素材资源要求）。

resource_name（必需）：要转换的智能广告系列要重新生成的 SmartCampaignSetting 的资源名称，格式如下：
```
customers/customer_id/smartCampaignSettings/campaign_id
```
validate_only（可选）：如果为 true，则请求会经过验证，但不会执行。响应的 validated_info 字段中仅会返回验证错误、警告或可能的转换问题，而不会创建草稿实体。
gbp_enabled（不受支持）：可选。是否转换与效果最大化广告系列关联的 Google 商家资料 (GBP) 营业地点。请将此字段留空或设置为 false；不支持将其设置为 true，否则会返回 SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED 错误。
image_enabled（不受支持）：可选。是否生成所需的效果最大化广告系列图片（例如横向、方形和徽标图片类型）。请将此字段留空或设置为 false；不支持将其设置为 true，否则会返回 SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED 错误。

GeneratePMaxDraftCampaignResponse 消息会返回生成的草稿效果最大化广告系列及其关联实体的资源名称：

pmax_campaign：所生成的效果最大化广告系列草稿的 Campaign 资源名称。
campaign_budget：与生成的效果最大化广告系列关联的 CampaignBudget 资源名称。
asset_group：与生成的AssetGroup效果最大化广告系列关联的资源名称。
assets：与所生成的效果最大化广告系列相关联的 Asset 资源名称列表。
validated_info：转化检查返回的验证信息或可能的转化问题（在 validate_only 设置为 true 时填充，以及在 validate_only 为 false 时与生成的实体资源名称一起填充）。