Java 適用的用戶端程式庫代管於 GitHub,並透過 Maven Central 發布。這個程式庫提供多項功能,可協助您使用 API,包括更輕鬆地管理憑證,以及建立 Google Ads API 服務用戶端。
這個程式庫需要 Java 8 以上版本。
安裝
在 pom.xml 或 build.gradle 檔案中使用 Google Ads API 物料清單 (BOM) 管理依附元件版本:
<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
versions of all google-ads libraries. -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads-bom</artifactId>
<version>46.1.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<!-- Add the google-ads dependency, without a version. The version is
managed by the BOM. -->
<dependency>
<groupId>com.google.api-ads</groupId>
<artifactId>google-ads</artifactId>
</dependency>
您也可以從來源建構程式庫。
進行第一次 API 呼叫
如要使用 Google Ads API,您需要完成幾個步驟,才能存取 API 並設定 Google Ads 帳戶。請按照快速入門指南操作,逐步完成所有重要步驟,包括設定 Google Ads 帳戶。
基本用法
請參閱基本使用指南,瞭解如何設定專案、例項化服務用戶端,以及使用 Java 用戶端程式庫執行程式碼範例。
驗證及授權
Java 用戶端程式庫支援多種驗證和授權方法,包括 OAuth 2.0 桌面和網頁應用程式流程、服務帳戶和應用程式預設憑證。詳情請參閱驗證和授權指南。
設定和記錄
Java 用戶端程式庫支援多種設定選項 (包括 ads.properties 檔案、環境變數和程式輔助設定),以及用於追蹤 API 要求和回應的記錄功能。
公用程式
Java 用戶端程式庫包含實用類別,可提升 API 的可用性。查看下列指南持續學習:
- FieldMasks:用於建構及計算更新欄位遮罩的輔助程式。
- ResourceNames:用於格式化實體資源名稱字串的公用程式。
- 長時間執行的作業:用於監控及管理非同步 API 作業的輔助程式。
微調應用程式
請參閱進階使用指南,瞭解如何微調應用程式的逾時、重試設定、啟動延遲和依附元件管理。