百度信息流推广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
      }
    }
    上一篇
    推广单元模块-附录
    下一篇
    定向包对象