批量更新推广组

批量更新推广组

HTTP请求方式

POST

请求地址

https://ms-api.e.360.cn/v1/group/batch_update

Headers 请求参数

字段	类型	必须	描述
Content-Type	string	yes	application/x-www-form-urlencoded
apiKey	string	yes	注册时分配到的api key，该参数作为HTTP HEAD字段传递。
accessToken	string	yes	访问token

Body 请求参数

字段	类型	必须	描述
groups	string	yes	JSON 格式的推广组对象数组，单次请求提交数量最多100个。

groups示例

[{
        "id": 4301674883,
        "area_code":1,
        "area_country": [2,3,4],
        "area_region": [2,3,4],
        "area_province": [2,3,4],
        "area_city": [2,3,4],
        "price": 123,
        "disabled": 2,
        "crowd_sex": [2,3,4],
        "crowd_life_stage": 1,
        "ages": [2,3,4],
        "stages": [2,3,4]
    },
    {
        "id": 4301674884,
        "area_code":1,
        "area_country": [2,3,4],
        "area_region": [2,3,4],
        "area_province": [2,3,4],
        "area_city": [2,3,4],
        "price": 123,
        "disabled": 1,
        "crowd_sex": [2,3,4],
        "crowd_life_stage": 1,
        "ages": [2,3,4],
        "stages": [2,3,4]
    }
]

字段说明

字段	类型	必须	描述
id	int	Yes	推广组id
disabled	int	No	推广组状态：0启用, 1暂停，2删除
area_code	int	No	地域定向：1不限；2指定地域；
area_country	Array	No	地域定向：国家，area_code=2时有效
area_region	Array	No	地域定向：大区，包含：东北、华北、华东、中南等，area_code=2时有效
area_province	Array	No	地域定向：省， area_code=2时有效
area_city	Array	No	地域定向：市， area_code=2时有效，*特别说明：地域定向以最细粒度为准，例如：area_province传了某个省，然后area_city又传了该省下的一个市，则仅该市有效，选择的省不生效；如果area_province传了某个省，area_city传的市不属于所传省，则area_province传的省有效；此规则适用于地域定向的四个字段
price	int	No	出价,单位为分,只能是整数,出价范围1-99900
crowd_sex	Array	No	指定性别：传值[1,2,99]，如果传空数组[]则不限
crowd_life_stage	int	No	阶段： 0不限；1指定年龄；2指定人生阶段，该字段传1时，ages字段有效，传2时，stages字段有效，传0时，均无效
ages	Array	No	指定年龄，当crowd_life_stage=1时，该字段必传
stages	Array	No	指定人生阶段，当crowd_life_stage=2时，该字段必传

请求示例

curl -X POST \ 
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--data 'format=JSON&groups=[{"id":4301674883,"area_code":1,"area_country":[2,3,4],"area_province":[2,3,4],"area_city":[2,3,4],"price":123,"disabled":2,"crowd_sex":[2,3,4],"crowd_life_stage":1,"ages":[2,3,4],"stages":[2,3,4]},{"id":4301674883,"area_code":1,"area_country":[2,3,4],"area_province":[2,3,4],"area_city":[2,3,4],"price":123,"disabled":1,"crowd_sex":[2,3,4],"crowd_life_stage":1,"ages":[2,3,4],"stages":[2,3,4]},"pmp_price":{"123":1000,"234":1100}]' \ 
'https://ms-api.e.360.cn/v1/group/batch_update'

返回结果

{
    "err_no": 10000,
    "err_msg": "",
    "data": [
        {
        "affectedRecords": 0,
        "failIds": [
            607121140,
            607121139
        ],
        "failures": [
            {
                "code": 1002005,
                "description": "",
                "message": "预算金额错误"
            },
            {
                "code": 1002005,
                "description": "",
                "message": "ID非法"
            }
        ]
    }
    ]
}

返回结果说明

字段	类型	描述
affectedRecords	int	更新成功的推广组个数
failIds	array	更新失败的推广组ID
failures	array	更新失败的错误信息，与failIds中的id顺序一一对应

results matching ""

No results matching ""