背景

前期准备

  1. 请您的客户代表为账号设置适当的权限 应用将访问哪些资源
  2. 如果您不熟悉 Authorized Buyers 概念,请访问 Authorized Buyers 帮助中心和 您不妨试用一下界面。 如果您希望应用执行实时出价,请阅读 实时出价协议文档。
  3. 请访问 API 控制台 以设置新项目。登录您的开发者 Google 账号,或者 创建账号。然后,系统将提示您创建项目并签核 其中涉及几项服务条款。

家长和子账号

如果您在包含父级和子级的账号结构中执行操作 如果您能了解这些客户的运作机制 互动下文简要总结了以下内容:

儿童账号

拥有向儿童账户授予访问权限的凭据的用户只能 查看和修改与其账号关联的资源。子账号不可使用 查看或修改属于其他子账号或父账号的资源。

家长账号

拥有凭据(可向父级账号授予访问权限)的用户可以查看 除了所有关联的资源之外,还可以修改父级账号的资源, 子账号。对于列出所有给定资源的操作,此用户 会收到一条回复,其中包含有关其 账户及其所有 子账号。请注意,对于针对子席位的资源的其他类型的请求, 父级账号需要为子账号指定 accountId 路径参数 账号,而不是自己的 accountId

REST API 数据模型

资源是指具有唯一标识符的单个数据实体。通过 Accounts 资源代表 Authorized Buyers 账号条目,并且是根 数据类。该 API 的方法对 Accounts 资源以及 Accounts 资源的集合中。

账号 资源包括:账号 ID、用于 Cookie 匹配的信息, 出价工具位置、出价请求发送到的网址,以及 指定 Ad Exchange 每秒可发送的查询数量上限

除了账号资源和集合外,Ad Exchange Buyer API 定义了以下数据结构:

出价方位置

出价方位置是随账号资源一起返回的结构 提供广告交易平台将出价请求发送到的网址,以及 Ad Exchange 每秒应发送的查询次数上限。这里有一个 出价工具位置示例,以 JSON 表示:

"bidderLocation": [
    {
      "url": "http://bid.url.com/bidder",
      "maximumQps": 1500
    }
  ],

商品

其中条目用于提供账号列表。以下是项目的示例,以 JSON 表示:

{
  "kind": "adexchangebuyer#accountsList",
  "items": [
    accounts Resource
  ]
}

支持的操作

您可以对 Ad Exchange 买方 API(如下表所述)。所有操作都需要 授权

操作 说明 REST HTTP 映射
list 列出当前已通过身份验证的用户可以访问的所有账号 用户。 对集合 URI 执行 GET
get 获取特定的 Accounts 资源。 对资源 URI 执行 GET 操作。
update 更新特定的 Accounts 资源。 对资源 URI 执行 PUT,您可以在其中传入 已更新的资源。

调用样式

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

术语 REST 是“具象状态传输”的简称。在 Google API 的上下文中,指的是使用 HTTP 谓词来检索和修改由 Google 存储的数据的表示法。

在 RESTful 系统中,资源存储在数据存储区中;在客户端发送要求服务器执行特定操作(例如创建、检索、更新或删除资源)的请求之后,服务器便会执行该操作并发送响应,此响应的格式通常为所指定资源的表示法。

在 Google 的 RESTful API 中,客户端使用 HTTP 谓词(例如 POSTGETPUTDELETE)指定操作。它通过以下格式的全局唯一 URI 来指定资源:

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

由于所有 API 资源都具有 HTTP 可访问的唯一 URI,因此 REST 启用了数据缓存,而且经过优化以与网络的分布式基础架构一起使用。

您可能会发现 HTTP 1.1 标准文档中的方法定义十分有用;这些定义中包含了 GETPOSTPUTDELETE 的规范。

Ad Exchange Buyer API 中的 REST

受支持的操作直接映射到 REST HTTP 动词,如 API 操作

API URI 的具体格式为:

https://www.googleapis.com/adexchangebuyer/v1.4/resourceID?parameters

其中 resourceID 是 Accounts 资源和 parameters 为任意值 要应用于查询的参数。请参阅 标准查询参数参考文档 了解详情。

resourceID 路径扩展的格式 可让您标识目前正在操作的资源,例如:

https://www.googleapis.com/adexchangebuyer/v1.4/accounts
https://www.googleapis.com/adexchangebuyer/v1.4/accounts/id

请参阅 API 中每种受支持的操作所用的全部 URI 请参阅 参考文档

下面的示例展示了它在 Ad Exchange Buyer API 中的工作方式。

获取已通过身份验证的用户的账号列表:

GET https://www.googleapis.com/adexchangebuyer/v1.4/accounts

数据格式

JSON

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