Google Ads Java 开源项目最佳实践-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01074/article/details/147549204

Google Ads Java 开源项目最佳实践

google-ads-java Google Ads API Client Library for Java 项目地址: https://gitcode.com/gh_mirrors/go/google-ads-java

1. 项目介绍

Google Ads Java 是一个开源库，由 Google Ads API 团队开发，旨在帮助开发者更轻松地使用 Java 语言来访问 Google Ads API。它提供了一套丰富的 Java 类和方法，使得开发者可以方便地构建、测试和管理 Google Ads 的应用程序。

2. 项目快速启动

安装依赖

首先，确保你的开发环境中已经安装了 Java 和 Maven。然后，你可以通过以下 Maven 命令来添加 Google Ads Java 库的依赖：

<dependency>
    <groupId>com.google.api-ads</groupId>
    <artifactId>google-ads</artifactId>
    <version>1.0.0</version>
</dependency>

配置文件

创建一个配置文件 google-ads.properties，并填入你的 Google Ads 客户 ID 和密钥：

developerToken=YOUR_DEVELOPER_TOKEN
clientId=YOUR_CLIENT_ID
clientSecret=YOUR_CLIENT_SECRET
refreshToken=YOUR_REFRESH_TOKEN

初始化客户端

在你的 Java 应用中，初始化 Google Ads 客户端：

import com.google.ads.googleads.lib.GoogleAdsClient;
import com.google.ads.googleads.lib.GoogleAdsClientBuilder;

public class Main {
  public static void main(String[] args) {
    GoogleAdsClient client = GoogleAdsClientBuilder.fromPropertiesFile()
        .build();
    // 你的代码逻辑...
  }
}

3. 应用案例和最佳实践

查询广告组

以下是一个查询广告组的示例：

import com.google.ads.googleads.vX.services.GoogleAdsServiceClient;
import com.google.ads.googleads.vX.services.SearchGoogleAdsRequest;
import com.google.ads.googleads.vX.services.SearchGoogleAdsResponse;

public class GetAdGroups {
  public static void main(String[] args) {
    GoogleAdsClient client = GoogleAdsClientBuilder.fromPropertiesFile().build();
    try (GoogleAdsServiceClient googleAdsServiceClient = client.getGoogleAdsServiceClient()) {
      String customerId = "YOUR_CLIENT_ID";
      String query = "SELECT ad_group.id, ad_group.name FROM ad_group WHERE customer_id = '"
          + customerId + "'";
      SearchGoogleAdsRequest request = SearchGoogleAdsRequest.newBuilder()
          .setCustomerId(customerId)
          .setQuery(query)
          .build();
      SearchGoogleAdsResponse response = googleAdsServiceClient.search(request);
      for (GoogleAdsRow row : response.getResultsList()) {
        System.out.printf("Ad group ID %d and name '%s'.%n", row.getAdGroup().getId(),
            row.getAdGroup().getName());
      }
    }
  }
}

处理异常

当使用 Google Ads API 时，处理异常是非常重要的。以下是如何处理潜在异常的示例：

import com.google.ads.googleads.lib.GoogleAdsClient;
import com.google.ads.googleads.lib.GoogleAdsClientBuilder;
import com.google.ads.googleads.vX.errors.GoogleAdsException;
import com.google.ads.googleads.vX.services.GoogleAdsServiceClient;

public class Main {
  public static void main(String[] args) {
    try {
      GoogleAdsClient client = GoogleAdsClientBuilder.fromPropertiesFile().build();
      // 使用客户端执行操作...
    } catch (GoogleAdsException e) {
      System.err.println("请求失败，错误信息如下：");
      System.err.println(e.getMessage());
      // 根据错误信息做进一步处理...
    }
  }
}