快速入门

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本指南使用客户端库来检索 Google Ads 广告系列。

如需启用 API 访问权限,请先获取所需的 OAuth2 凭据。

然后,将授权和帐号详细信息添加到配置文件中。设置完配置文件后,您就可以调用该 API 了。

客户端库的配置参数

在客户端库的配置文件中提供以下信息。

开发者令牌

开发者令牌可让您的应用访问 API,但令牌不限于一个 Google Ads 帐号。一旦您的令牌获得批准,您就可以将同一令牌用于针对所有 Google Ads 帐号的请求,即使它们未关联到与此令牌相关联的 Google Ads 经理帐号也是如此。

您管理的帐号由经理帐号中的 OAuth 凭据授权。经理帐号只需一组凭据即可管理其所有子帐号。

只有经过批准的令牌才能连接到生产 Google Ads 帐号的 API;待处理令牌只能连接到测试帐号。

要检索您的开发者令牌,您可以登录您的经理帐号,然后转到 API 中心工具 & 设置;设置 >API 中心)。

客户帐号的客户 ID

客户帐号的客户 ID 是您要通过 API 管理的 Google Ads 客户帐号的帐号编号,其格式通常为 123-456-7890

您可以选择将客户帐号的客户 ID 留在配置文件之外,并采用编程方式进行设置。在您的开发者令牌获得批准后,您可以使用来自正式版帐号的客户帐号的客户 ID(而不是测试帐号)。

OAuth2 客户端 ID 和客户端密钥

OAuth2 客户端 ID 和客户端密钥将客户端应用映射到 Google API 控制台中的项目,用于 OAuth2 身份验证,让您的应用能够代表您的帐号执行操作。它们可向 Google 识别您的应用,并允许您生成用于管理 Google Ads 用户的 OAuth 令牌。如需了解详情,请参阅创建客户端 ID 和客户端密钥

OAuth2 访问令牌和刷新令牌

您的应用必须先获取用于授予 API 访问权限的 OAuth2 访问令牌,然后才能使用该 API 访问私有数据。

如果您使用的是客户端库,系统会自动为您处理 OAuth2 访问令牌。否则,请尝试通过 OAuth 园地获取令牌。

OAuth2 访问令牌会在限定时间后过期。因此,客户端库使用 OAuth2 刷新令牌来自动生成 OAuth2 访问令牌。访问令牌和刷新令牌提供了有关创建刷新令牌的说明。