Google advertiser api开发概述——部分失败

部分失败

某些 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 属性找到失败操作的索引。