本指南面向希望使用 AdMob API 以编程方式在 AdMob 账号中获取 数据的开发者。
所有 Google AdMob API 调用都必须通过 OAuth2 进行授权,以便您的应用可以代表用户与 Web 服务进行交互。借助 OAuth2,您的 AdMob API 客户端应用就能够访问用户的 AdMob 账号,而无需处理或存储用户的用户名或密码。有关授权的概述,请参阅授权。
请按以下步骤生成 OAuth2 凭据并发出第一个请求。
前提条件
确定您的身份验证类型
请查看下表,了解哪种身份验证类型最适合您的应用:
选择您的 OAuth2 身份验证类型 | 如果... |
---|---|
桌面应用 |
|
Web 应用 |
|
创建项目
若要开始使用 AdMob API,您需要先在 Google API 控制台中创建或选择一个项目,然后使用设置工具启用该 API。该工具会引导您完成整个流程并自动启用 AdMob API。
为现有项目启用该 API
以下步骤适用于已有项目并希望手动为该项目启用 AdMob API 的用户。
Για να ενεργοποιήσετε ένα API για το έργο σας:
- Open the API Library στο Google API Console .
- If prompted, select a project, or create a new one. Το API Library παραθέτει όλα τα διαθέσιμα API, ομαδοποιημένα ανά οικογένεια προϊόντων και δημοτικότητα.
- Εάν το API που θέλετε να ενεργοποιήσετε δεν είναι ορατό στη λίστα, χρησιμοποιήστε την αναζήτηση για να το βρείτε ή κάντε κλικ στην επιλογή Προβολή όλων στην οικογένεια προϊόντων στην οποία ανήκει.
- Επιλέξτε το API που θέλετε να ενεργοποιήσετε και, στη συνέχεια, κάντε κλικ στο κουμπί Ενεργοποίηση .
- If prompted, enable billing.
- If prompted, read and accept the API's Terms of Service.
创建 OAuth2 凭据
以下说明将引导您完成创建 OAuth 2.0 客户端 ID(以便在“已安装的应用”流程中使用)的整个过程。
- Go to the Credentials page.
依次点击创建凭据 > OAuth 客户端 ID。
如果您之前没有为此项目配置 OAuth 同意屏幕,系统会引导您立即执行此操作。点击配置权限请求页面。您可以通过多种方式配置同意页面以使用 OAuth 2.0 客户端 ID。
- 将您的用户类型设置为外部,并将发布状态设置为已发布。
或者,将用户类型设置为外部,将发布状态设置为测试,然后选择添加用户以添加测试用户,让他们有权使用您的 OAuth 2.0 客户端 ID。
如需了解详情,请参阅设置 OAuth 权限请求页面。
选择桌面应用或Web 应用作为应用类型,为其命名,然后点击创建。
完成后,系统会显示一个 OAuth 2.0 客户端 ID 和客户端密钥,您可以将其下载为 JSON 格式进行保存,以备日后使用。
发出请求
AdMob API 是基于 HTTP 和 JSON 构建的,因此任何标准 HTTP 客户端均可向其发送请求并解析响应。不过,使用 Google API 客户端库将为您带来优势,例如语言集成更出色、安全性更高,且支持发出经过授权的请求。客户端库支持多种编程语言;使用客户端库可以避免手动设置 HTTP 请求和手动解析响应。
创建 OAuth 2.0 凭据后,您便可以开始使用 AdMob API 了。如需使用 OAuth 2.0 请求访问权限,您的应用还需要提供范围信息:
范围 | 含义 |
---|---|
https://www.googleapis.com/auth/admob.readonly |
查看所有 AdMob 数据。这可能包括账号信息、广告资源和中介设置、报告以及其他数据。 此类数据不包括敏感数据,例如付款或广告系列详细信息。 |
https://www.googleapis.com/auth/admob.report |
查看广告效果和收入报告。请查看发布商 ID、时区和默认货币代码。 |
使用 Java、PHP、Python 或 curl 中的示例发出首次请求以生成报告。
撤消共享令牌
您可以通过以下两种方式撤消共享的令牌:
前往Google 账号权限页面,然后撤消对相关项目的访问权限。
或者,您也可以使用 Google Identity API 撤消网站应用令牌。