本指南详细介绍了用于创建和更新效果最大化广告系列的请求的结构。在设计集成时，这会是一份有用的资源。本指南介绍了如何处理会更改效果最大化广告系列的请求，可作为效果最大化广告系列问题排查指南和效果最大化广告系列批量处理指南的配套资源。
制作效果最大化广告系列
在 Google Ads API 中，效果最大化广告系列实体由多个唯一资源的组合表示。
标准效果最大化广告系列
标准效果最大化广告系列需要最少的资源集才能投放。
对于启用了品牌推广指南的广告系列，用于创建 Campaign 和必需的 CampaignAsset 资源的操作必须包含在单个请求中，并且 CampaignAsset 资源必须满足最低素材资源要求和规范。
请务必注意，创建 AssetGroup 和 AssetGroupAsset 实体的操作必须包含在单个请求中，并且 AssetGroupAsset 资源必须组合起来才能满足所有最低素材资源要求和规范；请参阅零售广告系列的不同之处。如果创建 AssetGroup 的请求缺少所有必需的 AssetGroupAsset 实体，则会导致错误；如需了解更多背景信息，请参阅无效状态与无效请求。
在构建用于创建效果最大化广告系列的请求时，有多种不同的选项。如何对操作进行分组以及如何构建请求在很大程度上取决于您的目标和基础架构。
- 在创建
AssetGroup和AssetGroupAsset资源之前，先在单独的请求中创建CampaignBudget、Campaign、Asset和CampaignAsset资源。（对于启用了品牌推广指南的广告系列，Campaign和必需的CampaignAsset资源必须一起包含在单个请求中） - 将所有这些资源都包含在单个 mutate 请求中。
虽然您可以在之前的单独请求中成功创建 CampaignBudget、Campaign、Asset 和 CampaignAsset 资源，但效果最大化广告系列只有在 AssetGroup 和 AssetGroupAsset 资源也创建完毕后才能投放。
有效且可投放的效果最大化广告系列的最低要求
您可以创建其他素材资源（如图所示），进一步自定义效果最大化广告系列。
您可以在创建 AssetGroup 和 AssetGroupAsset 资源的同一请求中包含用于创建 AssetGroupSignal 资源的操作。或者，您也可以在创建 AssetGroup 后，在单独的请求中创建 AssetGroupSignal 实体。
采用其他选项的效果最大化广告系列
零售专用效果最大化广告系列
零售广告系列的独特之处在于，您可以通过两种不同的方式创建素材资源组，从而制作出可有效投放的广告系列：
- 没有任何素材资源的素材资源组
- 包含所有必需素材资源的素材资源组（首选）
如果您选择从素材资源组中排除素材资源，Google 会自动使用关联的 Merchant Center 账号中提供的素材资源来制作广告。不过，我们建议您提供素材资源，以便在所有广告资源中投放广告。 零售效果最大化广告系列需要满足以下最低资源要求才能投放广告。
CampaignBudgetCampaign（已填充ShoppingSettings）AssetGroupAssetGroupListingGroupFilter
请务必注意，零售广告系列必须填充 Campaign.shopping_settings 字段。此外，每个 final_urls 中列出的 AssetGroup 必须与 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 请求分组
效果最大化广告系列由多个资源组成，您可以选择在单独的请求中或在单个批量更改请求中创建这些资源。不过，标准效果最大化广告系列中的 AssetGroups 和关联的 AssetGroupAssets 必须在单个原子请求中创建，如前所述。
在您成功创建本指南中提到的所有必需资源之前，您的广告系列无法投放。在发出单独的请求时，请在后续请求中使用所引用资源的实际资源名称。发出包含多个操作的批量 mutate 请求时，请使用通过临时 ID 形成的资源名称。
操作顺序
无论您是否使用批量更改请求来创建效果最大化广告系列，都必须对请求和操作进行排序，以免在资源创建之前引用该资源。对于批量变异请求，这意味着以这样一种方式对操作进行排序：被引用的资源列在引用它们的资源之前。
如果您选择在创建 AssetGroup 及其 AssetGroupAsset 资源的同一批量变动请求中创建 Asset 资源，则所有 AssetOperations 都应位于所有 AssetGroupAssetOperations 之前，如示意图所示。
Google Ads 服务器会将连续的 AssetGroupAssetOperations 批处理在一起，并在该组中的最后一个操作之后评估 AssetGroup 是否满足最低素材资源要求。如果您在请求中交替使用 AssetOperations 和 AssetGroupAssetOperations，API 服务器将在第一个 AssetGroupAssetOperation 之后评估最低素材资源要求，并返回错误，而不会继续执行请求中的其余操作。因此，请求中的所有素材资源都不会添加到您的 Google Ads 账号中。此外，系统也不会创建 AssetGroup 或任何关联的 AssetGroupAsset 资源。
更新素材资源组
创建有效的 AssetGroup 后，您无法再发出后续请求，以免导致状态无效，不再满足最低素材资源要求。任何此类请求都会抛出错误。例如，如果您创建了一个仅包含单个 MARKETING_IMAGE（最低要求）的 AssetGroup，那么任何移除与该 MARKETING_IMAGE 关联的 AssetGroupAsset 的请求都会返回错误。
对于在零售广告系列中创建的没有任何关联素材资源的素材资源组，这一点尤为重要。后续通过创建 AssetGroupAsset 资源向 AssetGroup 添加素材资源的请求只有在满足所有素材资源要求的情况下才会成功。换句话说，您无法以增量方式向这些素材资源组添加素材资源。