建立及設定 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 檔案。