取得開發人員權杖

開發人員權杖是長度為 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 存取權

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

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

輸入「api center」,然後從搜尋自動完成功能中選取該 API。只有 Google Ads 管理員帳戶會顯示「API 中心」選項,廣告主帳戶測試管理員帳戶則不會。

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

  • 請確認您的資訊正確無誤,且公司網站網址運作正常。如果網站不上線,Google 可能無法處理並拒絕您的申請。

  • 確認您提供的 API 聯絡電子郵件地址,可以引導至定期受監控的收件匣。Google 的 API 法規遵循團隊可能會在審查期間與這個電子郵件地址聯絡,以便釐清規定。如果無法聯絡上,Google 可能會不會繼續處理您的應用程式。

    您可以前往 API 中心編輯 API 聯絡電子郵件。即使在申請程序之後,請務必更新這些資訊,Google 才能傳送重要的服務公告給您。

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

取得開發人員權杖後,請記下這個權杖的值,因為進行第一次 API 呼叫時需要用到。

如何查看開發人員權杖

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

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

輸入「api center」,然後從搜尋自動完成功能中選取該 API。只有 Google Ads 管理員帳戶會顯示「API 中心」選項,測試管理員帳戶都不會顯示。

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