標簽（tag）相關(guān)接口
綁定標簽
為設(shè)備添加標簽，可以實現(xiàn)按標簽的定向消息推送。
支持向設(shè)備、賬號和別名綁定標簽，綁定類型由參數(shù)target指定。
App最多支持定義1萬個標簽，單個標簽支持的最大長度為129字符。
綁定標簽在10分鐘內(nèi)生效。
不建議在單個標簽上綁定超過十萬級設(shè)備，否則，發(fā)起對該標簽的推送可能需要較長的處理時間，無法保障響應(yīng)速度。此種情況下，建議您采用全推方式，或?qū)⒃O(shè)備集合拆分到更細粒度的標簽，多次調(diào)用推送接口分別推送給這些標簽來避免此問題。
bindTag
接口定義
void bindTag(int target, String[] tags, String alias, CommonCallback callback)
所屬類
CloudPushService
參數(shù)說明
參數(shù) | 類型 | 是否必須 | 說明 |
target | int | 是 | 目標類型可選值：
目標類型可選值（SDK版本V2.3.5及以上版本）：
|
tags | String[] | 是 | 標簽（數(shù)組輸入） |
alias | String | 否 | 別名，僅當target=3時生效 |
callback | CommonCallback | 是 | 回調(diào) |
代碼示例
PushServiceFactory.getCloudPushService()
.bindTag(CloudPushService.DEVICE_TARGET, arrayOf(tag), null, object : CommonCallback {
override fun onSuccess(s: String) {}
override fun onFailed(errorCode: String, errorMsg: String) {}
})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) {
}
});解綁標簽
解綁指定目標的標簽。
支持解綁設(shè)備、賬號和別名的標簽，解綁類型有參數(shù)target指定。
解綁標簽只是解除設(shè)備和標簽的綁定關(guān)系，不等同于刪除標簽，即該App下標簽依然存在，系統(tǒng)當前不支持刪除標簽。
解綁標簽在10分鐘內(nèi)生效。
unbindTag
接口定義
void unbindTag(int target, String[] tags, String alias, CommonCallback callback)
所屬類
CloudPushService
參數(shù)說明
參數(shù) | 類型 | 是否必須 | 說明 |
target | int | 是 | 目標類型可選值：
目標類型可選值（SDK版本V2.3.5及以上版本）：
|
tags | String[] | 是 | 標簽（數(shù)組輸入） |
alias | String | 否 | 別名，僅當target=3時生效 |
callback | CommonCallback | 是 | 回調(diào) |
代碼示例
PushServiceFactory.getCloudPushService()
.unbindTag(CloudPushService.DEVICE_TARGET, arrayOf(tag), null, object : CommonCallback {
override fun onSuccess(s: String) {}
override fun onFailed(errorCode: String, errorMsg: String) {}
})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) {
}
});查詢標簽
查詢目標綁定的標簽，當前僅支持查詢設(shè)備標簽。
listTags
接口定義
void listTags(int target, CommonCallback callback)
所屬類
CloudPushService
參數(shù)說明
參數(shù) | 類型 | 是否必須 | 說明 |
target | int | 是 | 目標類型可選值：
目標類型可選值（SDK版本V2.3.5及以上版本）：
|
callback | CommonCallback | 是 | 回調(diào)。查詢結(jié)果可從回調(diào)onSuccess(response)的response中獲取。 |
代碼示例
PushServiceFactory.getCloudPushService()
.listTags(CloudPushService.DEVICE_TARGET, arrayOf(tag), null, object : CommonCallback {
override fun onSuccess(s: String) {}
override fun onFailed(errorCode: String, errorMsg: String) {}
})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) {
}
});