Authentication

所有 Google Ad Manager API 调用都必须通过 OAuth2 进行授权。OAuth2 是一种开放标准，可让用户向第三方应用授予权限，以便该应用能够代表用户与 Web 服务进行互动。借助 OAuth2，您的 Ad Manager API 客户端应用就能够访问用户的 Ad Manager 账号，而无需处理或存储用户的用户名或密码。

生成 OAuth2 凭据

请执行以下步骤来生成 OAuth2 凭据。

1. 确定您的身份验证类型

请查看下表，了解哪种身份验证类型最适合您的 Ad Manager API 应用：

2. 创建 OAuth2 凭据

确定身份验证类型后，点击下方的相应标签页，然后按照说明生成 OAuth2 凭据：

服务账号

1. 打开 Google API 控制台“凭据”页面。
2. 从项目下拉菜单中选择创建新项目，输入项目名称，并根据需要修改提供的项目 ID。点击创建。
3. 在“凭据”页面上，选择创建凭据，然后选择服务账号密钥。
4. 选择新的服务账号，然后选择 JSON。
5. 点击创建，下载包含私钥的文件。

Web 应用

1. 打开 Google API 控制台“凭据”页面。
2. 从项目下拉菜单中，选择创建新项目，输入项目名称（还可以选择修改提供的项目 ID），然后点击创建。
3. 在“凭据”页面上，选择创建凭据，然后选择 OAuth 客户端 ID。
4. 系统可能会提示您在“权限请求页面”上设置商品名称；如果出现这种情况，请点击配置权限请求页面，提供要求的信息，然后点击保存以返回到“凭据”页面。
5. 为应用类型选择 Web 应用。按照说明输入 JavaScript 来源、重定向 URI 或同时输入两者。
6. 点击创建。
7. 在随即显示的页面上，将客户端 ID 和客户端密钥复制到剪贴板，您在配置客户端库时需要用到这些信息。

3. 配置 Ad Manager 广告资源网

如果您是第三方开发者，则可能需要让您的客户为您执行此步骤。

4. 配置和使用客户端库

请按照下方的相应指南在客户端库中使用凭据：

如果您选择不使用我们的任何客户端库，则需要自行实现 OAuth2 服务账号或 Web 应用流程。

幕后花絮

我们的客户端库会自动处理以下所涉及的详细信息，因此只有在您对后台发生的情况感兴趣时，才需要继续阅读。 本部分的目标读者是熟悉 OAuth2 规范并且了解如何结合使用 OAuth2 和 Google API 的高级用户。

HTTP 请求标头

向 Ad Manager API 发送的每个请求中的 HTTP 标头都必须包含以下格式的访问令牌：

Authorization: Bearer ACCESS_TOKEN

例如：

POST … HTTP/1.1
Host: …
Authorization: Bearer 1/fFAGRNJru1FTz70BzhT3Zg
Content-Type: text/xml;charset=UTF-8
Content-Length: …

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope">
…
</soap:Envelope>

范围

一个访问令牌可以授予对多个 API 的不同程度的访问权限。一个名为 scope 的可变参数用于控制访问令牌允许的一组资源和操作。在请求访问令牌期间，您的应用会在 scope 参数中发送一个或多个值。

Ad Manager 只有一个范围，如下所示。授权应在产品内以用户级执行。