菜单

广告管理API

一、获取广告账户基础属性

1、接口说明

（1）QPM限频为10，一分钟内请求超过10次会返回“请求太频繁”，需要等下一分钟才能再请求

（2）只返回未删除的广告账户

2、接口路径

POST https://xmp-open.mobvista.com/v2/media/account/list

3、请求参数

公共请求参数：请参考接口请求协议

参数	类型	必填	说明
channel	[]string	Y	媒体渠道，见渠道枚举值
account_id	[]string	N	最多传500个广告账户
page	int	N	页码
page_size	int	N	每页大小，1-1000，默认200

4、请求示例

let channel=["facebook"]
request = {
    url:uri,
    method:'POST',
    header:{'Content-Type':'application/json'},
    body:{
        mode:'raw',
        raw:JSON.stringify({
            client_id:clientId,
            timestamp:timestamp,
            sign:sign,
            channel:channel,
            account_id:["a","b"],
            page:page,
            page_size:pageSize
        }),
        options: {
            raw: {
                language: 'json'
            }
        }
    }
}

5、返回参数

参数	类型	说明
channel	string	渠道
account_id	string	广告账户 id
account_name	string	广告账户名称
alias_name	string	广告账户备注名
auth_status	string	授权状态： AUTHORIZED，已授权 AUTH_INVALID，授权失效 UNBINDED，已解绑
owner_user	object	所属人信息
owner_user.user_id	int	用户 id
owner_user.user_name	string	用户名
assist_user_list	[]object	协助人信息
assist_user_list.[0].user_id	int	用户 id
assist_user_list.[0].user_name	string	用户名

6、返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "list": [
            {
                "channel": "facebook",
                "account_id": "1111111",
                "account_name": "account1",
                "alisa_name": "",
                "auth_status": "AUTHORIZED",
                "owner_user": {
                    "user_id": 3,
                    "user_name": "user3"
                },
                "assist_user_list": [
                    {
                        "user_id": 1,
                        "user_name": "user1"
                    }
                ]
            }
        ],
        "total": 1,
        "page": 1,
        "page_size": 20
    }
}

上一个

素材库API

下一个

用户管理API

最近修改: 2024-04-10Powered by

大纲