所有 API 调用都必须通过 OAuth2 授权。OAuth2 可让您的 API 客户端应用访问用户的 帐号,而无需处理或存储用户的登录信息。
OAuth2 Playground
生成 OAuth2 凭据的另一种选择是使用 OAuth2 Playground。OAuth2 Playground 与 Google API 控制台配合使用,可让您手动创建 OAuth2 令牌。
OAuth2 Playground 适用于只需访问单个经理帐号或 AdWords 用户帐号的用户。如果您需要提示多个用户提供凭据,则可能最好使用上述基于客户端库的方法。
生成 OAuth2 凭据
1. 选择适当的应用类型
AdWords API 有两种应用类型选项:
已安装应用 / 网络应用
2. 创建客户端 ID 和客户端密钥
3. 获取客户端 ID 和客户端密钥
- 打开 Google API 控制台凭据页面。
- 从项目下拉菜单中选择现有项目或新建项目。
- 在“凭据”页面上,选择创建凭据,然后选择 OAuth 客户端 ID。
- 在应用类型下,选择 网络应用。
- 在经过授权的重定向 URI 下,添加一行:https://developers.google.com/oauthplayground。
- 点击创建。
- 记下所出现页面上的客户端 ID 和客户端密钥。
4. 生成令牌
- 通过此链接前往 OAuth2 Playground,所到达的页面中一些重要的值应该已为您预先填充。
- 点击右上角的齿轮图标 ,然后选中标有 Use your own OAuth credentials 的框(如果尚未选中的话)。
-
请确保: OAuth flow 设置为 Server-side。 Access type 设置为 Offline(这可确保您获得刷新令牌和访问令牌,而不只是访问令牌)。
- 输入您在上面获取的 OAuth2 客户端 ID 和 OAuth2 客户端密钥。
- 在标记为 Step 1 - Select & authorize APIs 的部分中,可以选择已有的 或者 在底部的文本框中输入以下网址 (如果尚不存在),然后点击
Authorize APIs:
https://www.googleapis.com/auth/adwords
- 如果出现提示,请登录到要向其授予访问权限和进行授权的帐号。否则,请确认目前右上角的 Google 用户是您要取得凭据的 AdWords 帐号或经理帐号。
如果出现提示,请登录到要向其授予访问权限和进行授权的帐号。否则,请确认目前右上角的 Google 用户是您要取得凭据的 AdWords 帐号或经理帐号。
-
系统会提示您,您的应用希望管理您的 AdWords 等广告系列。点击 Accept 以继续。
-
现在,在标记为 Step 2 - Exchange authorization code for tokens 的标签中,您应该会看到 Authorization code。点击
Exchange authorization code for tokens
。
-
如果一切顺利,您应该会看到系统已为您填写 Refresh token 和 Access token(您可能需要重新展开 Step 2 - Exchange authorization code for tokens 查看这些值):
- 将刷新令牌连同客户端 ID 和客户端密钥复制到您选择的客户端库的配置文件中
您现在拥有了 OAuth 凭据,可以发出 AdWords API 请求
https://developers.google.com/adwords/api/docs/guides/authentication#webapp