開發人員權杖是一組 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 存取權表單,並接受《條款及細則》。
請確認資訊正確無誤,且貴公司網站的網址可正常運作。如果網站尚未上線,Google 可能無法處理您的申請,並拒絕申請。
請確認您提供的 API 聯絡電子郵件地址會導向定期監控的收件匣。Google API 法規遵循團隊可能會在審查期間透過這個電子郵件地址與您聯絡,以便釐清相關問題。如果無法與您聯絡,Google 可能會停止處理您的申請。
您可以在 API Center 中編輯 API 聯絡電子郵件。請持續更新這項資訊,即使在申請程序結束後也一樣,以便 Google 向您發送重要的服務公告。
完成申請程序後,開發人員權杖會顯示在 API 中心,狀態為「Pending Approval」。您的開發人員權杖現在具有「測試存取」層級,您可以開始對測試帳戶呼叫 API。
取得開發人員權杖後,請記下其值,因為您在第一次呼叫 API 時需要使用這個值。
確認您是否登入管理員帳戶
您必須登入管理員帳戶才能存取開發人員符記,且該帳戶不得為測試管理員帳戶。
如要確認是否已登入管理員帳戶,請按照下列步驟操作:
登入帳戶。
選取左側的「管理」。如果左上方顯示「管理員帳戶設定」,表示您已登入管理員帳戶。如果您看到「帳戶設定」,表示您已登入客戶帳戶。
如果右上角顯示紅色的「測試帳戶」,表示您的帳戶是測試管理員或測試廣告客戶。
開發人員權杖的顯示位置
您可以在 Google Ads 管理員帳戶的「API 中心」頁面中,查看開發人員權杖 (如有)。
在頁面頂端的搜尋列中輸入「api center」,然後從搜尋自動完成功能中選取。API 中心選項僅會顯示在 Google Ads 管理員帳戶中,不會顯示在測試管理員帳戶中。
開發人員憑證及其存取層級是「API 存取權」下方列出的首個值。