開發人員權杖是長度為 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 中心」。系統只會針對 Google Ads 管理員帳戶顯示「API 中心」選項。
接著,填妥 API 存取權表單,並接受《條款及細則》。
請確認您的資訊正確無誤,貴公司的網站網址也能正常運作。如果網站未上線,Google 可能無法處理並拒絕您的應用程式。
確保您提供的 API 聯絡電子郵件地址能夠導向定期監控的收件匣。Google 的 API 法規遵循團隊在審查期間可能會聯絡這個電子郵件地址,以便釐清問題。如果聯絡不上,Google 可能不會繼續處理您的申請。
您可以前往 API 中心編輯 API 聯絡人電子郵件。即使在應用程式程序完成後,此資訊也須即時更新,讓 Google 能夠傳送重要的服務公告給您。
完成申請程序後,開發人員權杖就會顯示在 API 中心,狀態為「待審核」。開發人員權杖現在已獲得「測試存取權」層級,您可以開始對測試帳戶進行 API 呼叫。
取得開發人員權杖後,請記下其值,因為您首次呼叫 API 時會用到此權杖。
開發人員權杖位置
您可以在 Google Ads 管理員帳戶的 API 中心頁面找到現有的開發人員權杖。
登入您的管理員帳戶,然後依序前往 [工具與設定] > [設定] > [API 中心]。系統只會針對 Google Ads 管理員帳戶顯示「API 中心」選項。開發人員權杖及其存取層級是「API Access」(API 存取權) 下的第一個值。