---
name: "getAnalyticsLogsPublishLog"
mode: "kit"
versionRequirements:
  - { name: "@tuya-miniapp/cloud-api", version: "1.0.5" }
---

## getAnalyticsLogsPublishLog

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

### 描述

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

### 参数

`Params`

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

### 引用对象

##### `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` DpResult

单条 DP 查询结果。
下发与上报文档在字段集合、`dpId` 形态上不一致（含返回示例与参数表差异）；与接口 `@returns` 互补，此处为类型层说明。

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `dpId` | `number \| string` | `number` 与文档表一致；上报日志返回示例中亦出现多 DP 组合的字符串 |
| `value` | `any` | DP 点值 |
| `timeStamp` | `number` | 时间戳 |
| `timeStr` | `string` | 时间字符串 |
| `nickName` | `string` | 昵称（下发日志文档字段） |
| `userName` | `string` | 用户名（下发日志文档字段） |


### 示例代码

#### 请求示例

```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
}
```