# shopping-guide.updateGuideMasssendJob

本接口应在服务器端调用，详细说明参见服务端API。

修改群发任务

无法修改已经执行的任务，返回参数错误。

# 请求地址

POST https://api.weixin.qq.com/cgi-bin/guide/updateguidemassendjob?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证
task_id	number	是	任务id
task_name	string	否	群发任务名称,不超过16字
task_remark	string	否	群发任务备注,不超过100字
push_time	number	否	下发时间, 秒级时间戳, 范围为当前时间开始到最近一个月内
openid	Array.<string>	否	客户openid列表
material	Array.<Object>	否	不超过3个素材

material的结构

属性	类型	说明
type	number	素材类型,1.文本,3.图片,49.小程序卡片
media_id	string	图片类型素材或者卡片类型素材的封面，只能用《素材管理获取media_id》
title	string	小程序卡片标题,最多35字
path	string	小程序卡片路径
appid	string	小程序卡片appid,需要关联到公众号
word	string	文本类型素材的内容,不超过300字节

# 返回值

# Object

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息

errcode 的合法值

值	说明	最低版本
0	成功
-1	系统失败
40097	参数错误
40003	无效的openid
43004	没有关注该服务号
9300801	无效的微信号
9300804	该微信号不是顾问
9300806	客户和顾问不存在绑定关系
9300807	标签值无效，不是可选标签值
9300819	media_id无效
40168	小程序卡片appid没有和公众号关联

参数错误包含：task_name超长、task_remark超长、push_time超出范围、material超过 3 个、小程序素材appid和title非法等

# 请求数据示例

{
    "task_id": 1332414111522783232,
    "task_name":"testtask_name111",
    "task_remark":"testtask_remark111",
    "push_time": 1589010582,
    "openid":[
        "yyyyyyyy"
    ],
    "material": [
        {
            "type":1,
            "word":"testword"
        },
        {
            "type":3,
            "media_id": "xxxxxxxxxxxxxx"
        },
        {
            "type":49,
            "media_id": "xxxxxxxxxxxxxx",
            "title":"test_title",
            "path":"page/index/index",
            "appid":"wxzzzzzzzzzzzz"
        }
    ]
}

# 返回数据示例

{
  "errcode": 0,
  "errmsg": "ok"
}