開發人員權杖是 22 個字元的英數字串，用於將應用程式連線至 Google Ads API。開發人員權杖已於 2026 年 9 月 9 日停用。本指南會彙整相關異動，並列出這項遷移作業的常見問題，協助現有開發人員。
異動內容
為配合開發人員權杖淘汰作業，我們對 Google Ads API 上手體驗和 API 存取權管理功能進行了多項變更。本節將說明主要異動。
API 存取層級與 Google Cloud 專案相關聯
開發人員權杖將於 2026 年 9 月 9 日停用。系統會根據您最近的 API 活動，自動將目前有效的開發人員權杖存取層級轉移至 Google Cloud 專案。您可以在 API 呼叫標頭中繼續傳送開發人員權杖，但這是選用做法，API 伺服器會忽略這項資訊。現有程式碼仍可正常運作，不會有任何異動。API 存取層級現在取決於您用來產生 OAuth 憑證的 Google Cloud 專案。
Google Ads API 全新註冊體驗
您現在可以直接在 Google Cloud 控制台申請存取 Google Ads API，無須使用 Google Ads 管理員帳戶。請勿透過 API 中心頁面申請開發人員權杖，也不要嘗試透過 Google Ads 管理員帳戶的 API 中心頁面申請 API 存取權，因為這些程序已移至 Google Cloud 控制台，如果從 API 中心頁面啟動，將不會處理。
全新的 API 存取權管理體驗
我們已淘汰所有新的註冊和 API 存取權管理功能，例如在 Google Ads 管理員帳戶的「API 中心」頁面申請 API 存取權和管理 API 存取層級。這些功能現在已移至 Google Cloud 控制台的 Google Ads API 總覽頁面。
您仍可存取 API 中心頁面，查看過往的開發人員詳細資料。這個頁面日後將全面停用。
新的錯誤代碼
如果您嘗試使用測試帳戶存取層級的 Google 雲端專案，呼叫正式版帳戶，Google Ads API 第 25 版會擲回 CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION 錯誤。較舊的 API 版本則會擲回 ACTION_NOT_PERMITTED 錯誤。如果遇到這項錯誤，請前往 Google Cloud 專案的 Google Ads API 總覽頁面，然後申請 Explorer 存取權。
基本和標準存取權須完成品牌驗證
如要申請新的基本和標準存取權，請務必完成 Google Cloud 專案的品牌驗證。現有存取權持有人不必完成品牌驗證，但我們建議這麼做。
基本存取權申請現在已自動化，品牌驗證和提交完成後，系統會在幾分鐘內完成審查。
由於這些程序更新，所有待處理的 Basic API 存取權申請都會在轉換期間關閉。受影響的申請人會收到電子郵件，內含詳細資訊。請前往 Google Ads API 總覽頁面重新申請 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 支援團隊聯絡。
常見問題
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 專案？
可以，您可以有多個 Google Cloud 專案，並設定不同的 API 存取層級。舉例來說，您可以讓一個 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 Ads API 總覽頁面中，查看 Google Cloud 專案的 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 存取權。請參閱範例。
在這兩種情況下，您都可以申請 Explorer Access 和 Basic Access 層級，並自動接受審查，不必再與 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 中心重設開發人員權杖。
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 中心即將於近期淘汰。