组列表
HTTP请求方式
GET
请求地址
https://ms-api.e.360.cn/v1/group/list
字段 |
类型 |
必须 |
描述 |
Content-Type |
string |
yes |
application/x-www-form-urlencoded |
apiKey |
string |
yes |
注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken |
string |
yes |
访问token |
Get 请求参数
字段 |
类型 |
必须 |
描述 |
modify_time_begin |
string |
yes |
最后修改时间起始,精确到秒,例子:2020-01-01 01:00:33 |
modify_time_end |
string |
yes |
最后修改时间结束,精确到秒,例子:2020-01-02 01:00:50 |
page |
int |
no |
请求的页码,默认为第1页 |
per_page_count |
int |
no |
每页返回记录数,默认100,最大1000 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'adverts=[{"modify_time_begin":"2020-01-01 01:00:33","modify_time_end":"2020-01-02 01:00:50","page":1' \
'https://ms-api.e.360.cn/v1/group/list'
返回结果
{
"err_no": 10000,
"err_msg": "",
"data": {
"count": 188,
"list": [
{
"id": 607664645,
"name": "test",
"disabled": 0,
"plan_id": 36930156,
"last_modified": "2020-02-27T12:19:00+08:00",
"network_type": 0,
"equipment": 2,
"delivery_scope": 1,
"price_type": 1,
"price": 1000,
"media_type": 27,
"crowd_audience_desc": 0,
"crowd_exclude": 0,
"crowd_sex": "0",
"crowd_life_stage": "0",
"crowd_age": "0",
"convert_price": 66600,
"convert_id": 1004,
"smart_goods": 0,
"commodity_package": "0",
"system_recommendation": 0,
"shop_direct": 2,
"breeds": {
"Area": {
"dim_type": 1
},
"Interest": "",
"CrowdSteward": "",
"IndustryPreferredGroup": "",
"MediaResourcesRtb": "",
"MediaResourcesPmp": "",
"Keywords": ["关键词1","关键词2","关键词3"]
}
},
{
"id": 482559002,
"name": "1111",
"disabled": 1,
"plan_id": 36931440,
"last_modified": "2020-03-03T22:29:48+08:00",
"network_type": 1,
"equipment": 1,
"delivery_scope": 1,
"price_type": 1,
"price": 1000,
"media_type": 26,
"crowd_audience_desc": 0,
"crowd_exclude": 0,
"crowd_sex": "0",
"crowd_life_stage": "0",
"crowd_age": "0",
"convert_price": 0,
"convert_id": 0,
"smart_goods": 0,
"commodity_package": "0",
"system_recommendation": 0,
"shop_direct": 2,
"breeds": {
"area": {
"dim_type": 2,
"country": "1,504,8000",
"province": "142,223,294",
"city": ""
},
"interest": "",
"crowd_steward": "",
"industry_preferred_group": "",
"media_resources_rtb": "861,746,897,896,901,900,899,898,885,892,862,880,851,850,770,822,845,844,834,803,793,731,742,790,769,721,791,771,772,768,766,765,767,756,707,720,750,745,749,747,717,744,741,738,737,711,732,714,716,718,902,839,846,840,842,843,841,838,802,833,797,808,827",
"media_resources_pmp": [{
"dim_value": 35,
"breed_keyword_search": ["关键词1","关键词2"]
},
{
"dim_value": 62,
"breed_keyword_search": []
}],
"keywords": null
}
}
]
}
}
返回结果说明
字段 |
类型 |
描述 |
count |
Number |
总条数 |
list |
Json |
组列表,详见下方《list字段说明》 |
list字段说明
字段 |
类型 |
描述 |
id |
Number |
组ID |
name |
String |
组名称 |
disabled |
Number |
状态:0启用、1暂停 |
plan_id |
Number |
计划ID |
last_modified |
String |
最后修改时间 |
network_type |
String |
网络环境:0不限、1仅Wifi、2仅移动网络 |
equipment |
String |
设备类型:0不限、1仅智能手机、2仅平板电脑 |
delivery_scope |
Number |
投放范围:1信息流、2应用商店。计划推广目的为"应用激活"或"移动网站推广"时,投放范围仅能填信息流 |
media_type |
Number |
媒体定向类别:27全网通投、26指定媒体包、102指定应用、1优选资源位 |
price_type |
Number |
出价方式:1 cpc、2 cpm、3 oCpc、4 oCpm |
price |
Number |
出价(单位为分) |
crowd_audience_desc |
Number |
受众描述:0不限、1兴趣特征、2人群管家、3关键词、4行业优选人群 |
crowd_exclude |
Number |
排除人群:0不排除、1排除 |
crowd_sex |
String |
人群性别:0不限、多选用英文逗号分隔(1男、2女、99未知) |
crowd_life_stage |
String |
人生阶段:0不限、多选用英文逗号分隔(1中小学生、2大学生、3留学、4婚恋、5新婚、6孕产、7育儿、8买车、9有车、10家装、99其它) |
crowd_age |
String |
年龄:0不限、多选用英文逗号分隔(1:<19、2:19-24、3:25-34、4:35-49、5:>=50、99:未知)19、2:19-24、3:25-34、4:35-49、5:> |
convert_id |
Number |
转化目标ID,当 price_type=3或price_type=4时必填 |
convert_price |
Number |
转化目标价格(单位为分),当 price_type=3或price_type=4时必填 |
smart_goods |
Number |
智能商品投放:0无设置、1商品重定向、2商品包智能推荐 |
commodity_package |
String |
商品创建者id:商品包id |
system_recommendation |
Number |
系统推荐开关:1打开、0关闭。当crowd_audience_desc=0时只能填0。 |
shop_direct |
Number |
商品直投:1是、2否 |
ad_space_type_ids |
String |
广告类型ID列表,多个用英文逗号分隔,ID含义详见广告位类型列表,"0"代表不限 |
breeds |
Json |
定向数据,详见下面《定向数据说明》 |
定向数据说明
字段 |
类型 |
描述 |
area.dim_type |
Number |
地域定向类别:1不限、2指定地域 |
area.country |
String |
国家ID列表,多个用英文逗号分隔 |
area.province |
String |
省ID列表,多个用英文逗号分隔 |
area.city |
String |
市ID列表,多个用英文逗号分隔 |
interest |
String |
兴趣特征列表,多个用英文逗号分隔。被分隔的每个子项由a、b两部分组成,a_b,a代表兴趣特征标签ID,b代表兴趣特征类型(1移动应用兴趣、2通用兴趣) |
crowd_steward |
String |
360人群管家列表,多个用英文逗号分隔。被分隔的每个子项由a、b两部分组成,a:b,a代表人群ID(为负时代表排除人群),b代表人群所属用户ID |
industry_preferred_group |
String |
行业优选人群ID列表,多个用英文逗号分隔 |
media_resources_app |
Array |
媒体app id列表 |
media_resources_rtb |
String |
媒体包ID列表,多个用英文逗号分隔 |
media_resources_pmp |
Object |
媒体资源位列表 |
media_resources_pmp.dim_value |
Number |
媒体资源位ID |
media_resources_pmp.breed_keyword_search |
Array |
APP搜索词列表 |
keywords |
String |
关键词列表 |