2026 年 6 月 25 日,星期四
为提高 Google Ads 账号的安全性,使用 Google Ads API 执行敏感 API 操作时,需要经过多方审批。这是 Google Ads 更广泛变更的一部分,该变更要求在 Google Ads 账号中执行敏感操作时需经过多方审批。这些重要的安全更新将于 2026 年 7 月 27 日开始逐步推出,并将在未来几周内为所有用户启用。
有何变化?
此项变更生效后,以下 API 调用的行为将会发生变化。
邀请用户
如果您使用 CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation 方法邀请新用户管理 Google Ads 账号,Google Ads API 现在会评估是否需要多方审批。如果我们的服务器确定需要审核,系统会暂停标准工作流程,并且不会立即生成 CustomerUserAccessInvitation 或发送邮件邀请。系统会改为启动 MultiPartyAuthReview 资源,并在响应中提供其资源名称。待审核的邀请获得第二位账号管理员的批准后,系统会创建 CustomerUserAccessInvitation,并且受邀用户会收到电子邮件。在待处理的审核完成之前,无法为该用户创建新的邀请。
更新或终止用户的访问权限
如果您使用 CustomerUserAccessService.MutateCustomerUserAccess 方法通过更新操作调整用户权限,或通过移除操作撤消访问权限,Google Ads API 现在会评估是否需要多方审批。如果我们的服务器确定需要审核,API 会生成一个处于待处理状态的 MultiPartyAuthReview 资源,并返回其资源名称。您请求的修改将一直处于待处理状态,仅在由另一位账号管理员完成多方审核并审批通过后才会生效。在待审核问题解决之前,无法更改正在审核的CustomerUserAccess。
如何批准多方审批请求?
您可以使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 方法,通过以下 GAQL 查询来提取待处理的 MultiPartyAuthReview。
SELECT multi_party_auth_review.resource_name, multi_party_auth_review.multi_party_auth_review_id, multi_party_auth_review.creation_date_time, multi_party_auth_review.request_user_email, multi_party_auth_review.operation_type, multi_party_auth_review.justification, multi_party_auth_review.target_resource, multi_party_auth_review.customer_user_access_review.old_customer_user_access, multi_party_auth_review.customer_user_access_review.new_customer_user_access, multi_party_auth_review.customer_user_access_invitation_review.new_customer_user_access_invitation FROM multi_party_auth_review WHERE multi_party_auth_review.review_status = 'PENDING'
您可以使用 MultiPartyAuthReviewService.ResolveMultiPartyAuthReview API 请求批准或拒绝待处理的 MultiPartyAuthReview 请求。审核需要由未创建原始请求的其他管理员完成。这可以是具有管理员权限的人员或服务账号。原始请求者可以撤消待审核的请求。
我需要做什么?
如果您的应用使用了这些方法,请务必在 2026 年 7 月 27 日之前完成更新,以确保能够顺利处理多方审批工作流。我们已在 API 的所有主要版本(v24.2、v23.3、v22.2 和 v21.2)中新增了对多方审批的支持。如果您使用的是官方客户端库,请务必下载其最新版本。您可以参阅以下指南,详细了解这些变化:
如果您对此次更新有任何疑问或想进一步讨论,请通过“Google 广告和效果衡量社区”Discord 服务器与我们联系。如有技术支持问题,请访问 https://support.google.com/google-ads/contact/google_ads_api
Oommen