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
属性找到失败操作的索引。
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 没有源码,如何修改代码逻辑?
· 一个奇形怪状的面试题:Bean中的CHM要不要加volatile?
· [.NET]调用本地 Deepseek 模型
· 一个费力不讨好的项目,让我损失了近一半的绩效!
· .NET Core 托管堆内存泄露/CPU异常的常见思路
· 微软正式发布.NET 10 Preview 1:开启下一代开发框架新篇章
· DeepSeek R1 简明指南:架构、训练、本地部署及硬件要求
· 没有源码,如何修改代码逻辑?
· NetPad:一个.NET开源、跨平台的C#编辑器
· 面试官:你是如何进行SQL调优的?