開發人員權杖是長度為 22 個字元的英數字串，可讓應用程式連線至 Google Ads API。如要取得存取權，請前往 Google Ads 管理員帳戶的「API 中心」頁面註冊。每當您發出 API 呼叫時，請設定 developer-token http 或 gRPC 標頭，將開發人員權杖做為要求的一部分傳送。
每個開發人員權杖都會指派存取層級，用來控管您每天可使用該權杖發出的 API 呼叫次數，以及可發出呼叫的環境。
註冊開發人員權杖時，系統預設會授予「探索者存取權」層級。您可藉此對正式版帳戶發出呼叫，但須遵守特定限制。在某些情況下，如果我們無法自動審查您的開發人員權杖申請，可能會改為授予測試帳戶存取權等級的開發人員權杖。您只能對測試帳戶發出 API 呼叫。如要移除探索者和測試帳戶存取層級的限制，您必須為開發人員權杖申請「基本存取權」或「標準存取權」。開發人員權杖申請通過審查並獲得核准後，系統就會授予適當的存取層級。
需要新的開發人員權杖嗎？
是否應申請新的開發人員權杖取決於幾個因素。常見的情況如下：
情境 |
後續步驟 |
| 貴公司從未使用過 Google Ads API，且您想自行開發應用程式 | 申請新的開發人員權杖。瞭解詳情 |
| 貴公司目前或過去曾使用 Google Ads API | Google 通常會為每間公司授予一個開發人員權杖，因此如果貴公司已使用 Google Ads API，請重複使用現有的開發人員權杖。瞭解詳情 |
| 貴公司已使用 Google Ads API，但同時也在開發新產品或工具 | 如果您確定無法使用現有的開發人員權杖，可以申請新的權杖，並在申請中說明用途。在本指南的其餘部分，您可以使用現有的開發人員權杖。瞭解詳情 |
| 貴公司使用第三方應用程式 | 只有在開發自己的應用程式時，才需要開發人員權杖。如果您使用第三方應用程式或服務，則該應用程式的開發人員必須取得應用程式的開發人員權杖。如不確定自己的情況，請與 API 法規遵循團隊聯絡。 |
誰可以申請開發人員權杖？
公司和個人開發人員都可以申請開發人員權杖。下表摘要說明註冊開發人員權杖時需要提供的詳細資料。
| 如果您是 | 然後提供下列開發人員詳細資料 | 其他注意事項 |
|---|---|---|
| 代表貴公司或產品團隊的開發人員 | 貴公司名稱和網址 | Google 通常會為每間公司授予一個開發人員權杖，但會視情況核准個別工具的開發人員權杖。 |
| 不代表公司的個人開發人員 | 將貴公司名稱指定為 Individual。您可以提供替代網址，例如 GitHub 個人資料網址或 LinkedIn 個人資料網址，而非公司網址。 |
您必須具備某種形式的網路曝光度，並向 Google 提供網址，協助我們評估您打算如何使用 Google Ads API。不接受 test.com 和 example.com 等一般網址。 |
如何申請開發人員權杖
申請開發人員權杖時，需要完成兩個步驟。
步驟 1：選取或建立 Google Ads 管理員帳戶
如果您已有 Google Ads 管理員帳戶，請在申請開發人員權杖時選取該帳戶。如果這個管理員帳戶尚未連結至其他帳戶，建議您將其放在帳戶階層的根層級，以簡化日後的權杖審查程序和帳戶管理作業。
如果沒有管理員帳戶，請按照說明中心的操作說明建立帳戶。
步驟 2：申請 Google Ads API 存取權
請注意，開發人員權杖審查程序可能需要一些時間才能完成。 瞭解詳情。
在網路瀏覽器中前往 https://ads.google.com/aw/apicenter。如果系統提示，請登入 Google Ads 管理員帳戶。
填寫 API 存取權表單並接受條款及細則。
請確認資訊正確無誤，且公司網站網址運作正常。如果網站尚未上線，Google 可能無法處理您的申請，並予以拒絕。
請確保您提供的 API 聯絡電子郵件地址可正常接收郵件，且收件匣會定期監控。在審查過程中，Google 的 API 法規遵循團隊可能會透過這個電子郵件地址與您聯絡，以釐清相關問題。如果無法與您聯絡，Google 可能不會繼續處理您的申請。
您可以在 API 中心編輯 API 聯絡人電子郵件地址。即使不是為了完成申請程序，也建議您持續更新這項資訊，以便 Google 向您發送重要的服務公告。
完成申請程序後，API 中心會顯示開發人員權杖，並附上以下其中一種結果：
- 您的開發人員權杖具有「探索者存取權」層級，且狀態為「已核准」。這表示 Google 已自動審查並核准您的開發人員權杖申請，授予您探索層級存取權。您可以開始對正式版帳戶或測試帳戶發出 API 呼叫。
- 您的開發人員權杖具有「測試帳戶存取權」層級，且狀態為「待核准」。這表示 Google 無法自動審查並核准您的探索層級開發人員權杖申請。您可以開始對測試帳戶發出 API 呼叫。完成本指南後，建議您參閱如何申請基本存取層級
確認您是否已登入 Google Ads 管理員帳戶
您必須登入 Google Ads 管理員帳戶才能存取開發人員權杖，且該帳戶不得為 Google Ads 測試管理員帳戶。
如要確認您是否已登入 Google Ads 管理員帳戶，請按照下列步驟操作：
在網路瀏覽器中前往 https://ads.google.com/aw/apicenter。
如果您登入的是客戶帳戶，頁面會顯示「API 中心僅適用於管理員帳戶」。
如果右上角以紅色顯示「測試帳戶」，表示您的帳戶是測試管理員或測試廣告主。
如何查看開發人員權杖
如果有的話，您可以在 Google Ads 管理員帳戶的「API 中心」頁面中找到開發人員權杖。