umeng-go

友盟 相关接口的封装

About 友盟推送 U-Push

友盟推送接口 封装。其中部分接口需要U-Push Pro版本的支持。

• 友盟推送：消息的推送、任务查询、撤销推送、文件上传
• 标签接口：标签的查询、新增、重设、删除、清除
• 模板消息：模板的查询、新增、删除以及发送模板消息和获取消息id
• 安卓厂商数据透出和额度查询

消息类型包括：单播(unicast)、列播(listcast)、广播(broadcast)、组播(groupcast)、文件播(filecast)、自定义播(customizedcast) 。其中自定义播又可以分为自定义file播和自定义alias播。 这7种类型整体可以分为两大类别：单播类消息和任务类消息。

unicast、listcast、customizedcast(alias)统称为单播类消息，Web后台不会展示此类消息详细信息，仅展示前一天的汇总数据。单播类消息推送响应体中返回msg_id。

broadcast、filecast、groupcast、customizedcast(file_id)统称为任务类消息，任务类消息支持API查询、撤销操作，Web后台会展示任务类消息详细信息。任务类消息推送响应体中返回task_id。

消息类别	消息类型	用户范围	msg_id	task_id	API支持
单播类	单播	独立用户	uu******
单播类	列播	独立用户	ul******
单播类	自定义alias播	特定用户	ua******
任务类	广播	全部用户		um******
任务类	组播	部分用户		us******
任务类	文件播	部分用户		uf******	只支持API
任务类	自定义文件播	特定用户		uc******	只支持API

Quickstart

package main

import (
	"fmt"
	"github.com/yzchan/umeng-go/v2/push"
)

func main() {
	u := push.NewUmeng()
	u.InitAndroid("*****", "*****")
	u.InitIOS("*****", "*****")
	u.Debug(true) // 开启调试模式会输出http请求和响应内容

	// 查询推送任务结果
	fmt.Println(u.Android.Status("us*****"))

	// 撤销推送
	fmt.Println(u.GetClient(push.IOS).Cancel("um*****"))

	// 新建一条android单播推送请求
	request := push.NewAndroidUnicastRequest()
	request.SetDescription("unicast-test")
	request.Payload.Body.SetTitle("<your title>").SetText("<your text>")
	request.Payload.Extra.AddKV("extra1", "1").AddKV("extra2", "2")
	request.SetDeviceToken("<device-token>")

	// 发送单播请求
	result, err := u.Send(request)
	if err != nil {
		panic(err)
	}
	fmt.Println(result)
}