本指南详细介绍了制作和更新效果最大化广告系列时，在设计请求结构时遇到的诸多复杂问题。在您设计集成时，它会是非常有用的资源。本指南介绍了如何处理更改效果最大化广告系列的请求，可作为效果最大化广告系列问题排查指南和效果最大化广告系列批处理指南的配套资源。
制作效果最大化广告系列
在 Google Ads API 中，效果最大化广告系列实体表示为多项唯一资源的组合。
标准效果最大化广告系列
标准效果最大化广告系列需要至少一组资源才能投放。
请务必注意，创建 AssetGroup 实体和 AssetGroupAsset 实体的操作必须一起包含在单个请求中，并且 AssetGroupAsset 资源必须组合在一起，以满足所有最低素材资源要求和规范；了解这对于零售广告系列有何不同。如果请求创建 AssetGroup 但不包含所有必需的 AssetGroupAsset 实体，则会导致错误；如需了解详情，请参阅无效状态与无效请求。
在设计用于制作效果最大化广告系列的请求时，有不同的选择。如何对操作进行分组和设计请求结构的决定在很大程度上取决于您的目标和基础架构。
- 在创建
AssetGroup和AssetGroupAsset资源之前，请在单独的请求中创建CampaignBudget、Campaign和Asset资源。 - 将所有这些资源包含在一个 mutate 请求中。
虽然您可以在之前单独的请求中成功创建 CampaignBudget、Campaign 和 Asset 资源，但在创建 AssetGroup 和 AssetGroupAsset 资源之前，效果最大化广告系列无法投放。
有效投放的效果最大化广告系列需满足的最低要求
您可以通过创建其他资源来进一步自定义效果最大化广告系列，如图所示。
您可以在创建 AssetGroup 和 AssetGroupAsset 资源的同一请求中添加创建 AssetGroupSignal 资源的操作。或者，您也可以在创建 AssetGroup 后，通过一个单独的请求创建 AssetGroupSignal 实体。
具有额外选项的效果最大化广告系列
零售专用效果最大化广告系列
零售广告系列的独特之处在于，您可以通过两种不同的方式创建素材资源组，从而生成有效的投放广告系列：
- 没有任何素材资源的素材资源组
- 包含所有必需素材资源的素材资源组（首选）
当您选择从素材资源组中排除素材资源时，Google 会自动使用关联的 Merchant Center 账号中提供的素材资源来制作广告。不过，我们建议您提供要在所有广告资源中覆盖的素材资源。 零售专用效果最大化广告系列需要达到以下最低数量要求资源，才能投放。
CampaignBudgetCampaign（已填充ShoppingSettings）AssetGroupAssetGroupListingGroupFilter
请务必注意，在零售广告系列中必须填充 Campaign.shopping_settings 字段。此外，每个 AssetGroup 中列出的 final_urls 必须与 Campaign.shopping_settings 中指定的 Merchant Center 帐号 ID 相关联的网址匹配。最后，每个 AssetGroup 都必须有一个关联且有效的商品详情组树，其中包含一个或多个 AssetGroupListingGroupFilter 资源。您必须至少创建一个节点树来涵盖指定 Merchant Center Feed 中的所有产品。
这些资源都可以单独创建，也可以在单个请求中创建。不过，只有在正确创建所有这些资源后，广告系列才可以投放。
投放有效的零售效果最大化广告系列需满足的最低要求
零售广告系列可以利用标准效果最大化广告系列的所有可用选项，包括创建素材资源组信号、广告系列转化目标和广告系列条件。如果您在创建 AssetGroup 资源时选择向 AssetGroup 添加素材资源，则您的 AssetGroup 需遵循最低素材资源要求。换言之，您可以不包含任何素材资源，也可以包含所有必需素材资源。
提供额外选项的零售效果最大化广告系列
无效状态与无效请求
通过 Google Ads API 处理效果最大化广告系列时，无效状态和无效请求之间存在重要区别。
- 无效状态
- 由于配置不当，该广告系列不符合投放条件。例如，您可以创建
advertising_channel_type为PERFORMANCE_MAX的独立Campaign资源。虽然创建该广告系列的请求已成功，但您必须先向该广告系列添加至少一个AssetGroup，然后才能投放该广告系列。如果请求成功，但广告系列或素材资源组未投放，您可以使用CampaignPrimaryStatus、CampaignPrimaryStatusReason、AssetGroupPrimaryStatus和AssetGroupPrimaryStatusReason来确定原因，详情请参阅问题排查指南。 - 请求无效
- 请求因会导致广告系列或资源处于无效状态而失败。例如，如果您尝试为非零售广告系列创建
AssetGroup，而未添加至少需要的素材资源，Google Ads API 会抛出错误。因此，您必须在同一请求中添加AssetGroup及其AssetGroupAsset资源。这也意味着，您的所有AssetGroupAsset资源都必须符合给定field_type的正确规范，以防止整个请求失败。
使用 mutate 请求对操作进行分组
效果最大化广告系列由多种资源组成，您可以选择在唯一请求或单个批量 mutate 请求中创建这些单独的资源。不过，如前所述，在标准效果最大化广告系列中，AssetGroups 和关联的 AssetGroupAssets 必须在单个原子化请求中创建。
您必须先成功创建本指南中提到的所有必需资源，然后才能投放广告系列。发出单独的请求时，请在后续请求中使用所引用资源的实际资源名称。在发出包含多个操作的批量 mutate 请求时，请使用通过临时 ID 构成的资源名称。
操作顺序
无论您是否使用批量 mutate 请求制作效果最大化广告系列，都必须对请求和操作进行排序，确保在创建资源之前永不引用资源。对于批量 mutate 请求，这意味着对操作进行排序，使所引用的资源排在引用它们的资源之前列出。
如果您选择在同一批量 mutate 请求中创建 Asset 资源（该请求会创建 AssetGroup 及其 AssetGroupAsset 资源），那么所有 AssetOperations 都应位于所有 AssetGroupAssetOperations 之前，如图所示。
Google Ads 服务器会批处理连续的 AssetGroupAssetOperations，并评估该组中的最后一次操作后 AssetGroup 是否满足最低素材资源要求。如果您在请求中交替使用 AssetOperations 和 AssetGroupAssetOperations，API 服务器将在第一个 AssetGroupAssetOperation 之后评估最低资源要求，并返回错误，而不会继续处理请求中的其余操作。因此，该请求中的任何素材资源都不会添加到您的 Google Ads 帐号中。此外，系统既不会创建 AssetGroup，也不会创建任何关联的 AssetGroupAsset 资源。
更新素材资源组
创建有效的 AssetGroup 后，您就无法再发出后续请求，导致不再满足最低素材资源要求这种无效状态。任何此类请求都会引发错误。例如，如果您创建一个具有单个 MARKETING_IMAGE（最低要求）的 AssetGroup，则任何移除与该 MARKETING_IMAGE 关联的 AssetGroupAsset 的请求都会返回错误。
如果零售广告系列中的素材资源组没有关联任何素材资源，这一点尤为重要。通过创建 AssetGroupAsset 资源将资源添加到 AssetGroup 的后续请求只有在满足所有资源要求时才会成功。换言之，您不能将素材资源逐步添加到这些素材资源组中。