Google Assistant服务

更新时间：2018-08-29 13:00:11

Google Assistant服务

提供一组对接Google Smart Home Action接口。

• 查询设备列表

• 查询设备状态

• 控制设备

查询设备列表

定义描述

请求参数

返回参数

deviceList列表结构</span>

name结构

deviceInfoDTO结构

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0"
    },
    "params": {
        "accessToken" : "0bc19fa515354264450105920d45d2",
       "oauthOrigin" : "OPEN_ACCOUNT"
    }
}

正常返回示例

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "id": "123",
            "type": "action.devices.types.OUTLET",
            "traits": [
                "action.devices.traits.OnOff"
            ],
            "name": {
                "defaultNames": [
                    "MyOutlet1234"
                ],
                "name": "Nightlight",
                "nicknames": [
                    "wallplug"
                ]
            },
            "willReportState": false,
            "deviceInfo": {
                "manufacturer": "lights-out-inc",
                "model": "hs1234",
                "hwVersion": "3.2",
                "swVersion": "11.4"
            },
            "customData": {
                "fooValue": 74,
                "barValue": true,
                "bazValue": "foo"
            }
        }
    ]
}

错误码

查询设备状态

定义描述

请求参数

devices列表结构

返回参数

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0"
    },
    "params": {
        "devices": [{
            "id": "123"
        }],
        "accessToken": "0bc19fa515354264450105920d45d2",
        "oauthOrigin": "OPEN_ACCOUNT"
    }
}

正常返回示例

{
    "code": 200,
    "message": "success",
    "data": {
        "123": {
            "on": true,
            "online": true,
            "brightness": 80,
            "color": {
                "name": "cerulean",
                "spectrumRGB": 31655
            }
        }
    }
}

错误码

控制设备

定义描述

请求参数

devices列表结构

返回参数

示例

请求示例

{
    "id": "1509086454180",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0"
    },
    "params": {
        "devices": [{
            "id": "123"
        }],
        "accessToken": "0bc19fa515354264450105920d45d2",
        "oauthOrigin": "OPEN_ACCOUNT",
        "params": {
            "brightness": 50
        },
        "command": "action.devices.commands.BrightnessAbsolute"
    }
}

正常返回示例

{
    "code": 200,
    "message": "success",
    "data": {
        "123": {
            "isSuccess": true,
            "message": "success",
            "localizedMsg": ""
        }
    }
}

错误码