بدء استخدام واجهة برمجة تطبيقات AdMob

ملاحظة مهمة: ستؤثّر أدوار المستخدِمِين وأذوناتهم الجديدة في البيانات التي تعرضها واجهة برمجة تطبيقات AdMob. مزيد من المعلومات

هذا الدليل مخصَّص للمطوّرين الذين يريدون استخدام واجهة برمجة تطبيقات AdMob للحصول على معلومات آليًا عن حساباتهم على AdMob.

所有 Google AdMob API 调用都必须通过 OAuth2 进行授权，以便您的应用可以代表用户与 Web 服务进行交互。借助 OAuth2，您的 AdMob API 客户端应用就能够访问用户的 AdMob 账号，而无需处理或存储用户的用户名或密码。有关授权的概述，请参阅授权。

请按以下步骤生成 OAuth2 凭据并发出第一个请求。

前提条件

• Google 账户。

• Google AdMob 账号。

• 熟悉 REST 基础知识和使用 OAuth 2.0 为请求授权。

确定您的身份验证类型

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

选择您的 OAuth2 身份验证类型	如果...
桌面应用	您正在使用一个顶级经理账号管理所有 AdMob API 账号。 您是首次使用的用户，或者想要使用最简单的设置快速上手。 您的应用只通过一台机器对 Google AdMob 用户进行身份验证。
Web 应用	您想以能够授权您的应用访问其 AdMob API 账号数据的用户身份进行身份验证。 您希望轻松生成多个授权凭据，以便管理（比如）第三方账号。 您的应用需要回调网址。桌面应用流程不支持回调网址。

要点 ：即使您要开发一款要在服务器上运行的应用，也仍然可以选择桌面应用流程。区别在于 OAuth 授权是在本地还是远程完成的。桌面流程需要在本地机器上完成授权，而 Web 流程允许在 Google 的授权服务器上完成授权。

创建项目

若要开始使用 AdMob API，您需要先在 Google API 控制台中创建或选择一个项目，然后使用设置工具启用该 API。该工具会引导您完成整个流程并自动启用 AdMob API。

为现有项目启用该 API

以下步骤适用于已有项目并希望手动为该项目启用 AdMob API 的用户。

لتمكين واجهة برمجة التطبيقات لمشروعك:

1. Open the API Library في Google API Console .
2. If prompted, select a project, or create a new one. يسرد API Library جميع واجهات برمجة التطبيقات المتاحة ، مجمعة حسب عائلة المنتج والشعبية.
3. إذا لم تكن واجهة برمجة التطبيقات التي تريد تمكينها مرئية في القائمة ، فاستخدم البحث للعثور عليها ، أو انقر فوق عرض الكل في عائلة المنتج التي تنتمي إليها.
4. حدد واجهة برمجة التطبيقات التي تريد تمكينها ، ثم انقر فوق الزر تمكين .
5. If prompted, enable billing.
6. If prompted, read and accept the API's Terms of Service.

创建 OAuth2 凭据

以下说明将引导您完成创建 OAuth 2.0 客户端 ID（以便在“已安装的应用”流程中使用）的整个过程。

1. Go to the Credentials page.

2. 依次点击创建凭据 > OAuth 客户端 ID。

   如果您之前没有为此项目配置 OAuth 同意屏幕，系统会引导您立即执行此操作。点击配置权限请求页面。您可以通过多种方式配置同意页面以使用 OAuth 2.0 客户端 ID。

   1. 将您的用户类型设置为外部，并将发布状态设置为已发布。

   2. 或者，将用户类型设置为外部，将发布状态设置为测试，然后选择添加用户以添加测试用户，让他们有权使用您的 OAuth 2.0 客户端 ID。

      如需了解详情，请参阅设置 OAuth 权限请求页面。

3. 选择桌面应用或Web 应用作为应用类型，为其命名，然后点击创建。

完成后，系统会显示一个 OAuth 2.0 客户端 ID 和客户端密钥，您可以将其下载为 JSON 格式进行保存，以备日后使用。

发出请求

AdMob API 是基于 HTTP 和 JSON 构建的，因此任何标准 HTTP 客户端均可向其发送请求并解析响应。不过，使用 Google API 客户端库将为您带来优势，例如语言集成更出色、安全性更高，且支持发出经过授权的请求。客户端库支持多种编程语言；使用客户端库可以避免手动设置 HTTP 请求和手动解析响应。

注意 ：首次启用 OAuth 流程时，系统会要求您提供 AdMob 发布商 ID，并在浏览器中接受授权提示。接受之前，请务必使用可访问您的 AdMob 账号的 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、时区和默认货币代码。

使用 Java、PHP、Python 或 curl 中的示例发出首次请求以生成报告。

撤消共享令牌

您可以通过以下两种方式撤消共享的令牌：

1. 前往Google 账号权限页面，然后撤消对相关项目的访问权限。

2. 或者，您也可以使用 Google Identity API 撤消网站应用令牌。