Script
    
    
       
    
    
      
      Stay organized with collections
     
    
      
      Save and categorize content based on your preferences.
     
    
  
      
     
  
  
  
   
  
  
    
    
   
   
   
Description 
The top-level script.
Fields 
Key
 
Type
 
Description
 
 
metadata
 
Metadata 
 
Provides the metadata of the script, like name and description.
Required
 
 
automations
 
[Automation ]
 
Specifies a list of automations.
Required
 
 
Examples 
Simple script to control a light with a switch
metadata : 
   name :   Turn on light with switch 
   description :   Basic example of turning on a light with another switch. 
automations : 
   starters : 
     type :   device.state.OnOff 
     device :   Office Switch - Office 
     state :   on 
     is :   true 
   actions : 
   -   type :   device.command.OnOff 
     devices : 
     -   Christmas lights - Living Room 
     on :   true 
 
 
  
  
 
  
    
    
    
  
  
 
  Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
  Last updated 2025-10-30 UTC.
 
 
  
  
  
    
      [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Incorrect information","incorrectInformation","thumb-down"],["Not enough information/samples","notEnoughInformationSamples","thumb-down"],["Too complicated","tooComplicated","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-10-30 UTC."],[],[]]