授权

您的应用向 AdMob API 发送的每个请求都必须包含授权令牌。Google 也可通过此令牌识别您的应用。

关于授权协议

您的应用必须使用 OAuth 2.0 向请求授权,其他任何授权协议均不受支持。如果您的应用使用使用 Google 账号登录,系统会代您执行授权方面的某些操作。

使用 OAuth 2.0 向请求授权

向 AdMob API 发出的所有请求都必须由已通过身份验证的用户授权。

使用 OAuth 客户端 ID 可以简化此流程。

获取 OAuth 客户端 ID

或者在“凭据”页面中创建一个 OAuth 客户端 ID。

根据您所编写的应用的类型,OAuth 2.0 的具体授权流程可能会有所不同。下面是适用于所有应用类型的大致流程:

  1. 当您的应用需要访问用户数据时,它会请求 Google 提供特定范围的访问权限。
  2. Google 会向相应用户显示权限请求页面,让用户授权您的应用请求他们的某些数据。
  3. 待该用户同意后,Google 会为您的应用提供一个时效很短的访问令牌
  4. 您的应用会请求获取用户数据,并在请求中附上该访问令牌。
  5. 如果 Google 确定您的请求及令牌有效,就会返回您所请求的数据。

有些流程还包含其他步骤,例如使用刷新令牌获取新的访问令牌。如需详细了解适用于各类应用的不同流程,请参阅 Google 的 OAuth 2.0 文档

以下是 AdMob API 的 OAuth 2.0 范围信息:

范围 含义
https://www.googleapis.com/auth/admob.readonly 查看所有 AdMob 数据。这可能包括帐号信息、广告资源和中介设置、报告以及其他数据。 其中不包括敏感数据,例如付款或广告系列详细信息。
https://www.googleapis.com/auth/admob.report 查看广告效果和收入报告。查看发布商 ID、时区和默认货币代码。

要通过 OAuth 2.0 请求访问权限,您的应用既需要授权范围信息,也需要 Google 在您注册应用时提供的信息(如客户端 ID 和客户端密钥)。

提示:Google API 客户端库可帮您处理部分授权流程,并且支持多种编程语言;有关详情,请参阅库和示例页面