菜单

广告管理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 用户名
code int 状态码
msg 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
    }
}

 

二、编辑广告

1、接口说明

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

 

2、接口路径

POST https://xmp-open.mobvista.com/v1/media/edit/submit

 

3、请求参数

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

参数 类型 必填 说明

level

string

Y

编辑广告层级：campaign，adset，ad

edit_items

[]object

Y

编辑数据：

  1. status：string类型，状态值（ACTIVE代表开，PAUSED代表关）
  2. id：string类型，各层级广告id
  3. account_id：string类型，账号id
  4. item_name：string类型，广告名称
  5. channel：string类型，渠道枚举值
  6. update_fields：[]string类型，编辑字段（目前只支持status）

示例：

[
	{
		"status": "ACTIVE",
		"id": "23632877728",
		"account_id": "1916883880",
		"item_name": "创意组1_标准_9314",
		"channel": "google",
		"update_fields": [
			"status"
		]
	}
]
 

4、返回参数

参数 类型 说明
code int 状态码
msg string 错误信息
data []int 创建成功后的任务id集合

 

三、获取编辑广告任务

1、接口说明

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

 

2、接口路径

POST https://xmp-open.mobvista.com/v1/media/edit/jobList

 

3、请求参数

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

参数 类型 必填 说明

job_ids

[]int

Y

任务id集合
 

4、返回参数

参数 类型 说明
code int 状态码
msg string 错误信息
data []object 列表数据
data[].id int 任务id
data[].module string 渠道枚举值
data[].req_id string 随机生成的请求id
data[].item_id string 广告id
data[].execute_count int 重试次数
data[].status string 状态
data[].job_activity string 任务类型

 

 

 

 

上一个
素材库API
下一个
用户管理API
最近修改: 2026-03-16Powered by