action.devices.QUERY

Este intent consulta tu entrega sobre los estados actuales de los dispositivos, lo que incluye si el dispositivo está en línea y es accesible.

Tu respuesta de QUERY solo debe mostrar información de estado. La actualización de los atributos y rasgos del dispositivo se controla Respuesta SYNC.

Para obtener más detalles, lee Consulta y ejecuta.

Formato de la solicitud

Campos Tipo Descripción
requestId String

Obligatorio.

Es el ID de la solicitud.
inputs Matriz

Obligatorio.

Lista de entradas que coinciden con la solicitud de intent.
[item, ...] Objeto

Tipo y carga útil asociados con la solicitud de intent.
intent

Obligatorio.

(Valor constante: "action.devices.QUERY")

Tipo de solicitud de intent.
payload Objeto

Obligatorio.

Carga útil de la solicitud de QUERY.
devices Matriz

Obligatorio.

Lista de dispositivos de destino.
[item, ...] Objeto

Destinos de dispositivo a consultar.
id String

Obligatorio.

ID de dispositivo, según el ID proporcionado en SYNC.
customData Objeto

Si el objeto customData opaco se proporciona en SYNC, se envía aquí.
Ejemplos

Solicitud de intent QUERY

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123",
            "customData": {
              "fooValue": 74,
              "barValue": true,
              "bazValue": "foo"
            }
          },
          {
            "id": "456",
            "customData": {
              "fooValue": 12,
              "barValue": false,
              "bazValue": "bar"
            }
          }
        ]
      }
    }
  ]
}

Formato de respuesta

Campos Tipo Descripción
requestId String

Obligatorio.

Es el ID de la solicitud correspondiente.
payload Objeto

Obligatorio.

Carga útil de la respuesta de intent.
errorCode String

Un código de error para toda la transacción en busca de fallas de autenticación y de falta de disponibilidad del sistema del desarrollador. Para errores de dispositivos individuales, usa el errorCode dentro del objeto del dispositivo.
debugString String

Errores detallados que nunca se presentarán a los usuarios, pero que pueden registrarse o usarse durante el desarrollo.
devices Objeto

Obligatorio.

Mapa de dispositivos Asigna el ID de dispositivo del desarrollador de Maps al objeto de las propiedades de estado.
<string> Objeto

Estado del dispositivo.
online Booleano

Obligatorio.

Indica si el dispositivo está en línea (es decir, es accesible) o no.
status String

Obligatorio.

Resultado de la operación de consulta.

Valores admitidos:

SUCCESS
Confirma que la consulta se haya realizado correctamente.
OFFLINE
El dispositivo de destino se encuentra en estado sin conexión o es inaccesible.
EXCEPTIONS
Hay un problema o una alerta asociados con una consulta. La consulta podría completarse con éxito o fallar. Por lo general, este tipo de estado se establece cuando quieres enviar información adicional sobre otro dispositivo conectado.
ERROR
No se pudo consultar el dispositivo de destino.
errorCode String

Expansión del estado de ERROR, si es necesario, a partir de los códigos de error predeterminados, que se asignarán a los errores que se presentan a los usuarios.
Ejemplos

Respuesta al intent QUERY

{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "devices": {
      "123": {
        "on": true,
        "online": true,
        "status": "SUCCESS"
      },
      "456": {
        "on": true,
        "online": true,
        "status": "SUCCESS",
        "brightness": 80,
        "color": {
          "spectrumRgb": 16711935
        }
      }
    }
  }
}