---
name: "getAnalyticsLogsPublishLog"
mode: "api"
versionRequirements:
  - { name: "@tuya-miniapp/cloud-api", version: "1.0.5" }
title: "getAnalyticsLogsPublishLog - 获取时间段里的下发日志历史记录"
---

## getAnalyticsLogsPublishLog

> [VERSION] @tuya-miniapp/cloud-api >= 1.0.5

### 描述

获取时间段里的下发日志历史记录

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `data` | `GetAnalyticsLogsParams` | 是 | 请求体 |

### 返回值

类型: `Promise<GetAnalyticsLogsResult>`

含 dps（DP 结果列表）、hasNext、total；dps 元素为 DpResult（下发日志场景下文档含 nickName、userName）

### 引用对象

##### `type` GetAnalyticsLogsParams

下发/上报日志查询共用请求参数（字段与 minituya 参数表一致；SchemaDoc 从本类型各属性抽取说明）。

| 属性 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `devId` | `string` | 是 | 设备 ID |
| `dpIds` | `string` | 是 | DP 点 ID，可以是多个 DP，用逗号隔开即可 |
| `dpValues` | `string` | 否 | 查询指定的功能点值，dpIds 为一个时生效，多 dpIds 查询不生效，用逗号隔开即可，不支持 Raw 型功能点。 当前仅免费版设备日志生效。 |
| `offset` | `number` | 是 | 查询返回结果时从指定序列后的结果开始返回（offset 从 0 开始） |
| `limit` | `number` | 是 | 单页的最大值，offset + limit 要小于等于 1000 |
| `startTime` | `string` | 否 | 设备上报的时间，查询起始时间，单位为毫秒。为空默认填充 7 天前时间戳 |
| `endTime` | `string` | 否 | 设备上报的时间，查询结束时间，单位为毫秒。为空默认填充当前时间戳 |
| `sortType` | `string` | 否 | DESC 倒序 或 ASC 顺序，默认 DESC |
| `queryType` | `string` | 否 | `0`：根据设备 id 所属产品 id 自动切换查询数据源。 `1`：查免费版设备日志数据源。 `2`：查收费版设备日志数据源。  在未购买收费版日志时，可忽略该入参 |

##### `type` GetAnalyticsLogsResult

日志分页结果。文档返回示例中另出现 `dpc` 字段，返回参数表未逐项说明。

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `dps` | `DpResult[]` | 设备功能点数据集合 |
| `hasNext` | `boolean` | 是否还有下一页数据 |
| `total` | `number` | 总记录数 |


### 示例代码

#### 请求示例

```typescript
import { getAnalyticsLogsPublishLog } from '@tuya-miniapp/cloud-api';

getAnalyticsLogsPublishLog({
  devId: '6c272a8d82e3ed8300mizk',
  dpIds: '103,27',
  offset: 0,
  limit: 10,
})
  .then((response) => {
    console.log(response);
  })
  .catch();
```

#### 返回示例

```json
{
  "dpc": [],
  "dps": [
    {
      "dpId": 27,
      "nickName": "86-155****1913",
      "timeStamp": 1696842723,
      "timeStr": "2023-10-09 17:12:03",
      "userName": "86-155****1913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-155****1913",
      "timeStamp": 1696842722,
      "timeStr": "2023-10-09 17:12:02",
      "userName": "86-155****1913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-155****1913",
      "timeStamp": 1696842722,
      "timeStr": "2023-10-09 17:12:02",
      "userName": "86-155****1913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-155****1913",
      "timeStamp": 1696842720,
      "timeStr": "2023-10-09 17:12:00",
      "userName": "86-155****1913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-155****1913",
      "timeStamp": 1696842720,
      "timeStr": "2023-10-09 17:12:00",
      "userName": "86-155****1913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-155****1913",
      "timeStamp": 1696842720,
      "timeStr": "2023-10-09 17:12:00",
      "userName": "86-155****1913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-155****1913",
      "timeStamp": 1696842719,
      "timeStr": "2023-10-09 17:11:59",
      "userName": "86-155****1913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-155****1913",
      "timeStamp": 1696842719,
      "timeStr": "2023-10-09 17:11:59",
      "userName": "86-155****1913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-155****1913",
      "timeStamp": 1696842719,
      "timeStr": "2023-10-09 17:11:59",
      "userName": "86-155****1913",
      "value": "0000003e8006600000000"
    },
    {
      "dpId": 27,
      "nickName": "86-155****1913",
      "timeStamp": 1696842718,
      "timeStr": "2023-10-09 17:11:58",
      "userName": "86-155****1913",
      "value": "0000003e8006600000000"
    }
  ],
  "hasNext": true,
  "total": 97815
}
```


## 注意事项

1. 该接口为云能力，需开通授权后使用，关于云能力可[查看文档](/cn/miniapp/common/desc/tech-stack/api)。**目前云能力在 `开发者工具`环境无法使用，需要打包后或真机调试使用。**
2. **若想要升级设备日志存储能力，以及更多功能，可前往[设备日志增值服务](https://www.tuya.com/vas/commodity/DEVICE_LOG_QUERY_V2)查看升级。**升级服务后可参考[订阅设备日志存储服务后的开通流程](https://drive.weixin.qq.com/s?k=AGQAugfWAAkPDlmmAW)进行操作，升级设备存储能力后可使用接口获取更多日志。
3. 通过 Tuya MiniApp IDE 虚拟设备插件下发的指令不会记录在当前下发日志中，只有通过客户端真机实际下发的指令才会记录在下发日志中。