NewCreativeService

数据类型

SublinkType

SublinkType描述了计算机推广子链的数据类型。

SublinkInfo

SublinkInfo描述了单条计算机推广子链的数据类型。

PhoneType

EcallType

EcallGroupType

接口描述

getSublink

根据指定的id类型和id信息，获取推广子链。

Json示例

{
     "ids":[***,***,…],"device":***,"idType":***,"getTemp":***,"sublinkFields":["sublinkId","sublinkInfos","getTemp","pause","status"]
 }

输入信息（getSublinkRequest）

推广子链字段（sublinkFields）

基本字段是每次必返的字段（不论用户传不传）；复合字段是由多个简单属性组合的属性，用户请求会将这些简单字段打包返回；其余字段为简单字段，用户请求则返回。

返回信息（getSublinkResponse）

代码示例

• 请求

按照蹊径id获取蹊径的全部字段信息。 如果只需获取部分字段，只需填入需要获取的字段值；若需按单元id获取，请设置idType=5。

{
"header":{
	"opUsername":"searchlab",   			//mcc操作员账户名称
    "opPassword":"*********"        		//mcc操作员账户密码
    "tgUsername":"searchlab", 
    "tgPassword":"*********", 
    "tgSubname":"searchlab",				//mcc被操作的账户
    "bceUser":"014df051fa131234a2a*****" 	//mcc类型的bceuser
},
"body":{
    "ids": [
  		sublink_id
    ],
    "idType": 12,
    "sublinkFields": [
        "sublinkId",
        "adgroupId",
        "pause",
        "status",
        "sublinkInfos",
        "getTemp"
    ],
    "getTemp": 0
  }
}

• 返回

  { "header": { "desc": "success", "failures": [], "oprs": 2, "succ": 2, "oprtime": 0, "quota": used_quota_of_this_operation, "rquota": your_remain_quota, "status": 0 }, "body": { "data": [ { "sublinkId": sublinkId, "sublinkInfos": [ { "description": "Bi bro, Shifu go", "destinationUrl": "http://www.your_website.com//1" }, { "description": "Se bro, Shifu go", "destinationUrl": "http://www.your_website.com//2" }, { "description": "Bud, Shifu go", "destinationUrl": "http://www.your_website.com/***/3" } ], "adgroupId": 809942603, "pause": false, "status": 65, "device": 0 } ] } }

addSublink

新增计算机推广子链，可批量添加。

说明： 一个单元下目前最多支持1条计算机推广子链，因此如果该单元下已有推广子链，则会报错9116。

Json示意

{
     "sublinkTypes":[{"adgroupId":***,"pause":***,"status":***,"device":**,"sublinkInfos":[{"description":"***","destinationUrl":"***"},{"description":"***","destinationUrl":"***"},{"description":"***","destinationUrl":"***"}]},{***},…]
 }

输入信息（addSublinkRequest）

新增SublinkType的限制：

SublinkInfo的限制：

返回信息（addSublinkResponse）

代码示例

addSublink

• 请求 为某个单元添加一条蹊径：

  { "header":{ "opUsername":"searchlab", //mcc操作员账户名称 "opPassword":"*" //mcc操作员账户密码 "tgUsername":"searchlab", "tgPassword":"*", "tgSubname":"searchlab", //mcc被操作的账户 "bceUser":"014df051fa131234a2a*" //mcc类型的bceuser }, "body":{ "sublinkTypes": [ { "adgroupId": adgroup_id, "pause": false, "status": 0, "device": 0, "sublinkInfos": [ { "description": "Bi bro, Shifu go", "destinationUrl": "www.your_website.com//1" }, { "description": "Se bro, Shifu go", "destinationUrl": "www.your_website.com//2" }, { "description": "Bud, Shifu go", "destinationUrl": "www.your_website.com/***/3" } ] } ] } }

• 返回

返回用户添加的信息：

{
    "header": {
        "desc": "success",
        "failures": [],
        "oprs": 1,
        "succ": 1,
        "oprtime": 0,
        "quota": used_quota_of_this_operation,
        "rquota": your_remain_quota,
        "status": 0
    },
    "body": {
        "data": [
            {
                "sublinkId": new_sublink_id,
                "sublinkInfos": [
                    {
                        "description": "Bi bro, Shifu go",
                        "destinationUrl": "http://www.your_website.com/***/1"
                    },
                    {
                        "description": "Se bro, Shifu go",
                        "destinationUrl": "http://www.your_website.com/***/2"
                    },
                    {
                        "description": "Bud, Shifu go",
                        "destinationUrl": "http://www.your_website.com/***/3"
                    }
                ],
                "adgroupId": adgroup_id,
                "pause": false,
                "status": 65,
                "device": 0
            }
        ]
    }
}

updateSublink

更新计算机推广子链，可批量更新。

注意： 更新时，新提交的计算机推广子链会覆盖之前存在的推广子链，不管新提交的子链描述数是否大于之前的推广子链。

Json示例

{
     "sublinkTypes":[{"sublinkId":***,"adgroupId":***,"pause":***,"status":***,"device":**,"sublinkInfos":[{"description":"***","destinationUrl":"***"},{"description":"***","destinationUrl":"***"},{"description":"***","destinationUrl":"***"}]},{***},…]
 }

输入信息（updateSublinkRequest）

更新SublinkType的限制：

SublinkInfo的限制：

返回信息（updateSublinkResponse）

说明： 接口返回结果会自动补齐。例如客户在计算机推广子链信息1和3的位置上传了描述，但是没有在2的位置上传描述，在结果中是把3的内容补齐到2的位置。

代码示例

• 请求

更新一条蹊径。

{
"header":{
	"opUsername":"searchlab",   			//mcc操作员账户名称
    "opPassword":"*********"        		//mcc操作员账户密码
    "tgUsername":"searchlab", 
    "tgPassword":"*********", 
    "tgSubname":"searchlab",				//mcc被操作的账户
    "bceUser":"014df051fa131234a2a*****" 	//mcc类型的bceuser
},
"body":{
    "sublinkTypes": [
        {
            "sublinkId": sublink_id,
            "pause": false,
            "status": 0,
            "device": 0,
            "sublinkInfos": [
                {
                    "description": "Bi bro, Shifu go",
                    "destinationUrl": "www.your_website.com/***/1"
                },
                {
                    "description": "Se bro, Shifu go",
                    "destinationUrl": "www.your_website.com/***/2"
                },
                {
                    "description": "Bud, Shifu go",
                    "destinationUrl": "www.your_website.com/***/3"
                }
            ]
        }
    ]
  }
}

• 返回 只返回用户更新的字段信息：

  { "header": { "desc": "success", "failures": [], "oprs": 1, "succ": 1, "oprtime": 0, "quota": used_quota_of_this_operation, "rquota": your_remain_quota, "status": 0 }, "body": { "data": [ { "sublinkId": sublink_id, "sublinkInfos": [ { "description": "Bi bro, Shifu go", "destinationUrl": "http://www.your_website.com//1" }, { "description": "Se bro, Shifu go", "destinationUrl": "http://www.your_website.com//2" }, { "description": "Bud, Shifu go", "destinationUrl": "http://www.your_website.com/***/3" } ], "adgroupId": adgroup_id, "pause": false, "status": 62, "device": 0 } ] } }

deleteSublink

Json示例 删除指定的附加创意。

{
    "sublinkIds":[***,***,…]
}

输入信息（deleteSublinkRequest）

返回信息（deleteSublinkResponse）

代码示例

• 请求 删除两条蹊径：

  { "header":{ "opUsername":"searchlab", //mcc操作员账户名称 "opPassword":"*" //mcc操作员账户密码 "tgUsername":"searchlab", "tgPassword":"*", "tgSubname":"searchlab", //mcc被操作的账户 "bceUser":"014df051fa131234a2a*" //mcc类型的bceuser }, "body":{ "sublinkIds": [ sublink_id_1, sublink_id_2 ] } }

• 返回

  { "header": { "desc": "success", "failures": [], "oprs": 2, "succ": 2, "oprtime": 0, "quota": used_quota_of_this_operation, "rquota": your_remain_quota, "status": 0 }, "body": { "data": [ ] } }

getPhone

根据指定的单元ID或电话ID获取电话信息。

Json示例

{
    "ids":[***,***,…],"idType":9,"phoneFields":["phoneId","phoneNum","adgroupId",…]
 }

输入信息（getPhoneRequest）

推广电话字段（PhoneFields）

基本字段是每次必返的字段（不论用户传不传）；其余字段为简单字段，用户请求则返回。

返回信息（getPhoneResponse）

addPhone

输入信息（addPhoneRequest）

新增PhoneType的限制：

返回信息（addPhoneResponse）

updatePhone

输入信息（updatePhoneRequest）

更新PhoneType的限制：

返回信息（updatePhoneResponse）

getEcall

根据指定的单元ID或网页回呼ID获取网页回呼信息。

Json示例

{
"ids":[***,***,…],"idType":23,"ecallFields":[" ecallGroupid "," pause"," status",…]
 }

输入信息（getEcallRequest）

网页回呼字段（ecallFields）

其中，基本字段是每次必返的字段（不论用户传不传）；其余字段为简单字段，用户请求则返回。

返回信息（getEcallResponse）

addEcall

输入信息（addEcallRequest）

新增EcallType的限制：

返回信息（addEcallResponse）

updateEcall

输入信息（updateEcallRequest）

更新EcallType的限制：

返回信息（updateEcallResponse）

getEcallGroup

输出信息（getEcallGroupResponse）