material

Documentation

Overview

Package material 素材管理

Index

• func AddMaterial(ctx *offiaccount.OffiAccount, media string, params url.Values, ...) (resp []byte, err error)
• func AddNews(ctx *offiaccount.OffiAccount, payload []byte) (resp []byte, err error)
• func BatchgetMaterial(ctx *offiaccount.OffiAccount, payload []byte) (resp []byte, err error)
• func DelMaterial(ctx *offiaccount.OffiAccount, payload []byte) (resp []byte, err error)
• func GetMaterial(ctx *offiaccount.OffiAccount, payload []byte) (resp []byte, err error)
• func GetMaterialCount(ctx *offiaccount.OffiAccount) (resp []byte, err error)
• func MediaGet(ctx *offiaccount.OffiAccount) (resp []byte, err error)
• func MediaGetJssdk(ctx *offiaccount.OffiAccount, params url.Values) (resp []byte, err error)
• func MediaUpload(ctx *offiaccount.OffiAccount, media string, params url.Values) (resp []byte, err error)
• func MediaUploadImg(ctx *offiaccount.OffiAccount, media string) (resp []byte, err error)
• func UpdateNews(ctx *offiaccount.OffiAccount, payload []byte) (resp []byte, err error)

Examples

• AddMaterial
• AddNews
• BatchgetMaterial
• DelMaterial
• GetMaterial
• GetMaterialCount
• MediaGet
• MediaGetJssdk
• MediaUpload
• MediaUploadImg
• UpdateNews

Functions

func AddMaterial

func AddMaterial(ctx *offiaccount.OffiAccount, media string, params url.Values, fields map[string]string) (resp []byte, err error)

新增其他类型永久素材

通过POST表单来调用接口，表单id为media，包含需要上传的素材内容，有filename、filelength、content-type等信息。请注意：图片素材将进入公众平台官网素材管理模块中的默认分组

See: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/Adding_Permanent_Assets.html

POST https://api.weixin.qq.com/cgi-bin/material/add_material?access_token=ACCESS_TOKEN&type=TYPE

Example

package main

import (
	"fmt"
	"net/url"

	"github.com/fastwego/offiaccount"
	"github.com/fastwego/offiaccount/apis/material"
)

func main() {
	var ctx *offiaccount.OffiAccount

	params := url.Values{}
	params.Add("type", "video")

	fields := map[string]string{
		"description": `{"title":"title","introduction":"introduction"}`,
	}

	resp, err := material.AddMaterial(ctx, "/path/to/video.mp4", params, fields)

	fmt.Println(resp, err)
}

func AddNews

func AddNews(ctx *offiaccount.OffiAccount, payload []byte) (resp []byte, err error)

新增永久图文素材

对于常用的素材，开发者可通过本接口上传到微信服务器，永久使用。新增的永久素材也可以在公众平台官网素材管理模块中查询管理

See: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/Adding_Permanent_Assets.html

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

Example

package main

import (
	"fmt"

	"github.com/fastwego/offiaccount"
	"github.com/fastwego/offiaccount/apis/material"
)

func main() {
	var ctx *offiaccount.OffiAccount

	payload := []byte("{}")
	resp, err := material.AddNews(ctx, payload)

	fmt.Println(resp, err)
}

func BatchgetMaterial

func BatchgetMaterial(ctx *offiaccount.OffiAccount, payload []byte) (resp []byte, err error)

获取素材列表

在新增了永久素材后，开发者可以分类型获取永久素材的列表

See: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/Get_materials_list.html

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

Example

package main

import (
	"fmt"

	"github.com/fastwego/offiaccount"
	"github.com/fastwego/offiaccount/apis/material"
)

func main() {
	var ctx *offiaccount.OffiAccount

	payload := []byte("{}")
	resp, err := material.BatchgetMaterial(ctx, payload)

	fmt.Println(resp, err)
}

func DelMaterial

func DelMaterial(ctx *offiaccount.OffiAccount, payload []byte) (resp []byte, err error)

删除永久素材

在新增了永久素材后，开发者可以根据本接口来删除不再需要的永久素材，节省空间

See: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/Deleting_Permanent_Assets.html

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

Example

package main

import (
	"fmt"

	"github.com/fastwego/offiaccount"
	"github.com/fastwego/offiaccount/apis/material"
)

func main() {
	var ctx *offiaccount.OffiAccount

	payload := []byte("{}")
	resp, err := material.DelMaterial(ctx, payload)

	fmt.Println(resp, err)
}

func GetMaterial

func GetMaterial(ctx *offiaccount.OffiAccount, payload []byte) (resp []byte, err error)

获取永久素材

在新增了永久素材后，开发者可以根据media_id通过本接口下载永久素材。公众号在公众平台官网素材管理模块中新建的永久素材，可通过"获取素材列表"获知素材的media_id。请注意：临时素材无法通过本接口获取

See: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/Getting_Permanent_Assets.html

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

Example

package main

import (
	"fmt"

	"github.com/fastwego/offiaccount"
	"github.com/fastwego/offiaccount/apis/material"
)

func main() {
	var ctx *offiaccount.OffiAccount

	payload := []byte("{}")
	resp, err := material.GetMaterial(ctx, payload)

	fmt.Println(resp, err)
}

func GetMaterialCount

func GetMaterialCount(ctx *offiaccount.OffiAccount) (resp []byte, err error)

获取素材总数

1.永久素材的总数，也会计算公众平台官网素材管理中的素材 2.图片和图文消息素材（包括单图文和多图文）的总数上限为5000，其他素材的总数上限为1000

See: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/Get_the_total_of_all_materials.html

GET https://api.weixin.qq.com/cgi-bin/material/get_materialcount?access_token=ACCESS_TOKEN

Example

package main

import (
	"fmt"

	"github.com/fastwego/offiaccount"
	"github.com/fastwego/offiaccount/apis/material"
)

func main() {
	var ctx *offiaccount.OffiAccount

	resp, err := material.GetMaterialCount(ctx)

	fmt.Println(resp, err)
}

func MediaGet

func MediaGet(ctx *offiaccount.OffiAccount) (resp []byte, err error)

获取临时素材

公众号可以使用本接口获取临时素材（即下载临时的多媒体文件）

See: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/Get_temporary_materials.html

GET https://api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID

Example

package main

import (
	"fmt"

	"github.com/fastwego/offiaccount"
	"github.com/fastwego/offiaccount/apis/material"
)

func main() {
	var ctx *offiaccount.OffiAccount

	resp, err := material.MediaGet(ctx)

	fmt.Println(resp, err)
}

func MediaGetJssdk

func MediaGetJssdk(ctx *offiaccount.OffiAccount, params url.Values) (resp []byte, err error)

高清语音素材获取接口

公众号可以使用本接口获取从JSSDK的uploadVoice接口上传的临时语音素材，格式为speex，16K采样率。该音频比上文的临时素材获取接口（格式为amr，8K采样率）更加清晰，适合用作语音识别等对音质要求较高的业务

See: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/Get_temporary_materials.html

GET https://api.weixin.qq.com/cgi-bin/media/get/jssdk?access_token=ACCESS_TOKEN&media_id=MEDIA_ID

Example

package main

import (
	"fmt"
	"net/url"

	"github.com/fastwego/offiaccount"
	"github.com/fastwego/offiaccount/apis/material"
)

func main() {
	var ctx *offiaccount.OffiAccount

	params := url.Values{}
	resp, err := material.MediaGetJssdk(ctx, params)

	fmt.Println(resp, err)
}

func MediaUpload

func MediaUpload(ctx *offiaccount.OffiAccount, media string, params url.Values) (resp []byte, err error)

新增临时素材

公众号经常有需要用到一些临时性的多媒体素材的场景，例如在使用接口特别是发送消息时，对多媒体文件、多媒体消息的获取和调用等操作，是通过media_id来进行的。素材管理接口对所有认证的订阅号和服务号开放。通过本接口，公众号可以新增临时素材（即上传临时多媒体文件）

See: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/New_temporary_materials.html

POST(@media) https://api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

Example

package main

import (
	"fmt"
	"net/url"

	"github.com/fastwego/offiaccount"
	"github.com/fastwego/offiaccount/apis/material"
)

func main() {
	var ctx *offiaccount.OffiAccount

	params := url.Values{}
	params.Add("type", "image")

	media := "/path/to/img.jpg"
	resp, err := material.MediaUpload(ctx, media, params)

	fmt.Println(resp, err)
}

func MediaUploadImg

func MediaUploadImg(ctx *offiaccount.OffiAccount, media string) (resp []byte, err error)

上传图文消息内的图片获取URL

本接口所上传的图片不占用公众号的素材库中图片数量的100000个的限制。图片仅支持jpg/png格式，大小必须在1MB以下

See: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/Adding_Permanent_Assets.html

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

Example

package main

import (
	"fmt"

	"github.com/fastwego/offiaccount"
	"github.com/fastwego/offiaccount/apis/material"
)

func main() {
	var ctx *offiaccount.OffiAccount

	media := "/path/to/image.jpg"
	resp, err := material.MediaUploadImg(ctx, media)

	fmt.Println(resp, err)
}

func UpdateNews

func UpdateNews(ctx *offiaccount.OffiAccount, payload []byte) (resp []byte, err error)

修改永久图文素材

开发者可以通过本接口对永久图文素材进行修改

See: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/Editing_Permanent_Rich_Media_Assets.html

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

Example

package main

import (
	"fmt"

	"github.com/fastwego/offiaccount"
	"github.com/fastwego/offiaccount/apis/material"
)

func main() {
	var ctx *offiaccount.OffiAccount

	payload := []byte("{}")
	resp, err := material.UpdateNews(ctx, payload)

	fmt.Println(resp, err)
}