前期准备
- 请您的客户代表为账号设置适当的权限 应用将访问哪些资源
- 如果您不熟悉 Authorized Buyers 概念,请访问 Authorized Buyers 帮助中心和 您不妨试用一下界面。 如果您希望应用执行实时出价,请阅读 实时出价协议文档。
- 请访问 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 谓词(例如 POST
、GET
、PUT
或 DELETE
)指定操作。它通过以下格式的全局唯一 URI 来指定资源:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
由于所有 API 资源都具有 HTTP 可访问的唯一 URI,因此 REST 启用了数据缓存,而且经过优化以与网络的分布式基础架构一起使用。
您可能会发现 HTTP 1.1 标准文档中的方法定义十分有用;这些定义中包含了 GET
、POST
、PUT
和 DELETE
的规范。
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。