diff --git a/docs/uniCloud/uni-cloud-push/api.md b/docs/uniCloud/uni-cloud-push/api.md
index 34d76eb8b1c39faa53a9441fb8fe7457667c70c3..437d7071055ec4a8fd70e87ef049423b8a638d42 100644
--- a/docs/uniCloud/uni-cloud-push/api.md
+++ b/docs/uniCloud/uni-cloud-push/api.md
@@ -5,7 +5,9 @@
## 客户端API
### getPushClientId(OBJECT)
-获取客户端唯一的推送标识,注意这是一个异步的方法
+获取客户端唯一的推送标识
+
+注意:这是一个异步的方法,且仅支持uni-push2.0
**OBJECT 参数说明**
@@ -79,39 +81,39 @@ uni.offPushMessage(eventName);
发送push可以基于如下维度选择目标设备:
- 不指定,所有启动过应用的设备
- user_id,指定的用户id,基于uni-id账户体系
-- user_tag,指定标签的用户,基于uni-id账户体系
-- device_id,指定的设备id,基于opendb表的device设备(未开通uni统计的应用,必须登录后才可使用)
-- push_clientid,个推客户端id。其实也会存在opendb表中。
-- getui_custom_tag,个推自定义客户端标签。由用户自定义
-- getui_big_data_tag,个推大数据标签。使用此功能,需开通个推·用户画像产品,请联系个推商务咨询
-- getui_alias,个推自定义客户端别名。使用此功能,需开通个推·用户画像产品,请联系个推商务咨询
+- user_tag,指定用户标签,基于uni-id账户体系
+- device_id,指定的设备id,基于opendb表的device设备(未开通uni统计的应用,必须基于uni-id-co登录后才可使用)
+- push_clientid,个推客户端id(也会存在opendb表中)。
+- getui_custom_tag,由用户自定义的个推客户端标签。该功能需要申请相关套餐,请点击右侧“技术咨询”了解详情
+- getui_big_data_tag,个推大数据标签。该功能需要申请相关套餐,请点击右侧“技术咨询”了解详情
+- getui_alias,个推自定义客户端别名。该功能需要申请相关套餐,请点击右侧“技术咨询”了解详情
**注意**:`user_id`、`user_tag`、`device_id`、`push_clientid`、`getui_custom_tag`、`getui_big_data_tag`、`getui_alias`不可多选。全为空表示向所有启动过应用的设备推送。
#### 接口形式
-可以向设定的(单个、群组、全体)用户,即时或定时推送消息。支持设置:通知栏消息内容、控制响铃,震动,浮动,闪灯;手机桌面应用右上角的角标等。
+可以向设定的(单个、群组、全体)设备,即时或定时推送消息。支持设置:通知栏消息内容、控制响铃,震动,浮动,闪灯;手机桌面应用右上角的角标等。
```js
await uniPush.sendMessage(OBJECT)
```
#### sendMessage参数说明
|名称|类型|必填|默认值|描述|平台特性|
|--|--|--|--|--|--|
-|user_id|String、Array|否|无|基于uni-id的_id,指定消息接收者。支持多个以数组的形式列举,长度不超过100。| |
-|user_tag|String、Array|否|无|指定标签的用户,基于uni-id账户体系| |
-|device_id|String、Array|否|无|指定的设备id,基于opendb表的device设备(未开通uni统计的应用,必须基于uni-id-co登录后才可使用)| |
-|push_clientid|String、Array|否|无|基于uni.getPushCid获取的客户端推送标识,指定消息接收者。支持多个以数组的形式指定多个设备,如["cid-1","cid-2"],数组长度不大于1000| |
-|getui_custom_tag|String|否|无|基于个推`getui_custom_tag`,指定消息接收者;注:该功能需要申请相关套餐,请点击右侧“技术咨询”了解详情 。| |
-|getui_big_data_tag|Object Array|否|无|对指定应用的符合筛选条件的用户群发推送消息。支持定时、定速功能。详见下方getui_big_data_tag说明| |
-|getui_alias|String、Array|否|无|基于用户别名,指定消息接收者。支持多个以数组的形式指定多个设备,如["getui_alias-1","getui_alias-2"],数组长度不大于1000| |
-|platform|String、Array|否|"ALL"|指定接收消息的平台,"ALL"表示所有平台。支持用数组枚举支持的平台,如:["app-ios","app-android","web","mp_weixin"]使用`push_clientid`和`getui_custom_tag`时无效|
-|check_token|Boolean|否|true|校验客户端登陆状态是否有效(含token过期)仅用user_id指定消息接收者时有效| |
+|user_id|String、Array|否|无|基于uni-id的_id,指定接收消息的用户id。支持多个以数组的形式指定多个用户id,如["user_id-1","user_id-2"],数组长度不大于500| |
+|user_tag|String、Array|否|无|指定接收消息的用户标签,基于uni-id账户体系。支持多个以数组的形式指定多个标签,如["user_tag-1","user_tag-2"],数组长度不大于500| |
+|device_id|String、Array|否|无|指定接收消息的设备id,基于opendb表的device设备(未开通uni统计的应用,必须基于uni-id-co登录后才可使用)| |
+|push_clientid|String、Array|否|无|基于[uni.getPushClientId](#getPushClientId)获取的客户端推送标识,指定接收消息的设备。支持多个以数组的形式指定多个设备,如["cid-1","cid-2"],数组长度不大于1000| |
+|getui_custom_tag|String|否|无|基于个推`getui_custom_tag`,指定接收消息接设备;注:该功能需要申请相关套餐,请点击右侧“技术咨询”了解详情 。| |
+|getui_big_data_tag|Object Array|否|无|对指定应用的符合筛选条件的设备群发推送消息。支持定时、定速功能。详见下方[getui-big-data-tag 说明](#getui_big_data_tag 说明)| |
+|getui_alias|String、Array|否|无|个推自定义客户端别名,指定消息接收者。支持多个以数组的形式指定多个设备,如["getui_alias-1","getui_alias-2"],数组长度不大于1000| |
+|platform|String、Array|否|"ALL"|指定接收消息的平台,"ALL"表示所有平台。支持用数组枚举支持的平台,如:["web","app-ios","app-android","mp-weixin"],详情见下方[platform 说明](#platform 说明)仅通过`user_id`、`user_tag`指定消息接收者时有效|
+|check_token|Boolean|否|true|校验客户端登陆状态是否有效(含token过期)仅通过`user_id`、`user_tag`指定消息接收者时有效| |
|title|String|是|无|通知栏标题,长度小于20|APP|
|content|String|是|无|通知栏内容,长度小于50|APP|
|payload|String、Objcet|是|无|推送透传数据,app程序接受的数据,长度小于800| |
|badge|Number、String|否|无|设置应用右上角数字,用于提醒用户未阅读消息数量,支持在原有数字上的+、-操作;例如:badge=+1,表示当前角标+1;badge=-1,(仅iOS支持)表示当前角标-1(角标>=0);badge=1,(仅iOS和华为EMUI版本10.0.0+支持)表示当前角标置成1。| ios、android-华为|
|channel|Object|否|无|消息渠道设置,避免被限量推送、静默推送(静音且需下拉系统通知栏才可见通知内容),需要在各家发邮件申请,详情下方[channel说明](#channel)| android|
|request_id|String|否|无|请求唯一标识号,10-32位之间;如果`request_id`重复,会导致消息丢失||
-|group_name|String|否|无|任务组名。多个消息任务可以用同一个任务组名,后续可根据任务组名查询推送情况(长度限制100字符,且不能含有特殊符号);仅基于user_id、cid、tag指定消息接收者,或对应用的所有用户群发推送消息时有效。||
+|group_name|String|否|无|任务组名。多个消息任务可以用同一个任务组名,后续可根据任务组名查询推送情况(长度限制100字符,且不能含有特殊符号);仅基于user_id、push_clientid、getui_custom_tag指定消息接收者,或对应用的所有用户群发推送消息时有效。||
|sound|String|否|无|消息提醒铃声设置。android需要设置channel生效,详见下方[铃声设置注意](#sound)如果铃声文件未找到,响铃为系统默认铃声。铃声文件需要使用uni原生插件[点此打开](https://ext.dcloud.net.cn/plugin?id=690)打包后生效。建议iOS和Android铃声使用一致的文件名称。直接填写文件名,不含扩展名;如:pushsound.caf或pushsound.mp3,直接填写pushsound即可。|
|content_available|Number|否|0|0表示普通通知消息(默认为0);1表示静默推送(无通知栏消息),静默推送时不需要填写其他参数。苹果官方建议1小时最多推送3条静默消息|ios |
|open_url|string|否|无|填写该值将:强制push类型为“通知栏消息”,点击后系统浏览器将打开此链接。以`http(s)://`开头的有效可访问链接,华为通道必须使用https。长度小于300|android|
@@ -120,7 +122,7 @@ await uniPush.sendMessage(OBJECT)
**频次限制说明:**
- 多客户端接收消息推送API,频次限制200万次/天,申请修改请点击右侧“技术咨询”了解详情。
-- 通过getui_big_data_tag(根据条件筛选用户推送)指定消息接收者推送API,频次限制100次/天,每分钟不能超过5次(推送限制和接口执行群推共享限制),定时推送功能需要申请开通才可以使用,申请修改请点击右侧“技术咨询”了解详情。
+- 通过getui_big_data_tag(根据条件筛选设备推送)指定消息接收者推送API,频次限制100次/天,每分钟不能超过5次(推送限制和接口执行群推共享限制),定时推送功能需要申请开通才可以使用,申请修改请点击右侧“技术咨询”了解详情。
- 对指定应用的所有用户群发推送消息API,频次限制100次/天,每分钟不能超过5次(推送限制和接口根据条件筛选用户推送共享限制)
**注意:**
@@ -135,7 +137,27 @@ await uniPush.sendMessage(OBJECT)
| opt_type|String|是|无|or(或),and(与),not(非),`values`间的交并补操作|
- 不同key之间是交集,同一个key之间是根据`opt_type`操作
-- eg. 需要发送给城市在A,B,C里面,没有设置tagtest标签,手机型号为android的用户,用条件交并补功能可以实现,city(A|B|C) && !tag(tagtest) && phonetype(android)
+- eg. 需要发送给城市在A,B,C里面,没有设置tagtest标签,手机型号为android的设备,用条件交并补功能可以实现,city(A|B|C) && !tag(tagtest) && phonetype(android)
+
+##### platform 说明
+|值|解释|
+|:-|:-|
+|app-ios|iOS App|
+|app-android|Android App|
+|web|网页|
+|mp-weixin|微信小程序|
+|mp-alipay|支付宝小程序|
+|mp-baidu|百度小程序|
+|mp-toutiao|字节跳动小程序|
+|mp-lark|飞书小程序|
+|mp-qq|QQ小程序|
+|mp-kuaishou|快手小程序|
+|mp-jd|京东小程序|
+|mp-360|360小程序|
+|quickapp-webview|快应用通用(包含联盟、华为)|
+|quickapp-webview-union|快应用联盟|
+|quickapp-webview-huawei|快应用华为|
+
##### settings 说明
|名称|类型|必填|默认值|描述|
@@ -148,7 +170,7 @@ await uniPush.sendMessage(OBJECT)
##### strategy 厂商下发策略选择
|名称|类型|必填|默认值|描述|
|--|--|--|--|--|
-|default|Number|否|1|默认所有通道的策略选择1-4
1: 表示该消息在用户在线时推送个推通道,用户离线时推送厂商通道;
2: 表示该消息只通过厂商通道策略下发,不考虑用户是否在线;
3: 表示该消息只通过个推通道下发,不考虑用户是否在线;
4: 表示该消息优先从厂商通道下发,若消息内容在厂商通道代发失败后会从个推通道下发。 其中名称可填写: ios、st、hw、xm、vv、mz、op,如有疑问请点击右侧“技术咨询”了解详情。|
+|default|Number|否|1|默认所有通道的策略选择1-4
1: 表示该消息在设备在线时推送个推通道,设备离线时推送厂商通道;
2: 表示该消息只通过厂商通道策略下发,不考虑设备是否在线;
3: 表示该消息只通过个推通道下发,不考虑设备是否在线;
4: 表示该消息优先从厂商通道下发,若消息内容在厂商通道代发失败后会从个推通道下发。 其中名称可填写: ios、st、hw、xm、vv、mz、op,如有疑问请点击右侧“技术咨询”了解详情。|
|ios|Number|否|无|ios通道策略1-4,表示含义同上,要推送ios通道,需要在个推开发者中心上传ios证书,建议填写2或4,否则可能会有消息不展示的问题|
|st|Number|否|无|通道策略1-4,表示含义同上,需要开通st厂商使用该通道推送消息|
|...|Number|否|无|通道策略1-4,表示含义同上|
@@ -193,8 +215,8 @@ await uniPush.sendMessage(OBJECT)
| ------ | ---- | -------- |
| $taskid | Object | 任务编号 |
| $alias | String |设备别名|
-| $cid | String |App的用户唯一标识|
-| $status | Object |推送结果
successed_offline: 离线下发(包含厂商通道下发),
successed_online: 在线下发,
successed_ignore: 最近90天内不活跃用户不下发|
+| $cid | String |个推客户端id|
+| $status | Object |推送结果
successed_offline: 离线下发(包含厂商通道下发),
successed_online: 在线下发,
successed_ignore: 最近90天内不活跃设备不下发|
群发返回值示例:
```js
@@ -227,8 +249,8 @@ await uniPush.sendMessage(OBJECT)
| 名称 | 类型 | 描述 |
| ------ | ---- | -------- |
| $taskid | Object | 任务编号 |
-| $cid | String |App的用户唯一标识|
-| $status | Object |推送结果
successed_offline: 离线下发(包含厂商通道下发),
successed_online: 在线下发,
successed_ignore: 最近90天内不活跃用户不下发|
+| $cid | String |个推客户端id|
+| $status | Object |推送结果
successed_offline: 离线下发(包含厂商通道下发),
successed_online: 在线下发,
successed_ignore: 最近90天内不活跃设备不下发|
### 消息任务
#### 停止任务
@@ -358,11 +380,11 @@ await push.getTaskDetail(OBJECT)
|event|String|事件|
-### 用户别名
-开发者可对用户设定别名与标签,推送时可直接根据别名、标签进行推送,方便对用户的管理。
-别名是开发者根据自身需求为每个用户设定的标识,建议对不同用户设定不同别名,保证可通过别名来唯一确认某特定用户。
+### 设备别名
+开发者可对设备设定别名与标签,推送时可直接根据别名、标签进行推送,方便对设备的管理。
+别名是开发者根据自身需求为每个设备设定的标识,建议对不同设备设定不同别名,保证可通过别名来唯一确认某特定设备。
-例子:可将用户的邮箱、昵称、手机号等设为别名,即可通过邮箱、昵称、手机号指定目标用户下发推送。
+例子:可将用户的邮箱、昵称、手机号等设为别名,即可通过邮箱、昵称、手机号指定目标设备下发推送。
>一个cid只能绑定一个别名,若已绑定过别名的cid再次绑定新别名,则前一个别名会自动解绑,并绑定新别名。
#### 绑定别名
一个cid只能绑定一个别名,若已绑定过别名的cid再次绑定新别名,则前一个别名会自动解绑,并绑定新别名。
@@ -391,7 +413,7 @@ await push.cidBindAlias(OBJECT)
| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
| --------- | ------------- | ---- | ---- | -------- |
-| cid |String|是|无| cid,用户标识|
+| cid |String|是|无| cid,设备标识|
| alias |String|是|无|别名,有效的别名组成:
字母(区分大小写)、数字、下划线、汉字;
长度<40;
一个别名最多允许绑定10个cid。|
##### 响应体说明
@@ -415,7 +437,7 @@ await push.getAliasByCid(cid)
##### 入参说明
| 名称 | 类型 | 是否必须 | 默认值| 说明 |
| ------ | ------ | ------ | ------ | ------ |
-| cid | String | 是 | 无 | 用户唯一标识 |
+| cid | String | 是 | 无 | 设备唯一标识 |
##### 响应体说明
* 返回值示例
@@ -521,7 +543,7 @@ await push.unboundAllAlias(alias)
##### 入参说明
| 名称 | 类型 | 是否必须 | 默认值| 说明 |
| ------ | ------ | ------ | ------ | ------ |
-| alias | String | 是 | 无 | 用户别名 |
+| alias | String | 是 | 无 | 设备别名 |
##### 响应体说明
* 返回值示例
@@ -537,11 +559,11 @@ await push.unboundAllAlias(alias)
### 客户端标签
-开发者可对用户设定别名与标签,推送时可直接根据别名、标签进行推送,方便对用户的管理。
-标签是用户的一种属性,每个用户(通过CID来标识 )可以打上100个标签。
+开发者可对设备设定别名与标签,推送时可直接根据别名、标签进行推送,方便对设备的管理。
+标签是设备的一种属性,每个设备(通过CID来标识 )可以打上100个标签。
例子:“喜爱足球”,“喜爱动漫”
-#### 一个用户绑定一批标签
-一个用户绑定一批标签,此操作为覆盖操作,会删除历史绑定的标签;
+#### 一个设备绑定一批标签
+一个设备绑定一批标签,此操作为覆盖操作,会删除历史绑定的标签;
> 此接口对单个cid有频控限制,每天只能修改一次,最多设置100个标签;单个标签长度最大为32字符,标签总长度最大为512个字符,申请修改请点击右侧“技术咨询”了解详情 。
##### 接口形式
```js
@@ -564,7 +586,7 @@ await push.cidBindCustomTags(OBJECT)
| 名称 | 类型 | 是否必须 | 默认值| 说明 |
| ------ | ------ | ------ | ------ | ------ |
-| cid | String | 是 | 无 | 用户标识 |
+| cid | String | 是 | 无 | 设备标识 |
| custom_tag |String Array|是|无|标签列表,标签中不能包含空格|
##### 响应体说明
@@ -581,8 +603,8 @@ await push.cidBindCustomTags(OBJECT)
-#### 一批用户绑定一个标签
-一批用户绑定一个标签,此接口为增量
+#### 一批设备绑定一个标签
+一批设备绑定一个标签,此接口为增量
> 此接口有频次控制(每分钟最多100次,每天最多10000次),申请修改请点击右侧“技术咨询”了解详情
##### 接口形式
```js
@@ -618,8 +640,8 @@ await push.cidsBindCustomTag(OBJECT)
> 返回结构说明请参考[公共返回结构](#公共返回结构)
-#### 一批用户解绑一个标签
-解绑用户的某个标签属性,不影响其它标签
+#### 一批设备解绑一个标签
+解绑设备的某个标签属性,不影响其它标签
>此接口有频次控制(每分钟最多100次,每天最多10000次),申请修改请点击右侧“技术咨询”了解详情
##### 接口形式
```js
@@ -664,7 +686,7 @@ await push.searchCustomTagByCid(cid)
##### 入参说明
| 名称 | 类型 | 是否必须 | 默认值| 说明 |
| ------ | ------ | ------ | ------ | ------ |
-| cid | Array | 是 | 无 | 用户标识 |
+| cid | Array | 是 | 无 | 设备标识 |
##### 响应体说明
* 返回值示例
@@ -690,11 +712,11 @@ await push.searchCustomTagByCid(cid)
|$cid|Object|key: cid,value: 标签列表,列表中只会有一个元素,多个以空格隔开|
-### 黑名单用户
-黑名单用户无法收到推送消息。当使用群发全推时,有时需要调节某些设备不发,此时需要按push_clientid进行黑名单控制。
+### 黑名单设备
+黑名单设备无法收到推送消息。当使用群发全推时,有时需要调节某些设备不发,此时需要按push_clientid进行黑名单控制。
-#### 添加黑名单用户
-将单个或多个用户加入黑名单,对于黑名单用户在推送过程中会被过滤掉。
+#### 添加黑名单设备
+将单个或多个设备加入黑名单,对于黑名单设备在推送过程中会被过滤掉。
##### 接口形式
```js
@@ -703,7 +725,7 @@ await push.addCidToBlacklist(push_clientid)
##### 入参说明
| 名称 | 类型 | 是否必须 | 默认值| 说明 |
| ------ | ------ | ------ | ------ | ------ |
-| push_clientid | String | 是 | 无 | 用户标识,多个以英文逗号隔开,一次最多传200个 |
+| push_clientid | String | 是 | 无 | 设备标识,多个以英文逗号隔开,一次最多传200个 |
##### 响应体说明
* 返回值示例
@@ -718,8 +740,8 @@ await push.addCidToBlacklist(push_clientid)
> 返回结构说明请参考[公共返回结构](#公共返回结构)
-#### 移除黑名单用户
-将单个push_clientid或多个push_clientid用户移出黑名单,对于黑名单用户在推送过程中会被过滤掉的,不会给黑名单用户推送消息
+#### 移除黑名单设备
+将单个push_clientid或多个push_clientid设备移出黑名单,对于黑名单设备在推送过程中会被过滤掉的,不会给黑名单设备推送消息
##### 接口形式
```js
await push.removeCidInBlacklist(push_clientid)
@@ -727,7 +749,7 @@ await push.removeCidInBlacklist(push_clientid)
##### 入参说明
| 名称 | 类型 | 是否必须 | 默认值| 说明 |
| ------ | ------ | ------ | ------ | ------ |
-| getui_ | String | 是 | 无 | 用户标识,多个以英文逗号隔开,一次最多传200个 |
+| getui_ | String | 是 | 无 | 设备标识,多个以英文逗号隔开,一次最多传200个 |
##### 响应体说明
* 返回值示例
@@ -755,7 +777,7 @@ await push.getClientStatusByCid(push_clientid)
##### 入参说明
| 名称 | 类型 | 是否必须 | 默认值 | 说明 |
|:----|:-------|:--------|:------|:---------------------------------------|
-| push_clientid | String | 是 | 无 | 用户标识,多个以英文逗号隔开,一次最多传1000个 |
+| push_clientid | String | 是 | 无 | 设备标识,多个以英文逗号隔开,一次最多传1000个 |
##### 响应体说明
* 返回值示例
@@ -778,7 +800,7 @@ await push.getClientStatusByCid(push_clientid)
| 名称 | 类型 | 描述 |
| ------ | ---- | -------- |
-| $cid | Object | key: cid,value: 用户状态信息 |
+| $cid | Object | key: cid,value: 设备状态信息 |
| last_login_time | String | 毫秒时间戳 |
| status | String | 状态,online在线 offline离线 |
@@ -796,7 +818,7 @@ await push.getDeviceStatusByCid(cid)
##### 入参说明
| 名称 | 类型 | 是否必须 | 默认值 | 说明 |
|:----|:-------|:--------|:------|:---------------------------------------|
-| cid | String | 是 | 无 | 用户标识,多个以英文逗号隔开,一次最多传100个 |
+| cid | String | 是 | 无 | 设备标识,多个以英文逗号隔开,一次最多传100个 |
##### 响应体说明
* 返回值示例
@@ -824,13 +846,13 @@ await push.getDeviceStatusByCid(cid)
| 名称 | 类型 | 描述 |
| ------ | ---- | -------- |
-| $cid | Object | key: cid,value: 用户状态信息 |
+| $cid | Object | key: cid,value: 设备状态信息 |
| cid_status | String | cid在线状态,online在线 offline离线 |
| device_status | String | 设备在线状态,online在线 offline离线 |
#### 设备详细信息
-查询用户的信息
+查询设备的信息
##### 接口形式
```js
await push.getClientDetailByCid(String|Array)
@@ -838,7 +860,7 @@ await push.getClientDetailByCid(String|Array)
##### 入参说明
| 名称 | 类型 | 是否必须 | 默认值 | 说明 |
|:----|:-------|:--------|:------|:---------------------------------------|
-| cid | String | 是 | 无 | 用户标识,多个以英文逗号隔开,一次最多传1000个 |
+| cid | String | 是 | 无 | 设备标识,多个以英文逗号隔开,一次最多传1000个 |
##### 响应体说明
* 返回值示例
@@ -875,7 +897,7 @@ await push.getClientDetailByCid(String|Array)
| 名称 | 类型 | 描述 |
| ------ | ---- | -------- |
-| validCids | Object Array | 用户信息列表 |
+| validCids | Object Array | 设备信息列表 |
| invalidCids | String Array | 无效cid列表 |
**validCids中的${cid}**
@@ -893,7 +915,7 @@ await push.getClientDetailByCid(String|Array)
#### 查询设备总量
-通过指定查询条件来查询满足条件的用户数量
+通过指定查询条件来查询满足条件的设备数量
##### 接口形式
```js
await push.getClientCount(OBJECT)
@@ -932,14 +954,14 @@ await push.getClientCount(OBJECT)
* 请求参数说明
-| 名称 | 类型 | 是否必须 | 默认值 | 描述 |
-|---- |----|---| ----|
-| key | String | 是 | 无 |查询条件(phone_type 手机类型,region 省市,custom_tag 客户端标签,设置标签请见[接口](#客户端标签))|
-| values | String Array | 是 | 无 |查询条件值列表,其中
**手机型号**使用如下参数`android`和`ios`;
**省市**使用编号,[点击下载文件region_code.data](https://docs.getui.com/files/region_code.data); |
-| opt_type|String|是|无|or(或),and(与),not(非),`values`间的交并补操作|
+| 名称 | 类型 | 是否必须| 默认值| 描述|
+|---- |---- |--- | ---- |---|
+| key | String | 是 | 无 |查询条件(phone_type 手机类型,region 省市,custom_tag 客户端标签,设置标签请见[接口](#客户端标签))|
+| values | String Array | 是 | 无 |查询条件值列表,其中
**手机型号**使用如下参数`android`和`ios`;
**省市**使用编号,[点击下载文件region_code.data](https://docs.getui.com/files/region_code.data);|
+| opt_type | String | 是 |无 |or(或),and(与),not(非),`values`间的交并补操作|
- 不同key之间是交集,同一个key之间是根据`opt_type`操作
-- 需要发送给城市在A,B,C里面,没有设置tagtest标签,手机型号为android的用户,用条件交并补功能可以实现,city(A|B|C) && !tag(tagtest) && phonetype(android)
+- 需要发送给城市在A,B,C里面,没有设置tagtest标签,手机型号为android的设备,用条件交并补功能可以实现,city(A|B|C) && !tag(tagtest) && phonetype(android)
##### 响应体说明
返回值示例
@@ -960,7 +982,7 @@ await push.getClientCount(OBJECT)
| 名称 | 类型 | 描述 |
| ------ | ---- | -------- |
-| user_count | Number | 符合条件的用户数量 |
+| user_count | Number | 符合条件的设备数量 |
#### 设置应用角标(仅支持IOS)
@@ -972,8 +994,8 @@ await push.setBadgeByCid(OBJECT)
##### 入参说明
| 名称 | 类型 | 是否必须 | 默认值| 说明 |
| ------ | ------ | ------ | ------ | ------ |
-| cid | String | 是 | 无 | 用户标识,多个以英文逗号隔开,一次最多传200个 |
-| badge |String|是|无|用户应用icon上显示的数字
`+N`: 在原有badge上+N
`-N`: 在原有badge上-N
`N`: 直接设置badge(数字,会覆盖原有的badge值) |
+| cid | String | 是 | 无 | 设备标识,多个以英文逗号隔开,一次最多传200个 |
+| badge |String|是|无|设备应用icon上显示的数字
`+N`: 在原有badge上+N
`-N`: 在原有badge上-N
`N`: 直接设置badge(数字,会覆盖原有的badge值) |
* 参数示例
```js
@@ -1219,7 +1241,7 @@ await push.getReportDetailByTaskid(taskid)
|10|关闭通知|
|11|其他厂商原因|
|12|消息有效期内离线|
-|13|无效用户|
+|13|无效设备|
|14|其它|
|7001|title通知标题过长|
|7002|content通知内容过长|
@@ -1380,7 +1402,7 @@ await push.getTodayReport()
|**gt** | Object | 个推通道 |
|gt/app |Object | 个推群推接口推送限制|
|gt/list |Object | 个推创建消息接口限制 |
-|gt/app\_with\_tag | Object |个推 根据条件筛选用户推送接口推送限制 |
+|gt/app\_with\_tag | Object |个推 根据条件筛选设备推送接口推送限制 |
|**xm** |Object | xm通道 |
|xm/general |Object | xm通道 普通消息限制,channel是普通级别消息时推送量限制 |
|**op** |Object | op通道 |
@@ -1395,8 +1417,8 @@ await push.getTodayReport()
| limit |boolean| 是否被限量,当日可推送总量使用完时,该字段更新true|
-#### 获取单日用户数据接口
-调用此接口可以获取某个应用单日的用户数据(用户数据包括:新增用户数,累计注册用户总数,在线峰值,日联网用户数)(目前只支持查询非当天的数据)
+#### 获取单日设备数据接口
+调用此接口可以获取某个应用单日的设备数据(设备数据包括:新增设备数,累计注册设备总数,在线峰值,日联网设备数)(目前只支持查询非当天的数据)
##### 接口形式
```js
await push.getClientReportByDate(date)
@@ -1432,13 +1454,13 @@ await push.getClientReportByDate(date)
| 名称 | 类型 | 描述 |
| ------ | ---- | -------- |
|$date|Object|key: 日期,格式: yyyy-MM-dd,value: 统计数据|
-|accumulative_num|Number|累计注册用户数|
-|register_num|Number|注册用户数|
-|active_num|Number|活跃用户数|
-|online_num|Number|在线用户数|
+|accumulative_num|Number|累计注册设备数|
+|register_num|Number|注册设备数|
+|active_num|Number|活跃设备数|
+|online_num|Number|在线设备数|
-#### 获取24个小时在线用户数
-查询当前时间一天内的在线用户数(10分钟一个点,1个小时六个点)
+#### 获取24个小时在线设备数
+查询当前时间一天内的在线设备数(10分钟一个点,1个小时六个点)
##### 接口形式
```js
await push.getTodayOnlineClientReport()
@@ -1472,8 +1494,8 @@ await push.getTodayOnlineClientReport()
| 名称 | 类型 | 描述 |
| ------ | ---- | -------- |
-|online_statics|Object|在线用户统计数据|
-|$date|Number|key: 毫秒时间戳,value: 在线用户数|
+|online_statics|Object|在线设备统计数据|
+|$date|Number|key: 毫秒时间戳,value: 在线设备数|
### 公共返回结构