Google Ads API 调研及使用

最新推荐文章于 2025-04-25 11:34:56 发布

置顶

秋叶华

最新推荐文章于 2025-04-25 11:34:56 发布

阅读量3k

点赞数 23

分类专栏：案例分享 Java 基础篇 java 文章标签： java googlecloud

本文链接：https://blog.csdn.net/u014614478/article/details/139786466

版权

Google ADS API 接口调研

简介

Google Ads API 用于管理大型或复杂的 Google Ads 帐号和广告系列。您可以构建软件，从客户级别到关键字级别管理帐号。一些典型用例包括：

自动账号管理
自定义报告
基于产品目录的广告管理
管理智能出价策略

要发出 Google Ads API 调用，您应具备以下详细信息。本教程的其余部分将介绍如何获取每项内容。

Google Ads 经理帐号：您需要拥有 Google Ads 经理帐号才能申请 Google Ads API。

开发者令牌：此令牌可让您的应用连接到 Google Ads API。每个开发者令牌都分配有一个 API 访问权限级别，该级别控制您每天可以发出 API 调用的次数以及可以进行调用的环境。测试及普通权限每天有访问限制，标准权限无调用次数限制

Google API 控制台项目：项目用于为您的应用生成 OAuth 2.0 客户端 ID 和密钥。然后，ID 和密钥可用于生成对 Google Ads 账号的 API 调用所需的 OAuth 2.0 凭据。该项目还会使该 API 能够接听电话。

Google Ads 客户帐号：您要向其发出 API 调用的帐号。您需要拥有必要的权限才能对此账号执行操作，例如获取报告或更改广告系列。

您还需要要向其发出 API 调用的帐号的 10 位数帐号。它在 Google Ads 网页界面中显示为 123-456-7890 格式。此帐号会作为参数传递给 Google Ads API 调用，不带连字符：1234567890。

支持工具和客户端库：这套工具可帮助您更快地与 API 集成

注:Google Ads API 目前国内访问需要开通国外VPN(fanqiang)

1.选择或创建一个 Google API 控制台项目

注：如果您已有 Google API 控制台项目并希望使用它创建凭据，则可以跳至创建客户端 ID 和客户端密钥。

前往 Google API 控制台
点击创建项目
输入名称或接受生成的建议
确认或修改其余所有字段
点击创建

如果已启用结算功能，请为新项目选择结算帐号。Google Ads API 可免费使用，但 Cloud 项目总数有配额限制。

2.启动API和服务

点击“API和服务”—》再击“启用API和服务”—》搜索“google ads api” —》最后点击“启用”

3.接口OAuth2.0 凭据授权

点击“凭据”-》再点击“创建凭据”-》再点击“OAuth客户端ID”

创建后生成秘钥信息

编辑查看信息，可更换回调地址、添加多个回调地址

下载凭证，获取刷新令牌时使用

4.生成OAuth2.0刷新令牌

Google OAuth2.0刷新令牌 Web授权方式仅供参考

4.1 Web授权步骤一:获取code

向Google 的授权服务端发送请求https://accounts.google.com/o/oauth2/v2/auth

字段	类型	描述
client_id	String	应用ID	client_id 从凭证授权获取
redirect_uri	String	回调地址	Google会验证地址是否一致
response_type	String	默认值 code
scope	String	访问API授权列表,多个空格(%20)分隔	Google API 授权链接 Google for Developers - 从 AI 和云到移动和 Web /identity/protocols /oauth2/scopes?hl=zh-cn
access_type	String	建议 offline ，默认online	您的应用需要在用户不在浏览器时刷新访问令牌，请将值设置为 offline，获取token时返回refreshToken
include_granted _scopes	Boolean	建议 true	允许应用使用增量授权在上下文中请求访问其他范围
prompt	String	建议 consent	提示用户同意并返回refreshToken

参考源码实现:google-auth-library-oauth2-http-1.23.0.jar

com.google.auth.oauth2.UserAuthorizer#getAuthorizationUrl()方法

public URL getAuthorizationUrl(
    String userId, String state, URI baseUri, Map<String, String> additionalParameters) {
  URI resolvedCallbackUri = getCallbackUri(baseUri);
  String scopesString = Joiner.on(' ').join(scopes);

  GenericUrl url = new GenericUrl(userAuthUri);
  url.put("response_type", "code");
  url.put("client_id", clientId.getClientId());
  url.put("redirect_uri", resolvedCallbackUri);
  url.put("scope", scopesString);
  if (state != null) {
    url.put("state", state);
  }
  url.put("access_type",

最低0.47元/天解锁文章