前提条件

在开始编写首个客户端应用前,您先需要完成一些准备工作(如果您尚未完成的话),具体如下。

获取 Google 帐号

您需要拥有一个 Google 帐号才能在 Google API 控制台中创建项目。如果您已拥有 Google 帐号,则一切就绪。

为了进行测试,您可能还需要一个单独的 Google 帐号。

试用 Google AdMob

在继续本 API 文档前,我们假定您使用过 Google AdMob,且熟悉网络编程概念和网络数据格式。

如果您尚未使用过 Google AdMob,请在开始编码前,试用和熟悉一下用户界面

为客户端创建项目

在向 Google AdMob 发送请求前,您需要先将客户端的信息告知 Google,并激活 API 的访问权限。为此,请使用 Google API 控制台创建一个项目,即包含了各种设置和 API 访问信息的命名集合,然后注册您的应用。

要开始使用 AdMob API,您先需要使用设置工具,该工具会指导您在 Google API 控制台中创建项目、启用 API 和创建凭据。

了解 REST 基础知识

REST 是一种软件架构样式,它提供了方便、一致的数据请求和修改方法。

术语 REST 是“具象状态传输”(Representational State Transfer) 的简称。在 Google API 环境中,它指的是使用 HTTP 动词检索和修改 Google 所存储的数据的表示形式。

在 REST 型系统中,资源都存储在数据存储区中;客户端会发送一个请求让服务器执行特定的操作,如创建、检索、更新或删除资源,然后服务器执行相关的操作,并发送响应,此响应通常会采用已指定资源的表示形式。

在 Google 的 REST API 中,客户端会使用各种 HTTP 动词(如 POSTGETPUTDELETE)指定操作,并通过以下形式的全局唯一 URI 指定资源:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

因为所有 API 资源都有唯一的、可通过 HTTP 访问的 URI,所以 REST 不仅支持数据缓存,而且经过优化可用于网络的分布式基础架构。

如需了解详情,请参阅 HTTP 1.1 标准文档中的方法定义,其中包括针对 GETPOSTPUTDELETE 的规范。

AdMob API 中的 REST

AdMob API 操作与 REST HTTP 动词是直接映射的。

AdMob API URI 的具体格式为:

https://admob.googleapis.com/v1/resourcePath?parameters

有关 API 中支持的每项操作所用的全部 URI 的总结,请参见 AdMob API 参考文档。

了解 JSON 基础知识

AdMob API 返回的是 JSON 格式的数据。

JSON(即 JavaScript 对象表示法)是一种与语言无关的常见数据格式,可通过简单的文本方式来表示任意数据结构。有关详情,请参阅 json.org