素材管理

新增临时素材

详细请参考 http://mp.weixin.qq.com/wiki/15/2d353966323806a202cd2deaafe8e557.html

Client.upload_media(media_type, media_file)

上传临时多媒体文件。

  • 参数

    • media_type – 媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb）

    • media_file – 要上传的文件，一个 File-object

    返回

    返回的 JSON 数据包

获取临时素材

详细请参考 http://mp.weixin.qq.com/wiki/9/677a85e3f3849af35de54bb5516c2521.html

Client.download_media(media_id)

下载临时多媒体文件。

  • 参数

    media_id – 媒体文件 ID

    返回

    requests 的 Response 实例

新增永久素材

详细请参考 http://mp.weixin.qq.com/wiki/10/10ea5a44870f53d79449290dfd43d006.html

Client.add_news(articles)

新增永久图文素材:

  1. articles = [{
  2.    "title": TITLE,
  3.    "thumb_media_id": THUMB_MEDIA_ID,
  4.    "author": AUTHOR,
  5.    "digest": DIGEST,
  6.    "show_cover_pic": SHOW_COVER_PIC(0 / 1),
  7.    "content": CONTENT,
  8.    "content_source_url": CONTENT_SOURCE_URL
  9. }
  10. # 若新增的是多图文素材，则此处应有几段articles结构，最多8段
  11. ]
  12. client.add_news(articles)

  • 参数

    articles – 如示例中的数组

    返回

    返回的 JSON 数据包

Client.upload_news_picture(file)

上传图文消息内的图片。

  • 参数

    file – 要上传的文件，一个 File-object

    返回

    返回的 JSON 数据包

Client.upload_permanent_media(media_type, media_file)

上传其他类型永久素材。

  • 参数

    • media_type – 媒体文件类型，分别有图片（image）、语音（voice）和缩略图（thumb）

    • media_file – 要上传的文件，一个 File-object

    返回

    返回的 JSON 数据包

Client.upload_permanent_video(title, introduction, video)

上传永久视频。

  • 参数

    • title – 视频素材的标题

    • introduction – 视频素材的描述

    • video – 要上传的视频，一个 File-object

    返回

    requests 的 Response 实例

获取永久素材

详细请参考 http://mp.weixin.qq.com/wiki/12/3c12fac7c14cb4d0e0d4fe2fbc87b638.html

Client.download_permanent_media(media_id)

获取永久素材。

  • 参数

    media_id – 媒体文件 ID

    返回

    requests 的 Response 实例

删除永久素材

详细请参考 http://mp.weixin.qq.com/wiki/7/2212203f4e17253b9aef77dc788f5337.html

Client.delete_permanent_media(media_id)

删除永久素材。

  • 参数

    media_id – 媒体文件 ID

    返回

    返回的 JSON 数据包

上传图文消息素材

Client.upload_news(articles)

上传图文消息素材

  1. articles = [{
  2.     "thumb_media_id":"qI6_Ze_6PtV7svjolgs-rN6stStuHIjs9_DidOHaj0Q-mwvBelOXCFZiq2OsIU-p",
  3.     "author":"xxx",
  4.     "title":"Happy Day",
  5.     "content_source_url":"www.qq.com",
  6.     "content":"content",
  7.     "digest":"digest",
  8.     "show_cover_pic":1,
  9.     "need_open_comment":1,
  10.     "only_fans_can_comment":1
  11. }]

具体请参考: https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Batch_Sends_and_Originality_Checks.html#1

  • 参数

    articles – 上传的图文消息数据。

    返回

    返回的 JSON 数据包。

修改永久图文素材

详细请参考 http://mp.weixin.qq.com/wiki/10/c7bad9a463db20ff8ccefeedeef51f9e.html

Client.update_news(update_data)

修改永久图文素材:

  1. update_data = {
  2.     "media_id":MEDIA_ID,
  3.     "index":INDEX,
  4.     "articles": {
  5.         "title": TITLE,
  6.         "thumb_media_id": THUMB_MEDIA_ID,
  7.         "author": AUTHOR,
  8.         "digest": DIGEST,
  9.         "show_cover_pic": SHOW_COVER_PIC(0 / 1),
  10.         "content": CONTENT,
  11.         "content_source_url": CONTENT_SOURCE_URL
  12.     }
  13. }
  14. client.update_news(update_data)

  • 参数

    update_data – 更新的数据，要包含 media_id（图文素材的 ID），index（要更新的文章在图文消息中的位置），articles（新的图文素材数据）

    返回

    返回的 JSON 数据包

获取素材总数

详细请参考 http://mp.weixin.qq.com/wiki/5/a641fd7b5db7a6a946ebebe2ac166885.html

Client.get_media_count()

获取素材总数。

  • 返回

    返回的 JSON 数据包

获取素材列表

详细请参考 http://mp.weixin.qq.com/wiki/15/8386c11b7bc4cdd1499c572bfe2e95b3.html

Client.get_media_list(media_type, offset, count)

获取素材列表。

  • 参数

    • media_type – 素材的类型，图片（image）、视频（video）、语音 （voice）、图文（news）

    • offset – 从全部素材的该偏移位置开始返回，0表示从第一个素材返回

    • count – 返回素材的数量，取值在1到20之间

    返回

    返回的 JSON 数据包