Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.

Available Permissions

The following tables describe the access available when you're using the latest permission version. See the API reference for detailed permission information and field availability.

The different permission types are:

  • Read - View settings on the device.
  • Write - Change settings on the device.
  • Read/Write - Both view and change settings on the device.
  • Images Read (Camera only) - View your camera’s settings, show images or video when there is sound or motion, and share your video stream if it is public.
  • Images Read/Write (Camera only) - View and configure your camera’s settings, turn it on or off, show images or video when there is sound or motion, and share your video stream if it is public.

Thermostat

Permissions
Thermostat read Grants read permission to all Thermostat values
Thermostat read/write Grants read permission to all Thermostat values
Grants write permission to the following Thermostat values:
Grants read permission to all Structure data values
Energy read Grants read permission to Energy Rush Hour event start and end times

Camera

Permission
Camera read Grants read permission to all Camera data values except:
Camera read/write Grants the same read permission as Camera read
Grants write permission to is_streaming
Camera + Images read Grants read permission to all Camera data values
Camera + Images read/write Grants read permission to all Camera data values
Grants write permission to is_streaming

Smoke+CO Alarm

Permission
Smoke+CO Alarm read Grants read permission to all Smoke+CO alarm data values
Grants read permission to the following Structure data values:
  • Away state
  • Structure name, country code, and time zone
  • List of all devices in the structure

Security

Permission
Security State read Grants read permission to the Structure security state

Other Permissions

Permission
Away read Grants read permission to the following Structure data values:
  • Away state
  • Structure name, country code, and time zone
  • List of all devices in the structure
Away read/write Grants the same read permission as Away read
Grants write permission to Away state
ETA read Grants read permission to eta_begin
ETA write Grants write permission to eta
Grants read permission to the following Structure data values:
  • ETA
  • Away state
  • Structure name, country code, and time zone
  • List of all devices in the structure
Structure read/write Grants read/write permission to the Structure name
Postal code read Grants read permission to the Structure postal code