建立及設定 Google API 控制台專案的方式,取決於應用程式的 OAuth 2.0 授權情境。選取授權情境,自訂本指南。
您需要 Google API 控制台專案,才能建立 OAuth 2.0 憑證,並為應用程式啟用 Google Ads API。
這些憑證會在 Google 伺服器上驗證及授權您的應用程式或 Google Ads 使用者,並讓您產生 OAuth 權杖,用於呼叫 API。
選取或建立 Google API 控制台專案
如要設定新專案,請按照指南建立 Google API 控制台專案。您可以選擇是否為專案啟用計費功能。如果您已啟用計費功能,請為新專案選取帳單帳戶。使用 Google Ads API 不會產生費用,但雲端專案會受到標準專案配額限制。
在專案中啟用 Google Ads API
如要在專案中啟用 Google Ads API,請按照下列步驟操作:
在 Google API 控制台中開啟 API 程式庫。按照系統說明選取專案,或建立新專案。API 程式庫會列出所有可用的 API,並按照產品系列及熱門程度分組。
如果清單中沒有顯示 Google Ads API,請使用搜尋功能尋找。
選取「Google Ads API」,然後點選「啟用」按鈕。
申請 API 存取權
接著,請前往 Google Ads API 總覽頁面,查看目前的 API 存取層級。如果目前的 API 存取層級為「測試」,請展開「升級存取層級」部分。按照操作說明申請探索者存取層級。
完成申請後,Google 會自動審查申請,並在多數情況下升級為 Explorer 存取權。
設定 OAuth 同意畫面
使用 OAuth 2.0 授權時,Google 會向使用者顯示同意畫面,包括專案摘要、政策和要求的授權存取範圍。設定應用程式的 OAuth 同意畫面,定義向使用者和應用程式審查人員顯示的內容,並註冊應用程式,以便日後發布。
為應用程式設定 OAuth 同意畫面,並新增 https://www.googleapis.com/auth/adwords 做為 OAuth 範圍。
使用者類型和發布狀態的重要注意事項
設定 OAuth 同意畫面時,請留意「User type」(使用者類型) 和「Publishing status」(發布狀態) 設定。
- 使用者類型:定義應用程式是否僅限貴機構使用者 (「內部」),或開放所有 Google 使用者存取 (「外部」)。只有當專案屬於 Google Workspace 機構時,才能使用「Internal」(內部)。
- 發布狀態:決定應用程式是否處於「測試」模式 (僅限您新增的特定測試使用者),或是「實際運作中」 (適用於「使用者類型」定義的目標對象,可能需要 Google 驗證應用程式)。
如要為應用程式做出最佳選擇,請參閱 Google Cloud 官方支援說明文件,瞭解這些設定的詳細說明和影響:
請務必瞭解這些設定,確保預期使用者能存取應用程式。
建立用戶端 ID 和用戶端密鑰
建立用戶端 ID 和用戶端密鑰。應用程式類型可選擇「電腦版應用程式」或「網頁應用程式」。建立 OAuth 2.0 用戶端後,請按一下確認對話方塊中的「Download JSON」(下載 JSON) 按鈕,下載用戶端的 JSON 檔案。