2026 年 11 月 4 日,星期三
今年早些时候,Google Ads API 开始要求在执行敏感 API 操作时进行多方审批 (MPA)。自 2026 年 12 月 7 日当周起,我们将引入更多变更,以改善多方审批的开发者体验。
有何变化?
延迟创建访问权限邀请:如果需要多方审批,CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation 方法会延迟创建访问权限邀请资源,直到多方审批请求获得批准。在这种情况下,resource_name 字段不会填充。待处理的 MPA 请求获得批准后,您便可以从审核结果中获取访问权限邀请资源。目前,此方法会创建邀请并返回邀请的 resource_name,但在关联的 MPA 请求获得批准之前,不会执行其他操作(例如发送邮件邀请)。
针对过时请求的新错误代码:如果待处理的 MPA 请求因目标资源在审核创建后被修改或删除而不再有效,我们将开始在部分失败字段中返回新的 MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST 错误代码。此错误代码将在即将发布的 v26.2 版本中引入。旧版 API(v23 至 v25)将返回 MultiPartyAuthReviewError.UNKNOWN 错误,并且 GoogleAdsError.details 中的 unpublished_error_code 字段将设置为 MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST。
提高了 MPA 审核的上限:您只需调用一次 MultiPartyAuthReviewService.ResolveMultiPartyAuthReview 方法,即可解决最多 100 项待处理的 MPA 审核。目前,此方法仅限每次 API 调用一条评价。
需要采取行动
如果您使用多方审批,请在 2026 年 12 月 7 日之前检查并更新代码,以反映新的 API 行为。如果您使用的是 Google Ads API v26,请在 v26.2 发布后下载最新的客户端库,以获取对新 STALE_MULTI_PARTY_AUTH_REQUEST 错误代码的支持。如需详细了解多方审批,请参阅我们的技术指南。如有技术支持问题,请联系 Google Ads API 支持团队。如果您有任何疑问或想讨论此帖子,请通过我们的 Google 广告和效果衡量社区 Discord 服务器与我们联系。
Oommen