本指南將逐步說明如何使用自己的憑證以及電腦版流程或網頁流程,設定 OAuth2 以存取 API。這些步驟只需執行一次,除非您撤銷、刪除,或是需要變更 OAuth2 憑證允許的範圍。
建立 OAuth2 憑證
請按照這篇文章中的步驟,為 Google Ads API 設定 Google API 控制台專案。
在下一個畫面中,按一下「Download OAuth client」(下載 OAuth 用戶端) 圖示,然後點選「Download JSON」(下載 JSON) 按鈕,下載用戶端的 JSON 檔案。
請將檔案儲存至主目錄,使其擁有本機檔案
~/client_secret_XXX.apps.googleusercontent.com.json
(其中 XXX 會是您專案的專屬值)。在接下來的步驟中,我們會用這個檔案來執行程式碼範例。
設定用戶端程式庫
在終端機中執行
GenerateUserCredentials
範例。使用指令列標記來傳遞您在上一個步驟中下載的 JSON 檔案。使用 Gradle 從指令列執行
./gradlew --console=plain --quiet runExample \ --example="authentication.GenerateUserCredentials \ --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
本範例會提示您前往一個網址,您必須在該網址允許 OAuth2 憑證代您存取 Google Ads 帳戶。
Paste this URL in your browser: https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
在私密瀏覽器工作階段或無痕式視窗中前往網址。 使用您存取 Google Ads 的 Google 帳戶登入。按一下 OAuth2 同意畫面中的「繼續」。
系統會將您帶往另一個頁面,其中會顯示授權成功的訊息。
已成功擷取授權碼。
進一步操作說明請參閱
GenerateUserCredentials
的控制台輸出內容。返回執行範例的控制台。您會看到範例已完成,並顯示更新憑證和一些操作說明,以及設定用戶端程式庫所需的屬性:
#Mon Apr 18 09:07:51 EDT 2022 api.googleads.refreshToken=1/Yw......................................... api.googleads.clientId=...........-...............apps.googleusercontent.com api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE api.googleads.clientSecret=........................
將日期註解
#
中的各行複製到輸出內容結尾處,然後貼到ads.properties
檔案中。將
INSERT_DEVELOPER_TOKEN_HERE
替換成您的開發人員權杖。為輕鬆完成設定,請將
ads.properties
檔案放在主目錄中。