说明
以下接口中提供回调的接口均为异步执行。
绑定标签
绑定标签到指定目标。
重要
支持向设备、账号和别名绑定标签,绑定类型由参数target指定。
App最多支持定义1万个标签,单个标签支持的最大长度为129字符。
绑定标签在10分钟内生效。
不建议在单个标签上绑定超过十万级设备,否则,发起对该标签的推送可能需要较长的处理时间,无法保障响应速度。此种情况下,建议您采用全推方式,或将设备集合拆分到更细粒度的标签,多次调用推送接口分别推送给这些标签来避免此问题。
接口定义
+ (void)bindTag:(int)target
withTags:(NSArray *)tags
withAlias:(NSString *)alias
withCallback:(CallbackHandler)callback;
参数说明
参数 | 类型 | 是否必须 | 说明 |
target | int | 是 | 目标类型可选值:
|
tags | NSArray | 是 | 标签(数组输入) |
alias | NSString | 否 | 别名,仅当target=3时生效 |
callback | Block | 否 | 回调 |
解绑标签
解绑指定目标的标签。
重要
支持解绑设备、账号和别名的标签,解绑类型有参数target指定。
解绑标签只是解除设备和标签的绑定关系,不等同于删除标签,即该App下标签依然存在,系统当前不支持删除标签。
解绑标签在10分钟内生效。
接口定义
+ (void)unbindTag:(int)target
withTags:(NSArray *)tags
withAlias:(NSString *)alias
withCallback:(CallbackHandler)callback;
参数说明
参数 | 类型 | 是否必须 | 说明 |
target | int | 是 | 目标类型可选值:
|
tags | NSArray | 是 | 标签(数组输入) |
alias | NSString | 否 | 别名,仅当target=3时生效 |
callback | Block | 否 | 回调 |
查询标签
查询目标绑定的标签,当前仅支持查询设备标签。
重要
查询结果可从回调的data中获取。
接口定义
+ (void)listTags:(int)target
withCallback:(CallbackHandler)callback;
参数说明
参数 | 类型 | 是否必须 | 说明 |
target | int | 是 | 目标类型可选值:
|
callback | Block | 否 | 回调 |
文档内容是否对您有帮助?