品牌

获取指定网络下指定广告主下的所有品牌

GET /networks/:network_id/advertisers/:advertiser_id/brands

参数

page
可选 integer - 显示页码

默认显示页码为 ‘1’,起始页为 ‘1’ 而不是 ‘0’。pageper_page一起使用,例如当返回的数据超过 30 条时,可以通过设定 page显示 30 条之后的数据。

per_page
可选 integer - 分页数量,默认每页 30 条

返回数据的数目。当不指定per_page 时,默认最大返回 30 条数据。per_pagepage 一起使用显示一系列数据或者单独使用限制

响应

Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
[
  {
    "id": 30,//网络品牌 ID
    "name": "巧乐兹",//品牌名称
    "created_at": "2012-09-06T20:39:23Z"//品牌创建时间
  }
]

获取指定 ID 品牌详细信息

GET /networks/advertisers/brands/:id

响应

Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
    "id": 30,//网络品牌 ID
    "network_id": 11,//工作网络 ID
    "advertiser_id": 10231,//广告主 ID
    "name": "巧乐兹",//品牌名称
    "url": "http://track.admasterapi.com/networks/advertisers/brands/30",
    "created_at": "2012-09-06T20:39:23Z"//品牌创建时间
}

添加指定品牌到指定网络广告主下

POST /networks/:network_id/advertisers/:advertiser_id/brands

请求

{
    "name": "巧乐兹"
}
name
必填 string - 品牌名称

响应

Status: 201 Created 
Location: http://track.admasterapi.com/networks/11/advertisers/10231/brands
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
    "id": 30,//网络品牌 ID
    "network_id": 11,//工作网络 ID
    "advertiser_id": 10231,//广告主 ID
    "name": "巧乐兹",//品牌名称
    "url": "http://track.admasterapi.com/networks/advertisers/brands/30",
    "created_at": "2012-09-06T20:39:23Z"//品牌创建时间
}

修改指定的网络广告主下品牌名称

PATCH /networks/advertisers/brands/:id

请求

{
    "name": "巧乐鸡"
}
name
必选 string - 品牌名称

响应

Status: 200
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999

删除指定的网络广告主下品牌

DELETE /networks/advertisers/brands/:id

当品牌下有关联项目时,不能删除。

响应

Status: 204 No Content 
Location: http://track.admasterapi.com/networks/11/advertisers/10231/brands
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999