Welcome to the Google Home Developer Center, the new destination for learning how to develop smart home actions. Note: You'll continue building actions in the Actions console.
Stay organized with collections Save and categorize content based on your preferences.

Smart Home TemperatureSetting Trait Schema

action.devices.traits.TemperatureSetting - This trait covers handling both temperature point and modes.

Device ATTRIBUTES

Devices with this trait may report the following attributes as part of the SYNC operation. To learn more about handling SYNC intents, see Intent fulfillment.

Attributes Type Description
availableThermostatModes

Required.

Describes the thermostat modes this device can support.

Supports one of the following:
0 String

Deprecated

Comma-separated list of modes supported by this specific device. New integrations should use the Array form of this attribute.

1 Array

List of modes supported by this specific device.

[item, ...] String

Name of the supported mode.

Supported values:

off
Heating/Cooling activity disabled
heat
Device supports heating
cool
Device supports cooling
on
Restore the previous mode of the device. The on mode does not appear in the mode selection screen because the on mode, by design, is used to restore the previous mode of the device.
heatcool
Maintaining heating/cooling target as a range
auto
Automatic mode with temperature set by a schedule or learned behavior
fan-only
Fan running without heat/cool activity
purifier
Purifying mode
eco
Energy-saving mode
dry
Dry mode
thermostatTemperatureRange Object

Contains two float values that indicate the supported temperature range for this device (in degrees Celsius).

minThresholdCelsius Number

Required.

Minimum threshold of the temperature range.

maxThresholdCelsius Number

Required.

Maximum threshold of the temperature range.

thermostatTemperatureUnit String

Required.

The display unit the device is set to by default. Google reports temperature information using the display unit.

Supported values:

C
F
bufferRangeCelsius Number

(Default: 2)

Specifies the minimum offset between heat-cool setpoints in degrees Celsius, if heatcool mode is supported.

commandOnlyTemperatureSetting Boolean

(Default: false)

Indicates if the device supports using one-way (true) or two-way (false) communication. Set this attribute to true if the device cannot respond to a QUERY intent or Report State for this trait.

queryOnlyTemperatureSetting Boolean

(Default: false)

Required if the device supports query-only execution. This attribute indicates if the device can only be queried for state information, and cannot be controlled.

Examples

Thermostat device that supports discrete heating and cooling

{
  "availableThermostatModes": [
    "off",
    "heat",
    "cool",
    "on"
  ],
  "thermostatTemperatureUnit": "F"
}

Command-only thermostat device

{
  "availableThermostatModes": [
    "off",
    "heat",
    "cool",
    "on"
  ],
  "thermostatTemperatureUnit": "C",
  "commandOnlyTemperatureSetting": true,
  "queryOnlyTemperatureSetting": false
}

Device STATES

Devices with this trait may report the following states as part of the QUERY operation. To learn more about handling QUERY intents, see Intent fulfillment.

States Type Description
activeThermostatMode String

Currently active mode of the device, from the list of availableThermostatModes. If no mode is currently active, set to none.

Supported values:

none
No active mode
off
Heating/Cooling activity disabled
heat
Device supports heating
cool
Device supports cooling
on
Restore the previous mode of the device. The on mode does not appear in the mode selection screen because the on mode, by design, is used to restore the previous mode of the device.
heatcool
Maintaining heating/cooling target as a range
auto
Automatic mode with temperature set by a schedule or learned behavior
fan-only
Fan running without heat/cool activity
purifier
Purifying mode
eco
Energy-saving mode
dry
Dry mode
targetTempReachedEstimateUnixTimestampSec Integer

A timestamp representing the estimated time when the target temperature will be reached.

thermostatHumidityAmbient Number

Represents the relative level of the ambient humidity, if supported by the device.

Contains one of the following items:
0 Object

States for fixed set point.

thermostatMode String

Required.

Current mode of the device, from the list of availableThermostatModes.

Supported values:

none
No active mode
off
Heating/Cooling activity disabled
heat
Device supports heating
cool
Device supports cooling
on
Restore the previous mode of the device
heatcool
Maintaining heating/cooling target as a range
auto
Automatic mode with temperature set by a schedule or learned behavior
fan-only
Fan running without heat/cool activity
purifier
Purifying mode
eco
Energy-saving mode
dry
Dry mode
thermostatTemperatureAmbient Number

Required.

Current observed temperature, in degrees Celsius.

thermostatTemperatureSetpoint Number

Required.

Current temperature set point (single target), in degrees Celsius.

1 Object

States for set point range.

thermostatMode String

Required.

Current mode of the device, from the list of availableThermostatModes.

Supported values:

none
No active mode
off
Heating/Cooling activity disabled
heat
Device supports heating
cool
Device supports cooling
on
Restore the previous mode of the device
heatcool
Maintaining heating/cooling target as a range
auto
Automatic mode with temperature set by a schedule or learned behavior
fan-only
Fan running without heat/cool activity
purifier
Purifying mode
eco
Energy-saving mode
dry
Dry mode
thermostatTemperatureAmbient Number

Required.

Current observed temperature, in degrees Celsius.

thermostatTemperatureSetpointHigh Number

Required.

Current high point if in heatcool mode, for a range.

thermostatTemperatureSetpointLow Number

Required.

Current low point if in heatcool mode, for a range.

Examples

What is the current device temperature?

{
  "activeThermostatMode": "cool",
  "thermostatMode": "cool",
  "thermostatTemperatureSetpoint": 23,
  "thermostatTemperatureAmbient": 25.1
}

What is the current device temperature?

{
  "activeThermostatMode": "none",
  "thermostatMode": "heatcool",
  "thermostatTemperatureSetpointHigh": 26,
  "thermostatTemperatureSetpointLow": 22,
  "thermostatTemperatureAmbient": 25.1
}

Device COMMANDS

Devices with this trait may respond to the following commands as part of the EXECUTE operation. To learn more about handling EXECUTE intents, see Intent fulfillment.

action.devices.commands.ThermostatTemperatureSetpoint

Set the target temperature for a thermostat device.

Parameters

Parameters Type Description
thermostatTemperatureSetpoint Number

Required.

Target temperature setpoint. Supports up to one decimal place.

Examples

Set the device temperature to 22 degrees.

{
  "command": "action.devices.commands.ThermostatTemperatureSetpoint",
  "params": {
    "thermostatTemperatureSetpoint": 22
  }
}

An error occurred setting the target temperature.

Supported values:

alreadyAtMax
alreadyAtMin
targetAlreadyReached
valueOutOfRange

action.devices.commands.ThermostatTemperatureSetRange

Set a target temperature range for a thermostat device.

This command requires the following attributes:
{
  "availableThermostatModes": [
    "heatcool"
  ]
}

Parameters

Parameters Type Description
thermostatTemperatureSetpointHigh Number

Required.

High target setpoint for the range. Requires heatcool mode support.

thermostatTemperatureSetpointLow Number

Required.

Low target setpoint for the range. Requires heatcool mode support.

Examples

Hold the temperature between 22 and 26 degrees.

{
  "command": "action.devices.commands.ThermostatTemperatureSetRange",
  "params": {
    "thermostatTemperatureSetpointHigh": 26,
    "thermostatTemperatureSetpointLow": 22
  }
}

An error occurred setting the target range.

Supported values:

alreadyAtMax
alreadyAtMin
lockedToRange
rangeTooClose
targetAlreadyReached
valueOutOfRange

action.devices.commands.ThermostatSetMode

Set the target operating mode for a thermostat device.

Parameters

Parameters Type Description
thermostatMode String

Required.

Target mode, from the list of availableThermostatModes.

Supported values:

off
Heating/Cooling activity disabled
heat
Device supports heating
cool
Device supports cooling
on
Restore the previous mode of the device
heatcool
Maintaining heating/cooling target as a range
auto
Automatic mode with temperature set by a schedule or learned behavior
fan-only
Fan running without heat/cool activity
purifier
Purifying mode
eco
Energy-saving mode
dry
Dry mode

Examples

Set the device to heatcool mode.

{
  "command": "action.devices.commands.ThermostatSetMode",
  "params": {
    "thermostatMode": "heatcool"
  }
}

An error occurred setting the target mode.

Supported values:

inAutoMode
inAwayMode
inDryMode
inEcoMode
inFanOnlyMode
inHeatOrCool
inHumidifierMode
inOffMode
inPurifierMode

action.devices.commands.TemperatureRelative

Adjust the target temperature relative to the current state.

This command requires the following attributes:
{
  "commandOnlyTemperatureSetting": true
}

Parameters

The payload contains one of the following:

Adjust by degree.

Parameters Type Description
thermostatTemperatureRelativeDegree Number

Required.

The exact number of degrees for the temperature to change (for example, "Turn down 5 degrees").

Adjust by weight.

Parameters Type Description
thermostatTemperatureRelativeWeight Integer

Required.

This indicates the amount of ambiguous temperature change from a small amount ("Turn down a little"), to a large amount ("A lot warmer").

Examples

Increase temperature 5 degrees

{
  "command": "action.devices.commands.TemperatureRelative",
  "params": {
    "thermostatTemperatureRelativeDegree": 5
  }
}

Decrease the temperature a lot

{
  "command": "action.devices.commands.TemperatureRelative",
  "params": {
    "thermostatTemperatureRelativeWeight": -5
  }
}

An error occurred adjusting the temperature.

Supported values:

alreadyAtMax
alreadyAtMin
valueOutOfRange

Sample utterances

de-DE

  • Heizmodus anmachen
  • Mach den Heizmodus aus
  • Schalt den Heizmodus vom Thermostat aus
  • Temperatur auf 20 bis 25 Grad einstellen.
  • Thermostat auf 20 bis 25 Grad stellen.
  • Thermostat im Schlafzimmer kälter stellen
  • Wohnzimmer auf Kühlen umstellen
  • bitte dreh das Thermostat ein bisschen herunter
  • bitte dreh das Thermostat etwas höher
  • bitte mach es im Wohnzimmer kühler
  • bitte mach es in der Küche etwas kälter
  • bitte stell das Thermostat 5 Grad wärmer ein
  • bitte stell das Thermostat auf 21 Grad für Kühlen ein
  • bitte stell das Thermostat auf 30 Grad
  • bitte stell die Temperatur im Schlafzimmer auf 20 Grad
  • dreh das Thermostat wärmer bitte
  • dreh die Temperatur im Schlafzimmer etwas nach oben
  • dreh die Temperatur um 5 Grad runter
  • erhöhe bitte die Temperatur im Bad
  • erhöhe die Temperatur um 2 Grad
  • mach es im Wohnzimmer 2 Grad wärmer
  • senke die Temperatur im Wohnzimmer um 5 Grad
  • stell bitte das Thermostat auf Kühlen
  • stell das Thermostat 5 Grad kälter ein
  • stell die Kühlung auf 20 Grad ein

en-US

  • Turn off heat mode.
  • change the thermostat heat cool between 70 and 80
  • change to eco mode
  • cool down in the living room
  • cool down the house a little
  • increase the temperature on the thermostat
  • maintain the thermostat heat at 78
  • make it 2 degrees warmer
  • make it cooler by 2 degrees
  • make thermostat warmer a little bit
  • put on cooling mode
  • put the thermostat on cool
  • raise the temperature downstairs by 2 degrees
  • raise the temperature on thermostat by 5 degrees
  • set 70 degrees on the thermostat
  • set heat cool mode to between 62 and 79 degrees
  • set my temperature 80 degrees
  • set the heat to 72
  • set the temperature to cool at 70
  • set the thermostat at 70 in cool mode
  • turn down 5 degrees on thermostat
  • turn down the living room temp 2 degrees
  • turn off thermostat heat mode
  • turn thermostat a little lower
  • turn thermostat lower
  • warm up the living room
  • warm up the living room a little

es-ES

  • 25 grados de frío en la cocina
  • Ajustar el termostato entre 21 y 26 grados
  • Ajustar la temperatura entre 21 y 27 grados
  • activar el modo calefacción
  • apagar el aire acondicionado del termostato
  • aumenta 10 grados la temperatura del horno
  • aumenta la temperatura de la cocina
  • baja algo la calefacción
  • baja la temperatura 5 grados
  • baja la temperatura del termostato
  • configurar el modo calefacción
  • disminuye la temperatura de la cocina un poco
  • hace demasiado calor aquí
  • me ajustas a 25 grados el modo calor
  • me gustaría ajustar el termostato del salón a 25 grados con la calefacción
  • pon a 20 grados la temperatura
  • pon en modo calefacción el termostato de la cocina
  • pon la temperatura de la cocina a 20 grados
  • puedes subir un poco la temperatura en el salón
  • quiero bajar el nest 5 grados
  • quiero el modo aire acondicionado a 25 grados
  • quitar el modo frío del baño
  • sube 5 grados en la cocina
  • sube la calefacción
  • súbeme el termostato del salón un poquito
  • súbeme más la temperatura 10 grados

fr-FR

  • Allumer le mode chaud .
  • Mets en mode chaud .
  • Mets la température entre 21 et 23 degrés .
  • Mets la température à 17 degrés .
  • Mets le mode froid du thermostat à 19 degrés .
  • Mettre le mode froid à 19 degrés .
  • Mettre le thermostat entre 70 et 80 degrés .
  • Régler le mode chaud du thermostat à 22 degrés .
  • Régler le mode chaud à 22 degrés .
  • augmente la température de 2 degrés
  • augmente un peu la température dans la chambre
  • baisse la température de la chambre
  • baisse le thermostat
  • baisse un peu la température dans la cuisine
  • baisse un peu le thermostat
  • baisser le thermostat de 5 degrés
  • coupe le mode chaud
  • descends la température de 3 degrés
  • désactiver le mode frais du thermostat
  • mets le thermostat en mode frais
  • mets le thermostat à 10 degrés
  • mettre 2 degrés de moins dans la cuisine
  • monte la température de la chambre
  • monte la température de la salle de bain de 3 degrés
  • monte le thermostat
  • monte le thermostat de 2 degrés
  • monte un peu le thermostat
  • Éteins le mode chaud du thermostat .

hi-IN

  • thermostat का हीट 20 तक कर दो
  • कूलिंग को 70 डिग्री पर सेट करो
  • कूलिंग चालू करो
  • कूलिंग मोड को बंद कर दो
  • टेम्परेचर को 17 डिग्री पर सेट कर दो
  • तापमान 2 डिग्री कम करो
  • थर्मोस्टेट 70 डिग्री पर सेट करो
  • थर्मोस्टेट का टेम्प्रेचर ५ डिग्री घटाओ
  • थर्मोस्टेट का टेम्प्रेचर ५ डिग्री बढ़ाओ
  • थर्मोस्टेट का तापमान ज्यादा करो
  • थर्मोस्टेट को कूलिंग मोड में सेट करो
  • थर्मोस्टैट का कूलिंग मोड बंद करोगी
  • थर्मोस्टैट का तापमान ज़्यादा कर दो
  • थर्मोस्टैट के हीटिंग और कूलिंग मोड को 70 और 80 डिग्री के बीच रखें.
  • थर्मोस्टैट को कम कर दो
  • थारमोस्टेट का तापमान थोड़ा कम करें
  • थारमोस्टेट का तापमान थोड़ा बढ़ाओ
  • बेडरूम का टेंप्रेचर 5 डिग्री ज्यादा कर देना
  • बेडरूम का टेंप्रेचर थोड़ा कम कर देना
  • बेडरूम का टेंप्रेचर ज़्यादा कर देना
  • बेडरूम का तापमान थोड़ा ज़्यादा करो
  • मेरे लिए लिविंग रूम का तापमान कम करिये
  • सभी थर्मोस्टैट्स की कूलिंग को 70 डिग्री पर सेट कर दो
  • हीटिंग-कूलिंग मोड 30 और 40 डिग्री के बीच रखो।
  • हीटिंग-कूलिंग मोड पर सेट करो

it-IT

  • Alza di due gradi la temperatura della camera da letto
  • Imposta il termostato tra 20 e 25 gradi .
  • Metti la temperatura tra 15 e 20 gradi .
  • abbassa di 8 in cucina
  • abbassa la temperatura
  • abbassa la temperatura della caldaia
  • abbassa la temperatura della caldaia di 3 gradi
  • abbassa la temperatura di due gradi
  • abbassa leggermente la caldaia
  • alza il termostato
  • aumenta un po' la caldaia
  • disattiva la modalità eco
  • disattiva la modalità eco del riscaldamento della cucina
  • fai aumentare leggermente la temperatura
  • imposta il condizionatore su raffreddamento
  • metti il raffreddamento a 20 gradi
  • metti il termostato a 25
  • metti il termostato in modalità eco
  • metti la modalità condizionatore del termostato a 40 gradi
  • metti la modalità riscaldamento del termostato a 30 gradi
  • metti la temperatura un po' più bassa
  • puoi aumentare di 3 la caldaia
  • puoi mettere più caldo
  • setta 5 gradi più caldo
  • setta la temperatura su 20 gradi
  • voglio l'aria condizionata settata su eco

ja-JP

  • 2 度 暖かくして
  • 2 度 涼しくして
  • エアコン 冷房 の温度を 18 度 にして
  • エアコン 暖房 25 度 にして
  • キッチン 少し 涼しくして
  • キッチン を涼しくして
  • サーモスタット エコ モードを切って
  • サーモスタット の温度 28 度 にして
  • サーモスタット の温度を 10 度 下げて
  • サーモスタット の温度を 2 度 上げて
  • サーモスタット の温度を 20度から25度 にセット
  • サーモスタット の温度を ちょっと 上げて
  • サーモスタット の温度を下げて
  • サーモスタット の温度を高くして
  • サーモスタット の温度 少し 下げて
  • サーモスタット 冷房 に変えて
  • ヒートクール に変更して
  • ヒートクール モードを消して
  • リビング の温度 20 度 にしてください
  • リビング 少し 暖かくして
  • リビング を暖かくして
  • 冷房 モードで 20度 に設定して
  • 冷房 モードオン
  • 台所 の温度 5 度 上げて
  • 温度を 20度から25度 にして

ko-KR

  • 20도에서 30 도 사이로 온도 유지해
  • 거실 24 도로 맞춰 줘
  • 거실 온도 2 도 낮춰 줘
  • 거실 온도 내려 줘
  • 거실 온도 조금만 내려
  • 난방 20 도로 조정해 줘
  • 난방 모드로 바꿔 줘
  • 냉방 20 도로 조정해
  • 냉방 켜 줘
  • 안방 온도 더 올려 줘
  • 온도 2 도 높게 설정
  • 온도 2 도만 내려 줘
  • 온도 조절기 10 도 내려 줘
  • 온도 조절기 20 도로 설정해 줘
  • 온도 조절기 난방 꺼 줘
  • 온도 조절기 난방 모드로 변경해
  • 온도 조절기 낮춰 줘
  • 온도 조절기 온도 10 도 올려
  • 온도 조절기 온도 높여 줘
  • 온도 조절기 온도 조금 낮춰 줘
  • 온도 조절기 온도 조금만 올려
  • 온도 조절기 난방 온도 23 도로 맞춰 놔
  • 온도 조절기 냉방 23 도로 설정해
  • 온도 조절기 70도에서 80 도 사이로 맞춰
  • 침실 온도 2 도 높여 줘
  • 침실 온도 살짝 높여

nl-NL

  • De keuken wat afkoelen
  • De thermostaat op 20 graden zetten
  • Houd de temperatuur tussen 20 en 25 graden .
  • Keuken afkoelen
  • Maak het 2 graden koeler
  • Maak het 2 graden warmer
  • Stel warmtemodus op de thermostaat in op 24 graden
  • Zet afkoelen aan.
  • Zet de koeling op 24 graden .
  • Zet de thermostaat tussen 20 en 25 graden .
  • de keuken een beetje verwarmen
  • de thermostaat een beetje verhogen
  • de thermostaat een beetje verlagen
  • de thermostaat met 5 graden verlagen
  • de thermostaat verhogen
  • de thermostaat verlagen
  • verander naar afkoelen
  • verwarm de keuken
  • zet de koeling op de thermostaat op 16 graden
  • zet de koelstand op de thermostaat uit
  • zet de temperatuur op 25 graden
  • zet de thermostaat op afkoelen
  • zet de verwarmingsstand uit
  • zet warmtemodus op 20 graden

pt-BR

  • Ajustar a refrigeração do termostato para 23 graus
  • Ajustar a refrigeração para 23 graus
  • Ajuste o termostato para ficar entre 15 e 20 graus .
  • Aumentar a temperatura da cozinha .
  • Definir a temperatura como sendo entre 15 e 17 graus .
  • Definir a temperatura do termostato para 30 graus .
  • abaixar dois graus a temperatura
  • abaixar um pouco a temperatura do quarto
  • abaixe a temperatura do quarto
  • ajustar a temperatura do quarto para 20 graus
  • ajustar o aquecimento para 25 graus
  • ajustar o quente do termostato em 25 graus
  • ajustar o termostato para aquecer
  • aquecer a sala um pouco
  • aumenta a temperatura do termostato em 2 graus
  • aumentar a temperatura do termostato
  • aumentar bastante o termostato
  • aumentar três graus a temperatura
  • baixa a temperatura do termostato em 5 graus
  • colocar no frio
  • desativar o modo aquecimento do termostato
  • desativar o modo refrescar
  • diminuir cinco graus a temperatura do escritório
  • diminuir o termostato
  • quero diminuir um pouco o termostato

sv-SE

  • Dra upp temperaturen på termostaten
  • Dra upp temperaturen på termostaten lite grann
  • Höj värmen i vardagsrummet
  • Ställ in temperaturen på 20 till 25 grader tack.
  • Ställ in termostaten mellan 20 och 25 grader .
  • Ställ in värmen AC:n 23 grader
  • Sänk sovrummets temperatur
  • Sänk sovrums temperaturen lite grann
  • Sänk värmen i hallen med 2 grader
  • dra ner temperaturen med 2 grader
  • gör en temperatursänkning på termostaten med två grader
  • höj temperaturen 2 grader
  • höj värmen termostaten till 24 grader
  • jag vill att du höjer värmen elementen till 25 grader
  • kan du slå av uppvärmningen i vardagsrummet
  • kan du starta uppvärmning ?
  • kan du sätta på värmen ?
  • se till att höja tempen med två grader i sovrummet
  • ställ termostaten 3 grader varmare i köket
  • ställ termostaten uppvärmning
  • stäng av värmen termostaten
  • sänk temperaturen
  • sänk termostaten lite
  • sätt temperaturen på 25 grader
  • sätt termostaten 25 grader
  • vrid ner temperaturen i vardagsrummet med tre grader
  • öka värmen i arbetsrummet ordentligt

Device ERRORS

See the full list of errors and exceptions.