QueryDeviceStat查询App的新增与累计设备数-移动研发平台-阿里云

接口说明

说明

目前只支持返回天的数据，天维度最多支持查 31 天内数据，天以北京时间为准。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

mpush:QueryDeviceStat

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
AppKey	integer	是	AppKey 信息。	23267207
StartTime	string	是	查询的开始时间。时间格式按照 ISO8601 标准表示，并需要使用 UTC 时间，格式为 YYYY-MM-DDThh:mm:ssZ。说明统计开始日期为开始时间当天北京时间 0 点。	2016-07-28T00:00:00Z
EndTime	string	是	查询的结束时间。时间格式按照 ISO8601 标准表示，并需要使用 UTC 时间，格式为 YYYY-MM-DDThh:mm:ssZ。说明统计结束日期为结束时间当天。	2016-07-29T00:00:00Z
DeviceType	string	否	重要该参数仅对早期的安卓苹果双端应用类型有效，当您的应用为双端应用时，可以通过指定该参数为 iOS 或 ANDROID 分别查出两种类型的设备数。默认为查询 ALL 类型。设备类型，取值范围为： iOS：iOS 设备 ANDROID：Android 设备 ALL：全部类型设备枚举值： ALL : ALL ANDROID : ANDROID iOS : iOS	iOS
QueryType	string	是	查询的是新增设备数还是历史累计设备数。可取值： NEW：新增设备 TOTAL：累计设备数	TOTAL

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC
AppDeviceStats	object
AppDeviceStat	array<object>	设备统计数据 AppDeviceStat 组成的数组。
	object	设备统计数据对象 AppDeviceStat。
Time	string	截止时间。时间格式按照 ISO8601 标准表示，并使用 UTC 时间，格式为 YYYY-MM-DDThh:mm:ssZ。	2016-07-28T16:00:00Z
DeviceType	string	设备类型。	iOS
Count	integer	设备数。	100

示例

正常返回示例

JSON格式

{
  "RequestId": "9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC",
  "AppDeviceStats": {
    "AppDeviceStat": [
      {
        "Time": "2016-07-28T16:00:00Z",
        "DeviceType": "iOS",
        "Count": 100
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。