2026 年 9 月 10 日，星期四
為提升開發人員的新手入門和使用體驗，我們在 Google Cloud 控制台中，為 Google Ads API 打造了全新首頁。開發人員完成品牌驗證後，系統會自動申請基本存取權。這篇網誌文章將介紹幾項相關異動，這些異動將自今天開始推出。開發人員應詳閱本文的「敬請採取行動」一節，確保轉換過程順利。
API 存取權管理異動
我們將更新 Google Ads API 存取權的申請和管理方式。
Google Ads API 新手入門體驗：現在您可以直接在 Google Cloud 控制台申請 Google Ads API 存取權，不需 Google Ads 管理員帳戶。我們將停用管理員帳戶 API 中心頁面的所有新註冊和 API 存取權管理功能，並改用 Google Cloud 控制台的 Google Ads API 總覽頁面。您仍可前往 API 中心頁面查看舊的開發人員詳細資料。這個頁面將於日後完全停用。
API 存取層級與 Google Cloud 雲端專案建立關聯：我們將停用開發人員權杖。系統會根據您最近的 API 活動，自動將您現有開發人員權杖的存取層級遷移至 Google Cloud 專案。您仍可在 API 呼叫標頭中傳送開發人員權杖，但這並非必要，且 API 伺服器會忽略這項資訊。現有的程式碼將繼續運作，不會有任何變化。API 存取層級現在取決於您用來產生 OAuth 憑證的 Google Cloud 專案。如要進一步瞭解這項異動，以及排解可能遇到的問題，請參閱常見問題頁面。
新錯誤代碼：在 Google Ads API v25 版中，如果您嘗試使用測試帳戶存取層級的 Google Cloud 專案，對正式帳戶發出呼叫，系統會擲回 CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 錯誤。舊版 API 則會擲回 ACTION_NOT_PERMITTED 錯誤。如果遇到這項錯誤，請前往 Google Cloud 專案的 Google Ads API 總覽頁面，申請 Explorer 存取權。
API 審查程序異動
基本版和標準存取權需要品牌驗證：如要申請基本版和標準存取權，您必須為 Google Cloud 雲端專案完成品牌驗證。現有存取權持有者不需完成品牌驗證，但建議完成。
自動核准基本存取權：基本存取權申請現已自動化，品牌驗證和提交後，幾分鐘內就會完成審查。
一次性拒絕待處理的基本版存取權申請：由於這些程序更新，所有待處理的基本版 API 存取權申請都將在轉換期間關閉。受影響的申請者會收到電子郵件，內含詳細資訊，並應從 Google Ads API 總覽頁面重新申請 API 存取權。
敬請採取行動
驗證 API 存取權：確認專案的 API 存取層級與現有開發人員權杖相符：
- 在 Google Ads 管理員帳戶的 API 中心，查看開發人員權杖的存取層級。
- 在 Google Ads API 總覽頁面，確認 Google Cloud 雲端專案的存取層級相同。
- 如果存取層級不符，請前往 Google Ads API 總覽頁面重新申請 API 存取權，或向 Google Ads API 支援團隊尋求協助。
更新 API 聯絡電子郵件地址：前往 Cloud 專案的身分與存取權管理 (IAM) 頁面。請確保擁有者和編輯者角色的使用者清單為最新。我們將開始向這些電子郵件地址傳送電子郵件服務公告，通知您 Google Ads API 日後的任何異動。
程式碼變更：建議您更新應用程式程式碼，停止透過 API 呼叫傳送開發人員權杖。我們發布了新版用戶端程式庫，讓您不用設定開發人員權杖，就能發出 API 呼叫。在 Google Ads API 的未來主要版本中，我們將開始拒絕 API 呼叫中的開發人員權杖。
視情況重新申請 API 存取權：如果待處理的基本 API 存取權申請因這項異動而關閉，請前往 Google Cloud 控制台的 Google Ads API 總覽頁面重新申請 API 存取權。
我們已發布更新版說明文件，協助您因應這些異動。如有技術支援問題，請參閱常見問題頁面，或聯絡 Google Ads API 支援團隊。如有任何疑問，或想討論這篇文章，歡迎前往 Google 廣告與評估社群 Discord 伺服器與我們聯絡。
- Anash P. Oommen，Google Ads API 團隊
標籤： google-ads-api、 release