本指南會逐步引導您使用您自己的憑證和電腦流程或網頁流程,設定 OAuth2 以存取 API。這些步驟只需執行一次,除非您撤銷、刪除,或是需要變更 OAuth2 憑證的允許範圍。
建立 OAuth2 憑證
先點選用戶端的「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 同意畫面上的「Continue」。
系統會將您導向一個頁面,顯示授權成功的訊息。
已成功擷取授權碼。
請查看
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
檔案放在主目錄中。