部分失败
某些 AdWords 服务允许您请求执行有效操作,而对失败的操作返回错误。此功能(称为部分失败)允许您在结束时单独处理失败的操作。
技术细节
要使用此功能,您需要设置此可选的 SOAP 标头:
<partialFailure>true</partialFailure>
该服务将执行没有错误的操作。它将返回成功操作的结果和失败操作的错误。对于非 Mutate 操作,将忽略此标头。
以下服务支持此功能:
- AdGroupAdService
- AdGroupBidModifierService
- AdGroupCriterionService
- AdGroupExtensionSettingService
- AdGroupService
- BudgetService
- CampaignCriterionService
- CampaignExtensionSettingService
- CampaignService
- CustomerExtensionSettingService
- FeedItemService
- OfflineConversionFeedService
- SharedSetService(从 201710 版开始提供)
- 对 BatchJobService 的所有请求一定在
partialFailure
标记设置为 true 的情况下执行。 - 在进行修改购物
ProductPartition
节点的 AdGroupCriterionService.mutate 调用时,只有在操作进行非结构性更改(例如,对现有节点进行出价更改)时,才能使用partialFailure
。如果您的操作是添加或移除节点,则不能使用partialFailure
。
使用方法
假设您需要在帐号中添加一组关键字。但是,某些关键字可能违反了编辑政策。您希望提交有效的关键字,但返回失败的关键字及其错误。
创建服务
首先启用 partialFailure
模式,如下所示:
创建操作并进行 API 调用
按照常规方式创建 mutate 操作并进行 API 调用。
处理成功的操作
成功的操作会返回服务的结果值。可以根据需要进行输出:
处理失败的操作
失败的操作会在 partialFailureErrors
字段返回错误信息。您可以通过查看 partialFailures
列表中 ApiError
对象的 fieldPathElements
属性或 fieldPath
属性找到失败操作的索引。