建立及設定 Google API 控制台專案時,請按照應用程式中建構的 OAuth 2.0 授權情境類型,採取對應的步驟。選擇您要建構的授權情境;本指南會根據您的選擇進行調整。
您需要 Google API 控制台專案,才能建立 OAuth 2.0 憑證,並為應用程式啟用 Google Ads API。
Google 伺服器需要這些憑證,才能驗證及授權 Google Ads 使用者。您可以使用這些憑證產生 OAuth 權杖,以便在呼叫 API 時使用。
雖然多個專案可以使用單一開發人員權杖,但每個專案只能使用單一開發人員權杖。
選取或建立 Google API 控制台專案
按照操作說明建立專案。啟用專案的計費功能為選用步驟。如果已啟用計費功能,請為新專案選取帳單帳戶。使用 Google Ads API 不必支付任何費用,但 Cloud 專案總數設有配額。
在專案中啟用 Google Ads API
如要在專案中啟用 Google Ads API,請按照下列步驟操作:
在 Google API 控制台中開啟 API 程式庫。按照系統說明選取專案,或建立新專案。API 程式庫會列出所有可用的 API,並按照產品系列及熱門程度分組。
如果清單裡找不到 Google Ads API,請使用搜尋功能。
選取 Google Ads API,然後按一下「啟用」按鈕。
設定 OAuth 同意畫面
使用 OAuth 2.0 授權時,Google 會向使用者顯示同意畫面,內容包括專案摘要、政策,以及要求授權的存取範圍。設定應用程式的 OAuth 同意畫面,可決定向使用者和應用程式審查人員顯示的內容,並註冊應用程式,以便日後發布。
按照操作說明,為應用程式設定 OAuth 同意畫面,並新增 https://www.googleapis.com/auth/adwords 做為 OAuth 範圍。
使用者類型和發布狀態的重要注意事項
設定 OAuth 同意畫面時,請注意「使用者類型」和「發布狀態」設定。
- 使用者類型:定義應用程式是否僅供貴機構使用者存取 (「內部」),或開放所有 Google 使用者存取 (「外部」)。請注意,只有在專案屬於 Google Workspace 機構時,才能選擇「內部」。
- 發布狀態:決定應用程式是否處於「測試」模式 (僅限您新增的特定測試使用者),或是「實際運作中」模式 (適用於「使用者類型」定義的目標對象,可能需要 Google 進行應用程式驗證)。
如要為應用程式做出最佳選擇,請參閱 Google Cloud 官方支援文件,瞭解這些設定的詳細說明和影響:
瞭解這些設定至關重要,可確保目標使用者能存取應用程式。
建立用戶端 ID 和用戶端密鑰
如果您使用現有的 Google API 控制台專案,且該專案已產生用戶端 ID 和用戶端密鑰,可以略過這個步驟。否則,請按照操作說明建立用戶端 ID 和用戶端密鑰。您可以選擇「桌面應用程式」或「網頁應用程式」做為應用程式類型。建立 OAuth 2.0 用戶端後,請先點選用戶端的「下載 OAuth 用戶端」圖示,然後點選下一個畫面中的「下載 JSON」按鈕,即可下載用戶端的 JSON 檔案。