取得開發人員權杖

開發人員權杖是長度為 22 個字元的英數字元字串,可讓應用程式連結至 Google Ads API。Google 為您指派權杖後,您可以在 Google Ads 管理員帳戶的「API Center」頁面查看或建立新權杖。

每個開發人員權杖都會獲派一個存取層級,用來控制每天可透過權杖進行的 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 存取權

請注意,開發人員權杖審查程序可能需要一段時間才能完成。瞭解詳情

登入管理員帳戶,然後按一下「搜尋」按鈕。

輸入「API Center」,然後從搜尋自動完成清單中選取。只有 Google Ads 管理員帳戶專用的「API 中心」選項,廣告客戶帳戶測試管理員帳戶都不會顯示。

填寫 API 存取表單並接受條款及細則。

  • 請確認您的資訊正確無誤,而且貴公司的網站網址也能正常運作。如果網站並未上線,Google 可能無法處理並拒絕您的應用程式。

  • 請確保您提供的 API 聯絡電子郵件可導向定期監控的收件匣。Google API 法規遵循團隊可能會在審查過程中與這個電子郵件地址聯繫,以便釐清相關問題。如果您無法連線,Google 可能無法繼續處理您的應用程式。

    您可以在 API 中心編輯 API 聯絡電子郵件地址。即使在應用程式程序完成後,也請持續更新這項資訊,以便 Google 傳送重要的服務公告給您。

完成申請程序後,開發人員權杖會顯示在 API Center 中,狀態為「Pending Approval」。您的開發人員權杖現在已擁有測試存取權層級,可以開始對測試帳戶發出 API 呼叫。

取得開發人員權杖後,請記下您進行第一次 API 呼叫時所需的值。

查看開發人員權杖的位置

您可以在 Google Ads 管理員帳戶的「API 中心」頁面,查看現有的開發人員權杖。

登入管理員帳戶,然後按一下「搜尋」按鈕。

輸入「API Center」,然後從搜尋自動完成清單中選取。只有 Google Ads 管理員帳戶會顯示「API Center」選項,測試管理員帳戶不會顯示。

開發人員權杖及其存取層級是「API 存取權」下的第一個值。