開發人員權杖是 22 個字元的英數字串，用於將應用程式連結至 Google Ads API。開發人員權杖已於 2026 年 9 月 9 日停用。本指南會歸納相關異動，並列出這項遷移作業的常見問題，協助現有開發人員。
異動內容
我們已針對開發人員權杖淘汰作業，對 Google Ads API 新手上路體驗和 API 存取權管理功能進行多項變更。本節將說明主要異動。
API 存取層級與 Google Cloud 專案相關聯
我們將於 2026 年 9 月 9 日停用開發人員權杖。系統已根據您最近的 API 活動，自動將您目前有效的開發人員權杖存取層級遷移至 Google Cloud 專案。您可以在 API 呼叫標頭中繼續傳送開發人員權杖，但這並非必要，API 伺服器也會忽略這項資訊。現有的程式碼將繼續運作，不會有任何變化。現在，系統會根據您用來產生 OAuth 憑證的 Google Cloud 專案，決定 API 存取層級。
Google Ads API 全新註冊體驗
您現在可以直接在 Google Cloud 控制台申請存取 Google Ads API，無須使用 Google Ads 管理員帳戶。請勿透過 Google Ads 管理員帳戶的 API 中心頁面申請開發人員權杖，或嘗試透過 API 中心頁面申請 API 存取權，因為這些程序已移至 Google Cloud 控制台，如果從 API 中心頁面啟動，系統將不會處理。
全新的 API 存取權管理體驗
我們已淘汰所有新的註冊和 API 存取權管理功能，例如在 Google Ads 管理員帳戶的 API 中心頁面中申請 API 存取權和管理 API 存取層級。這些功能現在已移至 Google Cloud 控制台的 Google Ads API 總覽頁面。
您仍可存取 API 中心頁面，查看過往的開發人員詳細資料。這個頁面日後將完全停用。
新錯誤代碼
如果您嘗試使用具有測試存取權的 Google Cloud 專案，對正式版帳戶發出呼叫，Google Ads API 第 25 版會擲回 AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 錯誤。舊版 API 則會擲回 AuthorizationError.ACTION_NOT_PERMITTED 錯誤。如果遇到這個錯誤，請前往 Google Cloud 專案的 Google Ads API 總覽頁面，然後申請 Explorer 存取權。
基本和標準存取權須完成品牌驗證
如要申請新的基本和標準存取權，請務必完成 Google Cloud 專案的品牌驗證。現有存取權持有人不必完成品牌驗證，但我們建議這麼做。
基本存取權申請現在已自動化，品牌驗證和提交完成後，系統會在幾分鐘內審查完畢。
由於流程更新，所有待處理的基本存取權申請都會在轉換期間關閉。受影響的申請人會收到電子郵件，內含詳細資訊，並應從 Google Ads API 總覽頁面重新申請基本存取權。
新的 API 聯絡人電子郵件地址
為停用 API 中心頁面做準備，我們將改用 Google Cloud 專案中的擁有者和編輯者使用者清單，做為傳送管理和強制性法規遵循通訊內容的唯一管道。為確保順利轉換，我們暫時仍會將服務公告傳送到 API 中心列出的電子郵件地址。我們會在完成通訊管道的轉換程序後，通知您最新消息。
現有開發人員的處理方式
檢查 Google Cloud 專案的 API 存取層級：如果您是現有開發人員，請務必檢查 Google Cloud 專案的 Google Ads API 總覽頁面，確認這些專案的 API 存取層級與現有開發人員權杖相同。請按照本指南中的操作說明，解決可能發現的任何差異。
檢查 API 聯絡電子郵件地址：前往 Google Cloud 雲端專案的 IAM (身分與存取權管理) 頁面。確認您在 Google Cloud 專案中，已為有效的 Google Ads 開發人員和帳戶管理員指派適當的擁有者或編輯者角色。我們將開始向這些電子郵件地址傳送強制性服務公告 (MSA)，通知您 Google Ads API 的任何未來變更。在過渡期間，我們會繼續將 MSA 傳送至API 中心列出的聯絡電子郵件地址，並在流程更新時通知您。
修正應用程式程式碼：建議您更新應用程式，停止透過 API 呼叫傳送開發人員權杖。我們已發布新版用戶端程式庫、Google Ads MCP 伺服器和 Google Ads API 開發人員助理，讓您不用設定開發人員權杖，就能發出 API 呼叫。在日後推出的 Google Ads API 主要版本中，我們將開始拒絕 API 呼叫中的開發人員權杖。如果您的應用程式使用這些程式庫，請更新應用程式依附元件，改用最新版本。
如需進一步協助或有其他問題，請與 Google Ads API 支援團隊聯絡。
已知問題
本節記錄與開發人員權杖淘汰相關的所有已知問題。
使用者完成品牌驗證後，仍未獲得探索者存取權或基本存取權
我們發現部分使用者在申請基本存取權時遭到拒絕，這些使用者擁有品牌驗證專案，使用者會收到拒絕電子郵件，內容為「如要使用基本存取權，必須先成功驗證 OAuth 品牌設定檔。您的申請未獲核准，因為您尚未完成專案的品牌驗證。同樣地，部分使用者申請 Explorer 存取權時也會遭到拒絕，並收到拒絕電子郵件，內容如下：「目前我們無法授予您 Google Cloud 專案 Explorer 存取權，因為該專案不符合 Google Ads API 政策和服務條款的資格條件，無法直接存取正式版帳戶。」
根本原因
您的 Google Cloud 專案可能正在免費試用 Google Cloud 方案，或是帳單帳戶已遭停權或停用。
如何進行驗證
檢查 Google Cloud 帳單狀態。如果帳單專案顯示為「免費試用帳戶」，或是處於停權或停用狀態，表示您受到這個問題影響。
狀態
我們已找出根本原因，目前正在設法解決這個問題。
暫時解決方法
有幾種方法可解決這項問題。選取最適合您用途的選項。
將 Google Cloud 雲端專案升級為付費方案
將 Google Cloud 雲端專案升級為付費層級。請稍候幾分鐘，然後再次申請基本存取權。
移除 Google Cloud 專案的帳單
如果 Google Cloud 雲端專案中沒有其他服務正在執行，請移除 Google Cloud 雲端專案的帳單。請稍候幾分鐘，然後再次申請基本存取權。
使用其他 Google Cloud 專案
如果您有其他已通過品牌驗證的 Google Cloud 專案，請使用該專案申請基本存取權。
新核准的「基本」或「探索」存取層級專案會收到 AUTHORIZATION_ERROR
我們發現部分使用者最近將 Google Cloud 專案的存取層級升級為核准的基本或探索者存取層級後，對正式版帳戶發出 Google Ads API 呼叫時會收到 AUTHORIZATION_ERROR。
根本原因
對於部分專案，Google Ads API 不會採用透過 Google Cloud 控制台完成的 API 存取層級升級。
如何進行驗證
如果符合下列所有條件，就會受到這個問題影響：
- 您擁有測試存取層級的開發人員權杖。
- 您在 2026 年 9 月 9 日前，使用 Google Cloud 專案和開發人員權杖發出 Google Ads API 呼叫。
- 您在 2026 年 9 月 9 日後，將 Google Cloud 專案的存取層級升級為「探索者」、「基本」或「標準」存取層級。
- 您對正式版帳戶的 API 呼叫失敗，並顯示
AUTHORIZATION_ERROR。成功呼叫測試帳戶的 API。
狀態
我們已修正這個問題，目前正努力將修正檔部署到伺服器。 修正檔上線後，API 呼叫就會恢復運作。
暫時解決方法
您可以使用新的 Google Cloud 雲端專案申請 Explorer 存取權。
常見問題
API 存取層級會有什麼異動？
Google Ads API 仍會強制執行API 存取層級。不過，這些權限現在會授予 Google Cloud 控制台專案，而非開發人員權杖。發出 API 呼叫時，系統會根據您用來產生 OAuth 憑證的 Google Cloud 專案，判斷您的 API 存取層級。
我們如何判斷哪些專案需要轉移 API 存取層級？
如果您在 2026 年 9 月 9 日前已取得核准的開發人員權杖，系統會將權杖的存取層級轉移至 Google Cloud 專案，如下所示：
- 我們檢查了過去 90 天的 API 呼叫記錄，找出哪些 Cloud 專案使用您核准的開發人員權杖發出 API 呼叫。
- 我們已將開發人員權杖的 API 存取層級指派給所有已識別的 Cloud 專案。
這項異動後，我是否可以擁有存取層級各異的多個 Cloud 專案？
可以，您可以擁有不同 API 存取層級的多個 Google Cloud 專案。舉例來說，您可以有一個具備基本存取權的 Google Cloud 專案，以及另一個具備標準存取權的 Google Cloud 專案。
範例
舉例來說，假設您有 4 個開發人員權杖和 6 個 Cloud 專案，詳細資料如下：
- 開發人員權杖 1：
abcdefghijkl1234567890具有標準存取權。這筆付款資料已用於專案 ID：1234567890、5678912345、45678912345。 - 開發人員權杖 2：
xyzabcdefghi6789012345具有基本存取權。這個 ID 已用於下列專案：1231235678。 - 開發人員權杖 3：
asdfgflkjhjz7654321012具有基本存取權，但從未用於發出 API 呼叫。最近才剛核准。 - 開發人員權杖 4：
qwertypoiuyu6543298790具有標準存取權，但過去 90 天內未使用過。專案 ID9876564900過去曾與這個開發人員權杖搭配使用。 - 雲端專案：雲端專案 ID「
7171234567」從未使用任何開發人員權杖發出 API 呼叫。
API 存取層級會從開發人員權杖轉移至 Google Cloud 專案，轉移方式如下：
| 開發人員權杖： | 專案 ID | 存取層級 | 說明 |
|---|---|---|---|
abcdefghijkl1234567890 |
1234567890 |
標準存取權 | 開發人員權杖和專案 ID 彼此關聯。 |
abcdefghijkl1234567890 |
5678912345 |
標準存取權 | 開發人員權杖和專案 ID 彼此關聯。 |
abcdefghijkl1234567890 |
45678912345 |
標準存取權 | 開發人員權杖和專案 ID 彼此關聯。 |
xyzabcdefghi6789012345 |
1231235678 |
基本權限 | 開發人員權杖和專案 ID 彼此關聯。 |
asdfgflkjhjz7654321012 |
-- |
-- |
由於開發人員權杖從未用於發出 API 呼叫，因此 API 存取權未轉移至任何專案。 |
qwertypoiuyu6543298790 |
9876564900 |
測試存取權 | 由於開發人員權杖已閒置 90 天，因此 API 存取權遭到撤銷。專案的 API 存取層級預設為「測試存取權」。 |
-- |
7171234567 |
測試存取權 | 這是新專案，尚未搭配任何開發人員權杖使用。 專案的 API 存取層級預設為「測試存取權」。 |
我有多個已核准的開發人員權杖，您要轉移哪個專案的 API 存取層級？
系統會將每個已核准開發人員權杖的存取層級，轉移至與該開發人員權杖相關聯的 Google Cloud 專案。查看範例。
我使用多個 Google Cloud 專案，您要轉移哪個專案的 API 存取層級？
如果您在過去 90 天內，使用核准的開發人員權杖搭配多個 Google Cloud 專案，則這些專案都會獲得與開發人員權杖相同的 API 存取層級。查看範例。
我不再使用的專案已獲派 API 存取層級。如何修正這個問題？
如果 Google Ads API 存取權已指派給您不再使用的 Google Cloud 專案，您不必採取任何行動。如果專案閒置 90 天，Google 會撤銷 API 存取權。
API 存取層級未指派給我的 Google Cloud 專案。如何修正這個問題？
您的 Google Cloud 專案未沿用開發人員權杖的存取層級，可能是因為您從未使用開發人員權杖和雲端專案發出 API 呼叫，或是開發人員權杖的 API 存取權最近因閒置而過期。如要修正問題，請前往 Google Ads API 總覽頁面，為該專案申請適當的 API 存取層級。查看範例。
哪裡可以查看專案的 API 存取層級？
如要查看 Google Cloud 專案的 API 存取層級，請前往 Google Ads API 總覽頁面。
如何申請提高 API 存取層級？
如要為 Google Cloud 雲端專案申請更高的 API 存取層級，請前往 Google Ads API 總覽頁面。
待處理的 API 存取權申請會受到什麼影響？
如果您在 2026 年 9 月 9 日前，透過 Google Ads 管理員帳戶的 API 中心提出待處理的基本存取權申請，系統將會關閉這些申請。請前往 Google Cloud 專案的 Google Ads API 總覽頁面，重新申請基本存取權。如果這項異動會影響您，我們會透過電子郵件傳送必要的操作說明。
您在 2026 年 9 月 9 日前，透過 Google Ads 管理員帳戶的 API 中心提出的所有待處理標準存取權申請，都會照常審查。如果獲得核准，與開發人員權杖相關聯的 Google Cloud 雲端專案就會取得標準存取權。
我可以將已核准的開發人員權杖重新與新的 Google Cloud 專案建立關聯嗎？
過去，Google Ads API 團隊會視情況，支援將開發人員權杖重新與新的 Google Cloud 雲端專案建立關聯。由於我們已停止提供開發人員權杖，因此自 2026 年 9 月 9 日起，這項功能將不再受支援。如要使用新的 Google Cloud 雲端專案，請透過 Google Cloud 雲端專案的 Google Ads API 總覽頁面，申請適當的 API 存取權。
我已取得核准的開發人員權杖，但從未使用過。我可以繼續使用這個開發人員權杖嗎？
否，您無法使用這個開發人員權杖。可能會有兩種結果：
開發人員權杖存取權可能因閒置而遭到撤銷：根據 Google 政策，如果 API 權杖連續 90 天未使用，Google 可能會撤銷該權杖。如果您有一段時間未使用開發人員權杖，存取層級可能因閒置而遭撤銷。如果是這種情況，請前往 Google Ads API 總覽頁面，為 Google Cloud 專案重新申請 API 存取權。查看範例。
您的開發人員權杖最近才獲得核准，但您在 2026 年 9 月 9 日前從未使用過：由於您在 2026 年 9 月 9 日前，從未透過 Google Cloud 專案使用核准的開發人員權杖，因此權杖的存取層級不會轉移至 Cloud 專案。因此您無法再使用開發人員權杖。如果您嘗試使用這個開發人員權杖，對正式版帳戶發出 API 呼叫，系統會擲回
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION錯誤。如要修正錯誤，請前往 Google Cloud 專案的 Google Ads API 總覽頁面，申請適當的 API 存取權。請參閱範例。
在這兩種情況下，您都可以申請探險家存取權和基本存取權，並自動接受審查，不必再與 Google 法規遵循團隊合作完成審查程序。如需標準存取權，請申請人工審查。不過，申請標準存取權時，您可以分享已核准的開發人員權杖詳細資料，以便法規遵循團隊據此審查您的新標準存取權申請。
我可以停止在 API 要求中傳送開發人員權杖嗎？
可以，您可以在 API 要求中停止傳送開發人員權杖。如果您使用用戶端程式庫，可能需要升級至最新版本。請查看程式庫的變更記錄，確認是否支援在不指定開發人員權杖的情況下發出 API 呼叫。
我曾參與 Cloud 代管存取層級前測計畫，這對我有什麼影響？
我們推出雲端管理存取層級的試用計畫，讓 Google Cloud 開發人員發出 API 呼叫時，不必在 API 要求中傳送開發人員權杖。由於我們已淘汰開發人員權杖，這項計畫也將隨之終止。
有效開發人員權杖的存取層級已轉移至 Google Cloud 專案，因此現有程式碼應可繼續運作，不必進行任何變更。如要使用新的 Google Cloud 雲端專案，請透過 Google Cloud 雲端專案的 Google Ads API 總覽頁面申請 API 存取權。
我的開發人員權杖已加入許可清單。這對我有什麼影響？
Google 可能會推出前測計畫，讓部分開發人員存取實驗性功能。有時，只要將開發人員權杖加入許可清單，即可存取這些功能。如果您參與過這類測試計畫，則不必採取任何行動。
我們已更新所有試用計畫，改用 Google Cloud 專案，而非開發人員權杖做為許可清單機制，並將開發人員權杖的許可清單狀態轉移至相關聯的 Google Cloud 專案。現有的程式碼應可繼續運作，不會有任何變化。如果問題仍未解決，請與當初邀請您加入試用計畫的 Google 客戶經理聯絡。
我已取得核准的開發人員權杖，並想搭配新的 Google Cloud 專案使用。這樣可以嗎？
否，您無法使用新的 Google Cloud 雲端專案搭配已核准的開發人員權杖。由於您在 2026 年 9 月 9 日前，從未透過新的 Google Cloud 專案使用已核准的開發人員權杖，因此系統未將權杖的存取層級轉移至 Cloud 專案。如果您嘗試使用這個開發人員權杖發出 API 呼叫，系統會擲回 CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 錯誤，因為開發人員權杖不再用於判斷 API 存取層級。如要修正錯誤，請前往 Google Cloud 專案的 Google Ads API 總覽頁面，申請適當的 API 存取權。查看範例。
我的開發人員權杖外洩，我需要重設開發人員權杖嗎？
不需要，在這種情況下，您不需要重設開發人員權杖。我們已將開發人員權杖的 API 存取層級轉移至您的 Google Cloud 雲端專案，因此未經授權的使用者無法再透過自己的 Google Cloud 雲端專案使用您的開發人員權杖。
API 中心會有什麼變化？
Google Ads 管理員帳戶中的現有 API 中心頁面已淘汰，並將在不久的將來移除。如果您已有開發人員權杖，仍可登入 Google Ads 管理員帳戶並查看詳細資料。不過，這些資訊僅供參考。請勿執行任何與開發人員權杖存取層級相關的作業，例如從這個頁面申請更高的 API 存取層級。
如要申請更高的 API 存取層級，請前往 Google Cloud 專案的 Google Ads API 總覽頁面。
我是否仍需 Google Ads 管理員帳戶才能使用 Google Ads API？
您不再需要 Google Ads 管理員帳戶，即可使用 Google Ads API。只有在需要使用 API 連結及管理多個帳戶時，才需要管理員帳戶。
我是新開發人員，如何申請使用 Google Ads API？
按照入門指南的操作說明，註冊使用 Google Ads API。請勿透過 Google Ads 管理員帳戶的 API 中心申請開發人員權杖，否則系統不會處理這些申請。API 中心將於近期內淘汰。
管理 API 存取層級需要哪些 IAM 權限？
您必須具備 Google Cloud 雲端專案的配額管理權限，才能管理 Google Ads API 存取層級。根據預設，擁有者、編輯者、配額管理員和服務使用情形管理員這些角色都具備必要權限。詳情請參閱配額權限說明文件。
您可以查看 Google Cloud 專案的 IAM 頁面，瞭解自己獲派的角色。與 Google Cloud 專案管理員合作，授予 Google Cloud 專案的必要 IAM 角色。