本指南详细介绍了如何构建用于创建和更新效果最大化广告系列的请求的许多复杂细节。在设计集成时，本指南会是一个有用的资源。本指南介绍了如何处理用于更改效果最大化 广告系列的请求，并且可以作为效果最大化 问题排查指南和 效果最大化批量处理指南的配套资源。
制作效果最大化广告系列
在 Google Ads API 中，效果最大化广告系列实体由多个唯一资源组合而成。
标准效果最大化广告系列
标准效果最大化广告系列需要满足最低资源要求才能投放广告。
对于启用了 品牌规范 的广告系列，用于创建 Campaign 和必需的 CampaignAsset 资源的操作必须包含在单个请求中，并且 CampaignAsset 资源必须满足最低素材资源要求和规范。
请务必注意，用于创建 AssetGroup 和
AssetGroupAsset 实体的操作必须包含在单个请求中，并且
AssetGroupAsset 资源必须组合起来才能满足所有 最低素材资源
要求 和规范；
请参阅
零售广告系列的不同之处。如果请求在缺少所有必需的 AssetGroupAsset 实体的情况下创建 AssetGroup，则会导致错误；如需了解更多背景信息，请参阅无效状态与无效请求。
在构建用于创建效果最大化广告系列的请求时，有多种不同的选项。如何对操作进行分组以及如何构建请求，很大程度上取决于您的目标和基础架构。
- 在创建
AssetGroup和AssetGroupAsset资源之前，在单独的请求中创建CampaignBudget、Campaign、Asset和CampaignAsset资源 。（对于启用了品牌规范的广告系列，Campaign和必需的CampaignAsset资源必须包含在 单个请求中） - 将所有这些资源包含在单个 mutate 请求中。
虽然您可以在之前的单独请求中成功创建 CampaignBudget、Campaign、2/} 和
CampaignAsset 资源，但效果最大化
广告系列只有在创建 AssetGroup 和 AssetGroupAsset
资源后才能投放广告。Asset
有效投放广告的效果最大化广告系列的最低要求
您可以按照图示创建其他资源，进一步自定义效果最大化广告系列。
您可以在创建 AssetGroup 和 AssetGroupAsset 资源的同一
请求中包含用于创建 AssetGroupSignal 资源的操作。
或者，您也可以在单独的请求
中创建 AssetGroupSignal 实体，然后创建 AssetGroup。
具有其他选项的效果最大化广告系列
零售专用效果最大化广告系列
零售广告系列非常独特，因为有两种不同的方式可以创建素材资源组，从而生成有效的投放广告的广告系列：
- 没有任何素材资源的素材资源组
- 包含所有必需素材资源的素材资源组（首选）
如果您选择从素材资源组中排除素材资源，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 请求来创建效果最大化广告系列，都必须对请求和操作进行排序，确保在创建资源之前绝不引用该资源 。对于批量更改请求，这意味着对操作进行排序，使被引用资源列在引用它们的资源之前。
如果您选择在创建素材资源时，在同一批量更改请求中创建 AssetGroup 及其 AssetGroupAsset 资源，则所有 AssetOperations 都应位于所有 AssetGroupAssetOperations 之前，如图所示。
Google Ads 服务器会将连续的 AssetGroupAssetOperations 批量处理在一起
并在该组中的最后一个操作之后评估 AssetGroup 是否满足最低素材资源要求。如果您在请求中交替使用 AssetOperations
和 AssetGroupAssetOperations，API 服务器会在第一个 AssetGroupAssetOperation 之后评估
最低素材资源要求，并
返回错误，而不会继续执行请求中的其余操作。因此，请求中的任何素材资源都不会添加到您的 Google Ads 账号中。此外，系统也不会创建 AssetGroup 或任何关联的
AssetGroupAsset 资源。
更新素材资源组
创建有效的 AssetGroup 后，您无法发出后续请求，否则会导致无效状态，即不再满足最低素材资源要求。任何此类请求都会抛出错误。例如，如果您
创建了单个 AssetGroupMARKETING_IMAGE
（最低要求），则移除与该 MARKETING_IMAGE 关联的 AssetGroupAsset
的任何请求都会返回错误。
对于在未关联任何素材资源的情况下创建的零售广告系列中的素材资源组，这一点尤为重要。后续通过创建 AssetGroupAsset 资源向
AssetGroup 添加广告素材资源的请求只有在满足所有广告素材资源要求的情况下才会成功。换句话说，您无法以增量方式向这些素材资源组添加素材资源。