開發人員權杖是 22 個字元的英數字串,可讓應用程式連線至 Google Ads API。Google 將權杖指派給您後,您可以在 Google Ads 管理員帳戶的「API 中心」頁面查看或建立新權杖。
每個開發人員權杖都會獲派存取層級,用來控管您每天可透過權杖發出的 API 呼叫次數,以及可發出呼叫的環境。
如要對實際執行帳戶發出 API 呼叫,您必須在申請權杖時,為開發人員權杖要求「基本存取權」或「標準存取權」層級。由於對測試帳戶發出呼叫時不需要這些存取層級,因此您可以繼續進行練習,但建議您完成本指南後,查看如何申請基本存取層級。
需要新的開發人員權杖嗎?
是否應註冊新的開發人員權杖取決於幾個因素。常見的情況如下:
情境 |
後續步驟 |
貴公司從未使用過 Google Ads API,且您想自行開發應用程式 | 申請新的開發人員權杖。瞭解詳情 |
貴公司目前或過去曾使用 Google Ads API | Google 通常會為每間公司授予一個開發人員權杖,因此如果貴公司已使用 Google Ads API,請重複使用現有的開發人員權杖。瞭解詳情 |
貴公司已使用 Google Ads API,但同時也在開發新產品或工具 | 如果您確定無法使用現有的開發人員權杖,可以申請新的權杖,並在申請中說明用途。在本指南的其餘部分,您可以使用現有的開發人員權杖。瞭解詳情 |
貴公司使用第三方應用程式 | 只有在開發自家應用程式時,才需要開發人員權杖。如果您使用第三方應用程式或服務,則該應用程式的開發人員必須取得應用程式的開發人員權杖。如不確定自己的情況,請與 API 法規遵循團隊聯絡。 |
如何申請開發人員權杖
申請開發人員權杖時,需要完成兩個步驟。
步驟 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 中心會顯示開發人員權杖,狀態為「待核准」。您的開發人員權杖現在具有「測試帳戶存取權」層級,可以開始對測試帳戶發出 API 呼叫。
取得開發人員符記後,請記下其值,因為您在發出第一個 API 呼叫時會需要這個值。
確認您是否已登入管理員帳戶
您必須登入管理員帳戶才能存取開發人員符記,且該帳戶不得為測試管理員帳戶。
如要確認是否已登入管理員帳戶,請按照下列步驟操作:
在網路瀏覽器中前往 https://ads.google.com/aw/apicenter。
如果您登入的是客戶帳戶,頁面會顯示「API 中心僅適用於管理員帳戶」。
如果右上角以紅色顯示「測試帳戶」,表示您的帳戶是測試管理員或測試廣告主。
如何查看開發人員權杖
如果有的話,您可以在 Google Ads 管理員帳戶的「API 中心」頁面中找到開發人員權杖。