标签(tag)有哪些相关接口-移动研发平台(EMAS)-阿里云帮助中心

绑定标签

为设备添加标签，可以实现按标签的定向消息推送。

重要

App最多支持定义1万个标签，单个标签支持的最大长度为128字符。
绑定标签在10分钟内生效。
不建议在单个标签上绑定超过十万级设备，否则，发起对该标签的推送可能需要较长的处理时间，无法保障响应速度。此种情况下，建议您采用全推方式，或将设备集合拆分到更细粒度的标签，多次调用推送接口分别推送给这些标签来避免此问题。

`bindTag`

接口定义

void bindTag(int target, String[] tags, String alias, CommonCallback callback)

所属类

CloudPushService

参数说明

参数	类型	是否必须	说明
target	int	是	目标类型，固定传 1 或CloudPushService.DEVICE_TARGET。
tags	String[]	是	标签（数组输入）
alias	String	否	保留参数，传 null
callback	CommonCallback	是	回调

代码示例

Kotlin

PushServiceFactory.getCloudPushService()
    .bindTag(CloudPushService.DEVICE_TARGET, arrayOf(tag), null, object : CommonCallback {
        override fun onSuccess(s: String) {}
        override fun onFailed(errorCode: String, errorMsg: String) {}
    })

Java

PushServiceFactory.getCloudPushService().bindTag(CloudPushService.DEVICE_TARGET, new String[]{tag}, null, new CommonCallback() {
    @Override
    public void onSuccess(String s) {

    }

    @Override
    public void onFailed(String errorCode, String errorMsg) {

    }
});

解绑标签

解绑设备上的标签。

重要

解绑标签只是解除设备和标签的绑定关系，不等同于删除标签，即该App下标签依然存在，系统当前不支持删除标签。
解绑标签在10分钟内生效。

`unbindTag`

接口定义

void unbindTag(int target, String[] tags, String alias, CommonCallback callback)

所属类

CloudPushService

参数说明

参数	类型	是否必须	说明
target	int	是	目标类型，固定传 1 或CloudPushService.DEVICE_TARGET。
tags	String[]	是	标签（数组输入）
alias	String	否	保留参数，传 null
callback	CommonCallback	是	回调

代码示例

Kotlin

PushServiceFactory.getCloudPushService()
    .unbindTag(CloudPushService.DEVICE_TARGET, arrayOf(tag), null, object : CommonCallback {
        override fun onSuccess(s: String) {}
        override fun onFailed(errorCode: String, errorMsg: String) {}
    })

Java

PushServiceFactory.getCloudPushService().unbindTag(CloudPushService.DEVICE_TARGET, new String[]{tag}, null, new CommonCallback() {
    @Override
    public void onSuccess(String s) {

    }

    @Override
    public void onFailed(String errorCode, String errorMsg) {

    }
});

查询标签

查询设备绑定的标签。

`listTags`

接口定义

void listTags(int target, CommonCallback callback)

所属类

CloudPushService

参数说明

参数	类型	是否必须	说明
target	int	是	目标类型，固定传 1 或CloudPushService.DEVICE_TARGET。
callback	CommonCallback	是	回调。查询结果可从回调onSuccess(response)的response中获取。

代码示例

Kotlin

PushServiceFactory.getCloudPushService()
    .listTags(CloudPushService.DEVICE_TARGET, arrayOf(tag), null, object : CommonCallback {
        override fun onSuccess(s: String) {}
        override fun onFailed(errorCode: String, errorMsg: String) {}
    })

Java

PushServiceFactory.getCloudPushService().listTags(CloudPushService.DEVICE_TARGET, new String[]{tag}, null, new CommonCallback() {
    @Override
    public void onSuccess(String s) {

    }

    @Override
    public void onFailed(String errorCode, String errorMsg) {

    }
});