百青藤自定义媒体包接口
所有文档

          百度信息流推广API

          百青藤自定义媒体包接口

          查询百青藤自定义媒体包

          接口描述

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

          接口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
            }
          }
          上一篇
          推广单元模块-附录
          下一篇
          定向包对象