百青藤自定义媒体包接口

更新时间：2020-08-11

查询百青藤自定义媒体包

接口描述

该接口用于查询百青藤自定义媒体包信息。

接口URL

http://sem.baidubce.com/v1/feed/cloud/CustomMPService/getCustomMP

请求参数说明

字段名称	类型	描述
mpids	array(number)	需要查询的百青藤自定义媒体包id集合，[]表示查询当前账户下所有百青藤自定义媒体包

响应参数说明

字段名称	类型	描述
mpid	number	百青藤自定义媒体包id
mpName	string	百青藤自定义媒体包名称
mpType	number	百青藤自定义媒体包类型，0-定向 1-屏蔽
mediaids	array(number)	百青藤自定义媒体包内的媒体ID集合
mediaIdCount	number	百青藤自定义媒体包内媒体ID总数
adgroupFeedIds	array(number)	百青藤自定义媒体包绑定的单元集合
flowType	number	百青藤自定义媒体包流量类型，0-移动 1-计算机

请求示例

POST /v1/feed/cloud/CustomMPService/getCustomMP HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟，需要替换成自己生成的签名)
Accept: '*/*'
{
    "header": {
        "opUsername": "example",
        "tgUsername": "example",
        "bceUser": "example",
        "opPassword": "example",
        "tgPassword": "example"
    },
    "body": {
        "mpids": [164601222220]
    }
}

响应示例

{
    "body": {
        "data": [
            {
                "flowType":0,
                "adgroupFeedIds": [3739688195],
                "mpType": 0,
                "mediaIdCount": 1,
                "mpName": "通用定向包",
                "mediaids": [100001],
                "mpid": 164601222220
            }
        ]
    },
    "header": {
        "oprs": 1,
        "failures": [],
        "succ": 1,
        "oprtime": 0,
        "desc": "success",
        "status": 0
    }
}

新增百青藤自定义媒体包

接口描述

新增百青藤自定义媒体包。（说明：目前最多支持添加100个百青藤自定义媒体包）

接口URL

http://sem.baidubce.com/v1/feed/cloud/CustomMPService/addCustomMP

请求参数说明

字段名称	类型	描述
customMPs	array(object)	百青藤自定义媒体包对象，详细内容见百青藤自定义媒体包对象说明

百青藤自定义媒体包对象说明

字段名称	类型	描述
mpName	string	百青藤自定义媒体包名称
mpType	number	百青藤自定义媒体包类型，0-定向 1-屏蔽
mediaids	array(number)	百青藤自定义媒体包内的媒体ID集合
flowType	number	百青藤自定义媒体包流量类型，0-移动，1-计算机，选填字段，默认移动

响应参数说明 响应结果中会包含新增成功的百青藤自定义媒体包ID信息。

字段名称	类型	描述
mpid	number	百青藤自定义媒体包ID

请求示例

POST /v1/feed/cloud/CustomMPService/addCustomMP HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟，需要替换成自己生成的签名)
Accept: '*/*'
{
	"header": {
		"opUsername": "example",
		"tgUsername": "example",
		"bceUser": "example",
		"opPassword": "example",
		"tgPassword": "example"
	},
	"body": {
		"customMPs": [
            {
                "mpType": 0,
                "mpName": "通用定向包",
                "mediaids": [100001],
                "flowType": 1
            }
        ]
	}
}

响应示例

{
  "body": {
    "data": [
            {
                "mpid": 164601222220
            }
        ]
  },
  "header": {
    "oprs": 1,
    "failures": [],
    "succ": 1,
    "oprtime": 0,
    "desc": "success",
    "status": 0
  }
}

删除百青藤自定义媒体包

接口描述

删除百青藤自定义媒体包。

接口URL

http://sem.baidubce.com/v1/feed/cloud/CustomMPService/deleteCustomMP

请求参数说明

字段名称	类型	描述
mpids	array(number)	需要删除的百青藤自定义媒体包id集合

响应参数说明

响应结果中会包含删除成功的百青藤自定义媒体包ID信息。

字段名称	类型	描述
mpid	number	百青藤自定义媒体包ID

请求示例

POST /v1/feed/cloud/CustomMPService/deleteCustomMP HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟，需要替换成自己生成的签名)
Accept: '*/*'
{
	"header": {
		"opUsername": "example",
		"tgUsername": "example",
		"bceUser": "example",
		"opPassword": "example",
		"tgPassword": "example"
	},
	"body": {
		 "mpids": [164601222220]
	}
}

响应示例

{
  "body": {
    "data": [
            {
                "mpid": 164601222220
            }
        ]
  },
  "header": {
    "oprs": 1,
    "failures": [],
    "succ": 1,
    "oprtime": 0,
    "desc": "success",
    "status": 0
  }
}

更新百青藤自定义媒体包

接口描述

更新百青藤自定义媒体包, 目前只支持更新媒体包名称、媒体包内媒体ID。

接口URL

http://sem.baidubce.com/v1/feed/cloud/CustomMPService/updateCustomMP

请求参数说明

字段名称	类型	描述
customMPs	array(object)	百青藤自定义媒体包更新对象，详细内容见更新百青藤自定义媒体包对象

更新百青藤自定义媒体包对象说明

字段名称	类型	描述
mpid	string	百青藤自定义媒体包ID
mpName	string	百青藤自定义媒体包名称
mediaids	array(number)	百青藤自定义媒体包内的媒体ID集合

响应参数说明 响应结果中会包含更新成功的百青藤自定义媒体包信息,详细如下：

字段名称	类型	描述
mpid	number	百青藤自定义媒体包ID
mpName	string	百青藤自定义媒体包名称
mpType	number	百青藤自定义媒体包类型，0-定向 1-屏蔽
mediaids	array(number)	百青藤自定义媒体包内的媒体ID集合

请求示例

POST /v1/feed/cloud/CustomMPService/updateCustomMP HTTP/1.1
Accept-encoding: 'gzip, deflate'
Host: sem.baidubce.com
ContentType: application/json
Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟，需要替换成自己生成的签名)
Accept: '*/*'
{
	"header": {
		"opUsername": "example",
		"tgUsername": "example",
		"bceUser": "example",
		"opPassword": "example",
		"tgPassword": "example"
	},
	"body": {
		"customMPs": [
            {
                "mpid": 164601222220,
                "mpName": "通用定向包",
                "mediaids": [100001,100002]
            }
        ]
	}
}

响应示例

{
  "body": {
    "data": [
            {
                "mpid": 164601222220
                "mpName": "通用定向包",
                "mpType": 0,
                "mediaids": [100001,100002]
            }
        ]
  },
  "header": {
    "oprs": 1,
    "failures": [],
    "succ": 1,
    "oprtime": 0,
    "desc": "success",
    "status": 0
  }
}

推广单元模块-附录

定向包对象

百度信息流推广API

百度信息流推广API

百青藤自定义媒体包接口

查询百青藤自定义媒体包

新增百青藤自定义媒体包

删除百青藤自定义媒体包

更新百青藤自定义媒体包