2026 年 6 月 25 日,星期四
為提升 Google Ads 帳戶的安全性,使用 Google Ads 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
,Google Ads API 團隊