moment.go 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658
  1. package externalcontact
  2. import (
  3. "fmt"
  4. "github.com/silenceper/wechat/v2/util"
  5. )
  6. const (
  7. // addMomentTaskURL 创建发表任务
  8. addMomentTaskURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add_moment_task?access_token=%s"
  9. // getMomentTaskResultURL 获取任务创建结果
  10. getMomentTaskResultURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_task_result?access_token=%s&jobid=%s"
  11. // cancelMomentTaskURL 停止发表企业朋友圈
  12. cancelMomentTaskURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/cancel_moment_task?access_token=%s"
  13. // getMomentListURL 获取企业全部的发表列表
  14. getMomentListURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_list?access_token=%s"
  15. // getMomentTaskURL 获取客户朋友圈企业发表的列表
  16. getMomentTaskURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_task?access_token=%s"
  17. // getMomentCustomerListURL 获取客户朋友圈发表时选择的可见范围
  18. getMomentCustomerListURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_customer_list?access_token=%s"
  19. // getMomentSendResultURL 获取客户朋友圈发表后的可见客户列表
  20. getMomentSendResultURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_send_result?access_token=%s"
  21. // getMomentCommentsURL 获取客户朋友圈的互动数据
  22. getMomentCommentsURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_moment_comments?access_token=%s"
  23. // listMomentStrategyURL 获取规则组列表
  24. listMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/list?access_token=%s"
  25. // getMomentStrategyURL 获取规则组详情
  26. getMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/get?access_token=%s"
  27. // getRangeMomentStrategyURL 获取规则组管理范围
  28. getRangeMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/get_range?access_token=%s"
  29. // createMomentStrategyURL 创建新的规则组
  30. createMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/create?access_token=%s"
  31. // editMomentStrategyURL 编辑规则组及其管理范围
  32. editMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/edit?access_token=%s"
  33. // delMomentStrategyURL 删除规则组
  34. delMomentStrategyURL = "https://qyapi.weixin.qq.com/cgi-bin/externalcontact/moment_strategy/del?access_token=%s"
  35. )
  36. // AddMomentTaskRequest 创建发表任务请求
  37. type AddMomentTaskRequest struct {
  38. Text MomentTaskText `json:"text"`
  39. Attachments []MomentTaskAttachment `json:"attachments"`
  40. VisibleRange MomentVisibleRange `json:"visible_range"`
  41. }
  42. // MomentTaskText 发表任务文本消息
  43. type MomentTaskText struct {
  44. Content string `json:"content"`
  45. }
  46. // MomentTaskImage 发表任务图片消息
  47. type MomentTaskImage struct {
  48. MediaID string `json:"media_id"`
  49. }
  50. // MomentTaskVideo 发表任务视频消息
  51. type MomentTaskVideo struct {
  52. MediaID string `json:"media_id"`
  53. }
  54. // MomentTaskLink 发表任务图文消息
  55. type MomentTaskLink struct {
  56. Title string `json:"title"`
  57. URL string `json:"url"`
  58. MediaID string `json:"media_id"`
  59. }
  60. // MomentTaskAttachment 发表任务附件
  61. type MomentTaskAttachment struct {
  62. MsgType string `json:"msgtype"`
  63. Image MomentTaskImage `json:"image,omitempty"`
  64. Video MomentTaskVideo `json:"video,omitempty"`
  65. Link MomentTaskLink `json:"link,omitempty"`
  66. }
  67. // MomentVisibleRange 朋友圈指定的发表范围
  68. type MomentVisibleRange struct {
  69. SenderList MomentSenderList `json:"sender_list"`
  70. ExternalContactList MomentExternalContactList `json:"external_contact_list"`
  71. }
  72. // MomentSenderList 发表任务的执行者列表
  73. type MomentSenderList struct {
  74. UserList []string `json:"user_list"`
  75. DepartmentList []int `json:"department_list"`
  76. }
  77. // MomentExternalContactList 可见到该朋友圈的客户列表
  78. type MomentExternalContactList struct {
  79. TagList []string `json:"tag_list"`
  80. }
  81. // AddMomentTaskResponse 创建发表任务响应
  82. type AddMomentTaskResponse struct {
  83. util.CommonError
  84. JobID string `json:"jobid"`
  85. }
  86. // AddMomentTask 创建发表任务
  87. // see https://developer.work.weixin.qq.com/document/path/95094#%E5%88%9B%E5%BB%BA%E5%8F%91%E8%A1%A8%E4%BB%BB%E5%8A%A1
  88. func (r *Client) AddMomentTask(req *AddMomentTaskRequest) (*AddMomentTaskResponse, error) {
  89. var (
  90. accessToken string
  91. err error
  92. )
  93. if accessToken, err = r.GetAccessToken(); err != nil {
  94. return nil, err
  95. }
  96. var response []byte
  97. if response, err = util.PostJSON(fmt.Sprintf(addMomentTaskURL, accessToken), req); err != nil {
  98. return nil, err
  99. }
  100. result := &AddMomentTaskResponse{}
  101. if err = util.DecodeWithError(response, result, "AddMomentTask"); err != nil {
  102. return nil, err
  103. }
  104. return result, nil
  105. }
  106. // GetMomentTaskResultResponse 获取任务创建结果响应
  107. type GetMomentTaskResultResponse struct {
  108. util.CommonError
  109. Status int `json:"status"`
  110. Type string `json:"type"`
  111. Result MomentTaskResult `json:"result"`
  112. }
  113. // MomentTaskResult 任务创建结果
  114. type MomentTaskResult struct {
  115. ErrCode int64 `json:"errcode"`
  116. ErrMsg string `json:"errmsg"`
  117. MomentID string `json:"moment_id"`
  118. InvalidSenderList MomentInvalidSenderList `json:"invalid_sender_list"`
  119. InvalidExternalContactList MomentInvalidExternalContactList `json:"invalid_external_contact_list"`
  120. }
  121. // MomentInvalidSenderList 不合法的执行者列表
  122. type MomentInvalidSenderList struct {
  123. UserList []string `json:"user_list"`
  124. DepartmentList []int `json:"department_list"`
  125. }
  126. // MomentInvalidExternalContactList 不合法的可见到该朋友圈的客户列表
  127. type MomentInvalidExternalContactList struct {
  128. TagList []string `json:"tag_list"`
  129. }
  130. // GetMomentTaskResult 获取任务创建结果
  131. // see https://developer.work.weixin.qq.com/document/path/95094#%E8%8E%B7%E5%8F%96%E4%BB%BB%E5%8A%A1%E5%88%9B%E5%BB%BA%E7%BB%93%E6%9E%9C
  132. func (r *Client) GetMomentTaskResult(jobID string) (*GetMomentTaskResultResponse, error) {
  133. var (
  134. accessToken string
  135. err error
  136. )
  137. if accessToken, err = r.GetAccessToken(); err != nil {
  138. return nil, err
  139. }
  140. var response []byte
  141. if response, err = util.HTTPGet(fmt.Sprintf(getMomentTaskResultURL, accessToken, jobID)); err != nil {
  142. return nil, err
  143. }
  144. result := &GetMomentTaskResultResponse{}
  145. if err = util.DecodeWithError(response, result, "GetMomentTaskResult"); err != nil {
  146. return nil, err
  147. }
  148. return result, nil
  149. }
  150. // CancelMomentTaskRequest 停止发表企业朋友圈请求
  151. type CancelMomentTaskRequest struct {
  152. MomentID string `json:"moment_id"`
  153. }
  154. // CancelMomentTask 停止发表企业朋友圈
  155. // see https://developer.work.weixin.qq.com/document/path/97612
  156. func (r *Client) CancelMomentTask(req *CancelMomentTaskRequest) error {
  157. var (
  158. accessToken string
  159. err error
  160. )
  161. if accessToken, err = r.GetAccessToken(); err != nil {
  162. return err
  163. }
  164. var response []byte
  165. if response, err = util.PostJSON(fmt.Sprintf(cancelMomentTaskURL, accessToken), req); err != nil {
  166. return err
  167. }
  168. return util.DecodeWithCommonError(response, "CancelMomentTask")
  169. }
  170. // GetMomentListRequest 获取企业全部的发表列表请求
  171. type GetMomentListRequest struct {
  172. StartTime int64 `json:"start_time"`
  173. EndTime int64 `json:"end_time"`
  174. Creator string `json:"creator"`
  175. FilterType int `json:"filter_type"`
  176. Cursor string `json:"cursor"`
  177. Limit int `json:"limit"`
  178. }
  179. // GetMomentListResponse 获取企业全部的发表列表响应
  180. type GetMomentListResponse struct {
  181. util.CommonError
  182. NextCursor string `json:"next_cursor"`
  183. MomentList []MomentItem `json:"moment_list"`
  184. }
  185. // MomentItem 朋友圈
  186. type MomentItem struct {
  187. MomentID string `json:"moment_id"`
  188. Creator string `json:"creator"`
  189. CreateTime int64 `json:"create_time"`
  190. CreateType int `json:"create_type"`
  191. VisibleType int `json:"visible_type"`
  192. Text MomentText `json:"text"`
  193. Image []MomentImage `json:"image"`
  194. Video MomentVideo `json:"video"`
  195. Link MomentLink `json:"link"`
  196. Location MomentLocation `json:"location"`
  197. }
  198. // MomentText 朋友圈文本消息
  199. type MomentText struct {
  200. Content string `json:"content"`
  201. }
  202. // MomentImage 朋友圈图片
  203. type MomentImage struct {
  204. MediaID string `json:"media_id"`
  205. }
  206. // MomentVideo 朋友圈视频
  207. type MomentVideo struct {
  208. MediaID string `json:"media_id"`
  209. ThumbMediaID string `json:"thumb_media_id"`
  210. }
  211. // MomentLink 朋友圈网页链接
  212. type MomentLink struct {
  213. Title string `json:"title"`
  214. URL string `json:"url"`
  215. }
  216. // MomentLocation 朋友圈地理位置
  217. type MomentLocation struct {
  218. Latitude string `json:"latitude"`
  219. Longitude string `json:"longitude"`
  220. Name string `json:"name"`
  221. }
  222. // GetMomentList 获取企业全部的发表列表
  223. // see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E4%BC%81%E4%B8%9A%E5%85%A8%E9%83%A8%E7%9A%84%E5%8F%91%E8%A1%A8%E5%88%97%E8%A1%A8
  224. func (r *Client) GetMomentList(req *GetMomentListRequest) (*GetMomentListResponse, error) {
  225. var (
  226. accessToken string
  227. err error
  228. )
  229. if accessToken, err = r.GetAccessToken(); err != nil {
  230. return nil, err
  231. }
  232. var response []byte
  233. if response, err = util.PostJSON(fmt.Sprintf(getMomentListURL, accessToken), req); err != nil {
  234. return nil, err
  235. }
  236. result := &GetMomentListResponse{}
  237. if err = util.DecodeWithError(response, result, "GetMomentList"); err != nil {
  238. return nil, err
  239. }
  240. return result, nil
  241. }
  242. // GetMomentTaskRequest 获取客户朋友圈企业发表的列表请求
  243. type GetMomentTaskRequest struct {
  244. MomentID string `json:"moment_id"`
  245. Cursor string `json:"cursor"`
  246. Limit int `json:"limit"`
  247. }
  248. // GetMomentTaskResponse 获取客户朋友圈企业发表的列表响应
  249. type GetMomentTaskResponse struct {
  250. util.CommonError
  251. NextCursor string `json:"next_cursor"`
  252. TaskList []MomentTask `json:"task_list"`
  253. }
  254. // MomentTask 发表任务
  255. type MomentTask struct {
  256. UserID string `json:"userid"`
  257. PublishStatus int `json:"publish_status"`
  258. }
  259. // GetMomentTask 获取客户朋友圈企业发表的列表
  260. // see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E6%9C%8B%E5%8F%8B%E5%9C%88%E4%BC%81%E4%B8%9A%E5%8F%91%E8%A1%A8%E7%9A%84%E5%88%97%E8%A1%A8
  261. func (r *Client) GetMomentTask(req *GetMomentTaskRequest) (*GetMomentTaskResponse, error) {
  262. var (
  263. accessToken string
  264. err error
  265. )
  266. if accessToken, err = r.GetAccessToken(); err != nil {
  267. return nil, err
  268. }
  269. var response []byte
  270. if response, err = util.PostJSON(fmt.Sprintf(getMomentTaskURL, accessToken), req); err != nil {
  271. return nil, err
  272. }
  273. result := &GetMomentTaskResponse{}
  274. if err = util.DecodeWithError(response, result, "GetMomentTask"); err != nil {
  275. return nil, err
  276. }
  277. return result, nil
  278. }
  279. // GetMomentCustomerListRequest 获取客户朋友圈发表时选择的可见范围请求
  280. type GetMomentCustomerListRequest struct {
  281. MomentID string `json:"moment_id"`
  282. UserID string `json:"userid"`
  283. Cursor string `json:"cursor"`
  284. Limit int `json:"limit"`
  285. }
  286. // GetMomentCustomerListResponse 获取客户朋友圈发表时选择的可见范围响应
  287. type GetMomentCustomerListResponse struct {
  288. util.CommonError
  289. NextCursor string `json:"next_cursor"`
  290. CustomerList []MomentCustomer `json:"customer_list"`
  291. }
  292. // MomentCustomer 成员可见客户列表
  293. type MomentCustomer struct {
  294. UserID string `json:"userid"`
  295. ExternalUserID string `json:"external_userid"`
  296. }
  297. // GetMomentCustomerList 获取客户朋友圈发表时选择的可见范围
  298. // see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E6%9C%8B%E5%8F%8B%E5%9C%88%E5%8F%91%E8%A1%A8%E6%97%B6%E9%80%89%E6%8B%A9%E7%9A%84%E5%8F%AF%E8%A7%81%E8%8C%83%E5%9B%B4
  299. func (r *Client) GetMomentCustomerList(req *GetMomentCustomerListRequest) (*GetMomentCustomerListResponse, error) {
  300. var (
  301. accessToken string
  302. err error
  303. )
  304. if accessToken, err = r.GetAccessToken(); err != nil {
  305. return nil, err
  306. }
  307. var response []byte
  308. if response, err = util.PostJSON(fmt.Sprintf(getMomentCustomerListURL, accessToken), req); err != nil {
  309. return nil, err
  310. }
  311. result := &GetMomentCustomerListResponse{}
  312. if err = util.DecodeWithError(response, result, "GetMomentCustomerList"); err != nil {
  313. return nil, err
  314. }
  315. return result, nil
  316. }
  317. // GetMomentSendResultRequest 获取客户朋友圈发表后的可见客户列表请求
  318. type GetMomentSendResultRequest struct {
  319. MomentID string `json:"moment_id"`
  320. UserID string `json:"userid"`
  321. Cursor string `json:"cursor"`
  322. Limit int `json:"limit"`
  323. }
  324. // GetMomentSendResultResponse 获取客户朋友圈发表后的可见客户列表响应
  325. type GetMomentSendResultResponse struct {
  326. util.CommonError
  327. NextCursor string `json:"next_cursor"`
  328. CustomerList []MomentSendCustomer `json:"customer_list"`
  329. }
  330. // MomentSendCustomer 成员发送成功客户
  331. type MomentSendCustomer struct {
  332. ExternalUserID string `json:"external_userid"`
  333. }
  334. // GetMomentSendResult 获取客户朋友圈发表后的可见客户列表
  335. // see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E6%9C%8B%E5%8F%8B%E5%9C%88%E5%8F%91%E8%A1%A8%E5%90%8E%E7%9A%84%E5%8F%AF%E8%A7%81%E5%AE%A2%E6%88%B7%E5%88%97%E8%A1%A8
  336. func (r *Client) GetMomentSendResult(req *GetMomentSendResultRequest) (*GetMomentSendResultResponse, error) {
  337. var (
  338. accessToken string
  339. err error
  340. )
  341. if accessToken, err = r.GetAccessToken(); err != nil {
  342. return nil, err
  343. }
  344. var response []byte
  345. if response, err = util.PostJSON(fmt.Sprintf(getMomentSendResultURL, accessToken), req); err != nil {
  346. return nil, err
  347. }
  348. result := &GetMomentSendResultResponse{}
  349. if err = util.DecodeWithError(response, result, "GetMomentSendResult"); err != nil {
  350. return nil, err
  351. }
  352. return result, nil
  353. }
  354. // GetMomentCommentsRequest 获取客户朋友圈的互动数据请求
  355. type GetMomentCommentsRequest struct {
  356. MomentID string `json:"moment_id"`
  357. UserID string `json:"userid"`
  358. }
  359. // GetMomentCommentsResponse 获取客户朋友圈的互动数据响应
  360. type GetMomentCommentsResponse struct {
  361. util.CommonError
  362. CommentList []MomentComment `json:"comment_list"`
  363. LikeList []MomentLike `json:"like_list"`
  364. }
  365. // MomentComment 朋友圈评论
  366. type MomentComment struct {
  367. ExternalUserID string `json:"external_userid,omitempty"`
  368. UserID string `json:"userid,omitempty"`
  369. CreateTime int64 `json:"create_time"`
  370. }
  371. // MomentLike 朋友圈点赞
  372. type MomentLike struct {
  373. ExternalUserID string `json:"external_userid,omitempty"`
  374. UserID string `json:"userid,omitempty"`
  375. CreateTime int64 `json:"create_time"`
  376. }
  377. // GetMomentComments 获取客户朋友圈的互动数据
  378. // see https://developer.work.weixin.qq.com/document/path/93333#%E8%8E%B7%E5%8F%96%E5%AE%A2%E6%88%B7%E6%9C%8B%E5%8F%8B%E5%9C%88%E7%9A%84%E4%BA%92%E5%8A%A8%E6%95%B0%E6%8D%AE
  379. func (r *Client) GetMomentComments(req *GetMomentCommentsRequest) (*GetMomentCommentsResponse, error) {
  380. var (
  381. accessToken string
  382. err error
  383. )
  384. if accessToken, err = r.GetAccessToken(); err != nil {
  385. return nil, err
  386. }
  387. var response []byte
  388. if response, err = util.PostJSON(fmt.Sprintf(getMomentCommentsURL, accessToken), req); err != nil {
  389. return nil, err
  390. }
  391. result := &GetMomentCommentsResponse{}
  392. if err = util.DecodeWithError(response, result, "GetMomentComments"); err != nil {
  393. return nil, err
  394. }
  395. return result, nil
  396. }
  397. // ListMomentStrategyRequest 获取规则组列表请求
  398. type ListMomentStrategyRequest struct {
  399. Cursor string `json:"cursor"`
  400. Limit int `json:"limit"`
  401. }
  402. // ListMomentStrategyResponse 获取规则组列表响应
  403. type ListMomentStrategyResponse struct {
  404. util.CommonError
  405. Strategy []MomentStrategyID `json:"strategy"`
  406. NextCursor string `json:"next_cursor"`
  407. }
  408. // MomentStrategyID 规则组ID
  409. type MomentStrategyID struct {
  410. StrategyID int `json:"strategy_id"`
  411. }
  412. // ListMomentStrategy 获取规则组列表
  413. // see https://developer.work.weixin.qq.com/document/path/94890#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E5%88%97%E8%A1%A8
  414. func (r *Client) ListMomentStrategy(req *ListMomentStrategyRequest) (*ListMomentStrategyResponse, error) {
  415. var (
  416. accessToken string
  417. err error
  418. )
  419. if accessToken, err = r.GetAccessToken(); err != nil {
  420. return nil, err
  421. }
  422. var response []byte
  423. if response, err = util.PostJSON(fmt.Sprintf(listMomentStrategyURL, accessToken), req); err != nil {
  424. return nil, err
  425. }
  426. result := &ListMomentStrategyResponse{}
  427. if err = util.DecodeWithError(response, result, "ListMomentStrategy"); err != nil {
  428. return nil, err
  429. }
  430. return result, nil
  431. }
  432. // GetMomentStrategyRequest 获取规则组详情请求
  433. type GetMomentStrategyRequest struct {
  434. StrategyID int `json:"strategy_id"`
  435. }
  436. // GetMomentStrategyResponse 获取规则组详情响应
  437. type GetMomentStrategyResponse struct {
  438. util.CommonError
  439. Strategy MomentStrategy `json:"strategy"`
  440. }
  441. // MomentStrategy 规则组
  442. type MomentStrategy struct {
  443. StrategyID int `json:"strategy_id"`
  444. ParentID int `json:"parent_id"`
  445. StrategyName string `json:"strategy_name"`
  446. CreateTime int64 `json:"create_time"`
  447. AdminList []string `json:"admin_list"`
  448. Privilege MomentPrivilege `json:"privilege"`
  449. }
  450. // MomentPrivilege 规则组权限
  451. type MomentPrivilege struct {
  452. ViewMomentList bool `json:"view_moment_list"`
  453. SendMoment bool `json:"send_moment"`
  454. ManageMomentCoverAndSign bool `json:"manage_moment_cover_and_sign"`
  455. }
  456. // GetMomentStrategy 获取规则组详情
  457. // see https://developer.work.weixin.qq.com/document/path/94890#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E8%AF%A6%E6%83%85
  458. func (r *Client) GetMomentStrategy(req *GetMomentStrategyRequest) (*GetMomentStrategyResponse, error) {
  459. var (
  460. accessToken string
  461. err error
  462. )
  463. if accessToken, err = r.GetAccessToken(); err != nil {
  464. return nil, err
  465. }
  466. var response []byte
  467. if response, err = util.PostJSON(fmt.Sprintf(getMomentStrategyURL, accessToken), req); err != nil {
  468. return nil, err
  469. }
  470. result := &GetMomentStrategyResponse{}
  471. if err = util.DecodeWithError(response, result, "GetMomentStrategy"); err != nil {
  472. return nil, err
  473. }
  474. return result, nil
  475. }
  476. // GetRangeMomentStrategyRequest 获取规则组管理范围请求
  477. type GetRangeMomentStrategyRequest struct {
  478. StrategyID int `json:"strategy_id"`
  479. Cursor string `json:"cursor"`
  480. Limit int `json:"limit"`
  481. }
  482. // GetRangeMomentStrategyResponse 获取规则组管理范围响应
  483. type GetRangeMomentStrategyResponse struct {
  484. util.CommonError
  485. Range []RangeMomentStrategy `json:"range"`
  486. NextCursor string `json:"next_cursor"`
  487. }
  488. // RangeMomentStrategy 管理范围内配置的成员或部门
  489. type RangeMomentStrategy struct {
  490. Type int `json:"type"`
  491. UserID string `json:"userid,omitempty"`
  492. PartyID int `json:"partyid,omitempty"`
  493. }
  494. // GetRangeMomentStrategy 获取规则组管理范围
  495. // see https://developer.work.weixin.qq.com/document/path/94890#%E8%8E%B7%E5%8F%96%E8%A7%84%E5%88%99%E7%BB%84%E7%AE%A1%E7%90%86%E8%8C%83%E5%9B%B4
  496. func (r *Client) GetRangeMomentStrategy(req *GetRangeMomentStrategyRequest) (*GetRangeMomentStrategyResponse, error) {
  497. var (
  498. accessToken string
  499. err error
  500. )
  501. if accessToken, err = r.GetAccessToken(); err != nil {
  502. return nil, err
  503. }
  504. var response []byte
  505. if response, err = util.PostJSON(fmt.Sprintf(getRangeMomentStrategyURL, accessToken), req); err != nil {
  506. return nil, err
  507. }
  508. result := &GetRangeMomentStrategyResponse{}
  509. if err = util.DecodeWithError(response, result, "GetRangeMomentStrategy"); err != nil {
  510. return nil, err
  511. }
  512. return result, nil
  513. }
  514. // CreateMomentStrategyRequest 创建新的规则组请求
  515. type CreateMomentStrategyRequest struct {
  516. ParentID int `json:"parent_id"`
  517. StrategyName string `json:"strategy_name"`
  518. AdminList []string `json:"admin_list"`
  519. Privilege MomentPrivilege `json:"privilege"`
  520. Range []RangeMomentStrategy `json:"range"`
  521. }
  522. // CreateMomentStrategyResponse 创建新的规则组响应
  523. type CreateMomentStrategyResponse struct {
  524. util.CommonError
  525. StrategyID int `json:"strategy_id"`
  526. }
  527. // CreateMomentStrategy 创建新的规则组
  528. // see https://developer.work.weixin.qq.com/document/path/94890#%E5%88%9B%E5%BB%BA%E6%96%B0%E7%9A%84%E8%A7%84%E5%88%99%E7%BB%84
  529. func (r *Client) CreateMomentStrategy(req *CreateMomentStrategyRequest) (*CreateMomentStrategyResponse, error) {
  530. var (
  531. accessToken string
  532. err error
  533. )
  534. if accessToken, err = r.GetAccessToken(); err != nil {
  535. return nil, err
  536. }
  537. var response []byte
  538. if response, err = util.PostJSON(fmt.Sprintf(createMomentStrategyURL, accessToken), req); err != nil {
  539. return nil, err
  540. }
  541. result := &CreateMomentStrategyResponse{}
  542. if err = util.DecodeWithError(response, result, "CreateMomentStrategy"); err != nil {
  543. return nil, err
  544. }
  545. return result, nil
  546. }
  547. // EditMomentStrategyRequest 编辑规则组及其管理范围请求
  548. type EditMomentStrategyRequest struct {
  549. StrategyID int `json:"strategy_id"`
  550. StrategyName string `json:"strategy_name"`
  551. AdminList []string `json:"admin_list"`
  552. Privilege MomentPrivilege `json:"privilege"`
  553. RangeAdd []RangeMomentStrategy `json:"range_add"`
  554. RangeDel []RangeMomentStrategy `json:"range_del"`
  555. }
  556. // EditMomentStrategy 编辑规则组及其管理范围
  557. // see https://developer.work.weixin.qq.com/document/path/94890#%E7%BC%96%E8%BE%91%E8%A7%84%E5%88%99%E7%BB%84%E5%8F%8A%E5%85%B6%E7%AE%A1%E7%90%86%E8%8C%83%E5%9B%B4
  558. func (r *Client) EditMomentStrategy(req *EditMomentStrategyRequest) error {
  559. var (
  560. accessToken string
  561. err error
  562. )
  563. if accessToken, err = r.GetAccessToken(); err != nil {
  564. return err
  565. }
  566. var response []byte
  567. if response, err = util.PostJSON(fmt.Sprintf(editMomentStrategyURL, accessToken), req); err != nil {
  568. return err
  569. }
  570. return util.DecodeWithCommonError(response, "EditMomentStrategy")
  571. }
  572. // DelMomentStrategyRequest 删除规则组请求
  573. type DelMomentStrategyRequest struct {
  574. StrategyID int `json:"strategy_id"`
  575. }
  576. // DelMomentStrategy 删除规则组
  577. // see https://developer.work.weixin.qq.com/document/path/94890#%E5%88%A0%E9%99%A4%E8%A7%84%E5%88%99%E7%BB%84
  578. func (r *Client) DelMomentStrategy(req *DelMomentStrategyRequest) error {
  579. var (
  580. accessToken string
  581. err error
  582. )
  583. if accessToken, err = r.GetAccessToken(); err != nil {
  584. return err
  585. }
  586. var response []byte
  587. if response, err = util.PostJSON(fmt.Sprintf(delMomentStrategyURL, accessToken), req); err != nil {
  588. return err
  589. }
  590. return util.DecodeWithCommonError(response, "DelMomentStrategy")
  591. }