action.devices.QUERY

Essa intent consulta o fulfillment para saber os estados atuais dos dispositivos, incluindo se eles estão on-line e acessíveis.

A resposta QUERY precisa retornar apenas informações de estado. A atualização dos atributos e características do dispositivo é processada pelo Resposta SYNC.

Para mais detalhes, consulte Consultar e executar.

Formato da solicitação

Campos	Tipo	Descrição
`requestId`	String	Obrigatório. ID da solicitação.
`inputs`	Array	Obrigatório. Lista de entradas que correspondem à solicitação de intent.
`[item, ...]`	Object	Tipo e payload associados à solicitação de intent.
`intent`		Obrigatório. (Valor constante: `"action.devices.QUERY"`) Tipo de solicitação de intent.
`payload`	Object	Obrigatório. QUERY.
`devices`	Array	Obrigatório. Lista de dispositivos de destino.
`[item, ...]`	Object	Segmentações por dispositivo para consulta.
`id`	String	Obrigatório. ID do dispositivo, de acordo com o ID fornecido em SYNC.
`customData`	Object	Se o objeto customData opaco for fornecido em SYNC, ele será enviado para cá.

Exemplos

Solicitação 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 da resposta

Campos	Tipo	Descrição
`requestId`	String	Obrigatório. ID da solicitação correspondente.
`payload`	Object	Obrigatório. Payload de resposta da intent.
`errorCode`	String	Um código de erro para toda a transação para falhas de autenticação e indisponibilidade do sistema do desenvolvedor. Para erros de dispositivos individuais, use o errorCode no objeto do dispositivo.
`debugString`	String	Erro detalhado que nunca será apresentado aos usuários, mas pode ser registrado ou usado durante o desenvolvimento.
`devices`	Object	Obrigatório. Mapa de dispositivos. ID do dispositivo do desenvolvedor do Google Maps para o objeto de propriedades de estado.
`<string>`	Object	Estado do dispositivo.
`online`	Booleano	Obrigatório. Indica se o dispositivo está on-line (ou seja, acessível) ou não.
`status`	String	Obrigatório. Resultado da operação de consulta. Valores compatíveis: `SUCCESS` Confirmar se a consulta foi bem-sucedida. `OFFLINE` O dispositivo de destino está off-line ou inacessível. `EXCEPTIONS` Há um problema ou um alerta associado a uma consulta. A consulta pode ter êxito ou falhar. Normalmente, esse tipo de status é definido quando você quer enviar informações adicionais sobre outro dispositivo conectado. `ERROR` Não foi possível consultar o dispositivo de destino.
`errorCode`	String	Expansão do estado ERROR, se necessário, dos códigos de erro predefinidos, que serão mapeados para os erros apresentados aos usuários.

Exemplos

Resposta da 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
        }
      }
    }
  }
}