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