def bind_device_location(self,
poi_id,
device_id=None,
uuid=None,
major=None,
minor=None):
"""
配置设备与门店的关联关系
详情请参考
http://mp.weixin.qq.com/wiki/15/b9e012f917e3484b7ed02771156411f3.html
:param poi_id: 待关联的门店ID
:param device_id: 设备编号，若填了UUID、major、minor，则可不填设备编号，若二者都填，则以设备编号为优先
:param uuid: UUID
:param major: major
:param minor: minor
:return: 返回的 JSON 数据包
"""
data = NotNoneDict()
data['poi_id'] = poi_id
data['device_identifier'] = {
'device_id': device_id,
'uuid': uuid,
'major': major,
'minor': minor
}
return self._post('shakearound/device/bindlocation', data=data)
def create(self,
user_id,
name,
department=None,
position=None,
mobile=None,
gender=0,
tel=None,
email=None,
weixin_id=None,
extattr=None):
"""
创建成员
详情请参考 http://qydev.weixin.qq.com/wiki/index.php?title=管理成员
"""
user_data = NotNoneDict()
user_data['userid'] = user_id
user_data['name'] = name
user_data['gender'] = gender
user_data['department'] = department
user_data['position'] = position
user_data['mobile'] = mobile
user_data['tel'] = tel
user_data['email'] = email
user_data['weixinid'] = weixin_id
user_data['extattr'] = extattr
return self._post('user/create', data=user_data)
def update_page(self,
page_id,
title,
description,
icon_url,
page_url,
comment=None):
"""
编辑页面信息
详情请参考
http://mp.weixin.qq.com/wiki/5/6626199ea8757c752046d8e46cf13251.html
:param page_id: 摇周边页面唯一ID
:param title: 在摇一摇页面展示的主标题，不超过6个字
:param description: 在摇一摇页面展示的副标题，不超过7个字
:param icon_url: 在摇一摇页面展示的图片。图片需先上传至微信侧服务器，
用“素材管理-上传图片素材”接口上传图片，返回的图片URL再配置在此处
:param page_url: 跳转链接
:param comment: 可选，页面的备注信息，不超过15个字
:return: 页面信息
"""
data = NotNoneDict()
data['page_id'] = page_id
data['title'] = title
data['description'] = description
data['icon_url'] = icon_url
data['page_url'] = page_url
data['comment'] = comment
res = self._post('shakearound/page/update', data=data)
return res['data']
def update_device(self,
device_id=None,
uuid=None,
major=None,
minor=None,
comment=None):
"""
更新设备信息
详情请参考
http://mp.weixin.qq.com/wiki/15/b9e012f917e3484b7ed02771156411f3.html
:param device_id: 设备编号，若填了UUID、major、minor，则可不填设备编号，若二者都填，则以设备编号为优先
:param uuid: UUID
:param major: major
:param minor: minor
:param comment: 设备的备注信息，不超过15个汉字或30个英文字母。
:return: 返回的 JSON 数据包
"""
data = NotNoneDict()
data['comment'] = comment
data['device_identifier'] = {
'device_id': device_id,
'uuid': uuid,
'major': major,
'minor': minor
}
return self._post('shakearound/device/update', data=data)
def get_by_filter(self, status=None, begin_time=None, end_time=None):
filter_dict = NotNoneDict()
filter_dict['status'] = status
filter_dict['begintime'] = begin_time
filter_dict['endtime'] = end_time
res = self._post('merchant/order/getbyfilter', data=dict(filter_dict))
return res['order_list']
def invite(self, user_id, tips=None):
"""
邀请成员关注
详情请参考 http://qydev.weixin.qq.com/wiki/index.php?title=管理成员
"""
data = NotNoneDict()
data['userid'] = user_id
data['invite_tips'] = tips
return self._post('invite/send', data=data)
def close_session(self, openid, account, text=None):
"""
多客服关闭会话
详情请参考
http://mp.weixin.qq.com/wiki/2/6c20f3e323bdf5986cfcb33cbd3b829a.html
:param openid: 客户 openid
:param account: 完整客服账号
:param text: 附加信息，可选
:return: 返回的 JSON 数据包
"""
data = NotNoneDict()
data['openid'] = openid
data['kf_account'] = account
data['text'] = text
return self._post('customservice/kfsession/close', data=data)
def send_video(self, agent_id, user_ids, media_id, title=None,
description=None, party_ids='', tag_ids='', safe=0):
video_data = NotNoneDict()
video_data['media_id'] = media_id
video_data['title'] = title
video_data['description'] = description
return self._send_message(
agent_id,
user_ids,
party_ids,
tag_ids,
msg={
'msgtype': 'video',
'video': dict(video_data),
'safe': safe
}
)
def apply_device_id(self, quantity, reason, poi_id=None, comment=None):
"""
申请设备ID
详情请参考
http://mp.weixin.qq.com/wiki/15/b9e012f917e3484b7ed02771156411f3.html
:param quantity: 申请的设备ID的数量，单次新增设备超过500个，需走人工审核流程
:param reason: 申请理由，不超过100个字
:param poi_id: 可选，设备关联的门店ID
:param comment: 可选，备注，不超过15个汉字或30个英文字母
:return: 申请的设备信息
"""
data = NotNoneDict()
data['quantity'] = quantity
data['apply_reason'] = reason
data['poi_id'] = poi_id
data['comment'] = comment
res = self._post('shakearound/device/applyid', data=data)
return res['data']
def update(self, id, name=None, parent_id=None, order=None):
"""
更新部门
详情请参考 http://qydev.weixin.qq.com/wiki/index.php?title=管理部门
:param id: 部门 id
:param name: 部门名称
:param parent_id: 父亲部门 id
:param order: 在父部门中的次序，从 1 开始，数字越大排序越靠后
:return: 返回的 JSON 数据包
"""
department_data = NotNoneDict()
department_data['id'] = id
department_data['name'] = name
department_data['parent_id'] = parent_id
department_data['order'] = order
return self._post(
'department/update',
data=dict(department_data)
)
def invite_user(self,
url,
token,
encoding_aes_key,
user_ids=None,
party_ids=None,
tag_ids=None,
invite_tips=None):
"""
邀请成员关注
详情请参考
http://qydev.weixin.qq.com/wiki/index.php?title=异步任务接口
:param url: 企业应用接收企业号推送请求的访问协议和地址，支持http或https协议
:param token: 用于生成签名
:param encoding_aes_key: 用于消息体的加密，是AES密钥的Base64编码
:param user_ids: 可选，成员ID列表，多个接收者用‘|’分隔，最多支持1000个。
:param party_ids: 可选，部门ID列表，多个接收者用‘|’分隔，最多支持100个。
:param tag_ids: 可选，标签ID列表，多个接收者用‘|’分隔。
:param invite_tips: 可选，推送到微信上的提示语
:return: 返回的 JSON 数据包
"""
data = NotNoneDict()
data['callback'] = {
'url': url,
'token': token,
'encodingaeskey': encoding_aes_key
}
if isinstance(user_ids, (tuple, list)):
user_ids = '|'.join(map(to_text, user_ids))
if isinstance(party_ids, (tuple, list)):
party_ids = '|'.join(map(to_text, party_ids))
if isinstance(tag_ids, (tuple, list)):
tag_ids = '|'.join(map(to_text, tag_ids))
data['touser'] = user_ids
data['toparty'] = party_ids
data['totag'] = tag_ids
data['invite_tips'] = invite_tips
return self._post('batch/inviteuser', data=data)
def search(self,
query,
category,
uid=None,
latitude=None,
longitude=None,
city=None,
region=None):
"""
发送语义理解请求
详情请参考
http://mp.weixin.qq.com/wiki/0/0ce78b3c9524811fee34aba3e33f3448.html
:param query: 输入文本串
:param category: 需要使用的服务类型，多个可传入列表
:param uid: 可选，用户唯一id（非开发者id），用户区分公众号下的不同用户（建议填入用户openid）
:param latitude: 可选，纬度坐标，与经度同时传入；与城市二选一传入
:param longitude: 可选，经度坐标，与纬度同时传入；与城市二选一传入
:param city: 可选，城市名称，与经纬度二选一传入
:param region: 可选，区域名称，在城市存在的情况下可省；与经纬度二选一传入
:return: 返回的 JSON 数据包
"""
if isinstance(category, (tuple, list)):
category = ','.join(category)
data = NotNoneDict()
data['query'] = query
data['category'] = category
data['uid'] = uid
data['latitude'] = latitude
data['longitude'] = longitude
data['city'] = city
data['region'] = region
data['appid'] = self._client.appid
return self._post(
url='https://api.weixin.qq.com/semantic/semproxy/search',
data=data
)
def set(self,
agent_id,
name=None,
description=None,
redirect_domain=None,
logo_media_id=None,
report_location_flag=0,
is_report_user=True,
is_report_enter=True):
"""
设置企业号应用
详情请参考 http://qydev.weixin.qq.com/wiki/index.php?title=设置企业号应用
:param agent_id: 企业应用的 id
:param name: 企业应用名称
:param description: 企业应用详情
:param redirect_domain: 企业应用可信域名
:param logo_media_id: 企业应用头像的mediaid，通过多媒体接口上传图片获得mediaid
:param report_location_flag: 企业应用是否打开地理位置上报 0：不上报；1：进入会话上报；2：持续上报
:param is_report_user: 是否接收用户变更通知
:param is_report_enter: 是否上报用户进入应用事件
:return: 返回的 JSON 数据包
"""
agent_data = NotNoneDict()
agent_data['agentid'] = agent_id
agent_data['name'] = name
agent_data['description'] = description
agent_data['redirect_domain'] = redirect_domain
agent_data['logo_mediaid'] = logo_media_id
agent_data['report_location_flag'] = report_location_flag
agent_data['isreportuser'] = 1 if is_report_user else 0
agent_data['isreportenter'] = 1 if is_report_enter else 0
return self._post(
'agent/set',
data=agent_data
)
def search_device(self,
identifiers=None,
apply_id=None,
begin=0,
count=10):
"""
查询设备列表
详情请参考
http://mp.weixin.qq.com/wiki/15/b9e012f917e3484b7ed02771156411f3.html
:param identifiers: 设备 ID 信息列表
:param apply_id: 批次ID，申请设备ID超出500个时所返回批次ID
:param begin: 设备列表的起始索引值
:param count: 待查询的设备个数
:return: 设备列表
"""
data = NotNoneDict()
data['begin'] = begin
data['count'] = count
data['apply_id'] = apply_id
if identifiers:
data['device_identifiers'] = identifiers
res = self._post('shakearound/device/search', data=data)
return res['data']