2026 年 11 月 4 日,星期三
今年稍早,Google Ads API 開始要求多方核准 (MPA),才能執行敏感 API 操作。自 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 第 26 版,請在 v26.2 發布後下載最新的用戶端程式庫,以取得新 STALE_MULTI_PARTY_AUTH_REQUEST 錯誤代碼的支援。如要進一步瞭解多方核准,請參閱技術指南。如有技術支援問題,請聯絡 Google Ads API 支援團隊。如有任何疑問,或想討論這篇文章,歡迎前往 Google 廣告與評估社群 Discord 伺服器與我們聯絡。
,Google Ads API 團隊