本指南详细介绍了构建用于制作和更新效果最大化广告系列的请求时需要注意的许多细节。在设计集成时，它会是一个有用的资源。本指南介绍了如何处理更改效果最大化广告系列的请求，可作为效果最大化广告系列问题排查指南和效果最大化广告系列批处理指南的配套资源。
制作效果最大化广告系列
在 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 实体。
效果最大化广告系列（含其他选项）
零售专用效果最大化广告系列
零售广告系列的独特之处在于，您可以通过两种不同的方式创建素材资源组，从而生成可有效投放的广告系列：
- 不含自定义素材资源（或仅含 HTML5
MEDIA_BUNDLE素材资源）的素材资源组 - 包含所有必需素材资源的素材资源组（首选）
如果您选择从素材资源组中排除素材资源，Google 会自动使用关联的 Merchant Center 账号中提供的素材资源来制作广告。不过，我们建议您提供素材资源，以便覆盖所有广告资源。 效果最大化零售广告系列需要满足以下最低资源要求才能投放：
CampaignBudgetCampaign（已填充ShoppingSetting）AssetGroupAssetGroupListingGroupFilter
在零售广告系列中，必须填充 Campaign.shopping_setting 字段。此外，AssetGroup 中列出的任何 final_urls 都必须与 Campaign.shopping_setting 中指定的 Merchant Center 账号 ID 关联的网站域名一致。最后，每个 AssetGroup 都必须有一个关联的有效产品信息组树，该树由一个或多个 AssetGroupListingGroupFilter 资源组成。您至少必须创建一个单节点树，以涵盖指定 Merchant Center Feed 中的所有商品。
这些资源可以单独创建，也可以在单个请求中创建。不过，在所有这些资源都正确创建之前，广告系列将不符合投放条件。
有效投放的效果最大化广告系列零售广告系列的最低要求
效果最大化零售广告系列可以使用标准效果最大化广告系列的所有可用选项，包括创建素材资源组信号、广告系列转化目标和广告系列条件。如果您在创建 AssetGroup 资源时选择向 AssetGroup 添加自定义素材资源（HTML5 MEDIA_BUNDLE 素材资源除外），则您的请求必须满足所有最低素材资源要求（如果启用了品牌规范，则包括广告系列级品牌资产）。也就是说，要么不包含任何自定义素材资源，要么包含所有必需的素材资源。
效果最大化零售广告系列，提供更多选项
无效状态与无效请求
在 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 请求，这意味着要对操作进行排序，使被引用的资源列在引用它们的资源之前。
如果您选择在创建 AssetGroup 及其 AssetGroupAsset 资源的同一批量 mutate 请求中创建素材资源，则所有 AssetOperations 都应位于所有 AssetGroupAssetOperations 之前，如上图所示。
Google Ads 服务器会将连续的 AssetGroupAssetOperations 批量处理，并在该组中的最后一项操作完成后，评估 AssetGroup 是否满足最低素材资源要求。如果您在请求中交替使用 AssetOperations 和 AssetGroupAssetOperations，API 服务器将在第一个 AssetGroupAssetOperation 之后评估最低资产要求，并返回错误，而不会继续执行请求中的其余操作。因此，请求中的任何素材资源都不会添加到您的 Google Ads 账号中。此外，系统不会创建 AssetGroup 或任何关联的 AssetGroupAsset 资源。
更新素材资源组
创建有效的 AssetGroup 后，您无法发出后续请求，否则会导致素材资源组不符合最低素材资源要求。任何此类请求都会抛出错误。例如，如果您创建了一个仅包含一个 MARKETING_IMAGE（最低要求）的 AssetGroup，则仅移除该 MARKETING_IMAGE
AssetGroupAsset 的请求会返回错误。不过，在效果最大化零售广告系列中，您可以通过在单个请求中移除所有自定义 AssetGroupAsset 链接，恢复为依赖 Google Merchant Center 自动生成的素材资源。AssetGroup
对于在创建时未关联任何自定义素材资源的效果最大化广告系列零售广告系列中的素材资源组，后续关联自定义素材资源（HTML5 MEDIA_BUNDLE 素材资源除外）的请求必须确保在 AssetGroup 上至少设置一个 final_urls（如果最初省略，则先填充），并且必须在单个原子请求中提供所有最低要求的素材资源（如果启用了品牌规范，则包括广告系列级品牌资产）。请勿单独关联可选广告素材资源（例如 YOUTUBE_VIDEO），也不要通过单独的请求逐步添加广告素材资源。如果仅关联可选的自定义素材资源，素材资源组会处于不受支持的状态，从而无法在 Google Ads 界面中进行修改。如需了解详情，请参阅在效果最大化零售广告系列中将素材资源组与素材资源相关联。