Geavanceerde automatiseringen in huis maken met de scripteditor

Met de Google Home-app kun je je huis automatiseren met routines. Als je geavanceerde routines voor het huishouden wilt maken, kun je met de scripteditor gescripte automatiseringen programmeren met aanvullende starters, voorwaarden, acties en geavanceerde logica.

De scripteditor is op dit moment beschikbaar als Openbare preview. Je hebt toegang tot de scripteditor met Google Home voor het web of in de mobiele Google Home-app nadat je je hebt aangemeld voor Openbare preview.

Meer informatie over hoe je gescripte automatiseringen schrijft:

• Gescripte automatiseringen schrijven met de scripteditor
• Volledige lijst met ondersteunde starters, voorwaarden en acties
• Lijst met ondersteunde apparaten
• Ga naar ons codelab voor een stapsgewijs voorbeeld van hoe je je eerste script maakt.
• Er zijn ook aanvullende oefeningen voor het schrijven van een gescripte automatisering en voorbeeldscripts beschikbaar.

Naar codelab

Aan de slag

Met de scripteditor kun je je eigen routines voor het huishouden schrijven en bewerken met Google Home voor het web of in de Google Home-app.

Als je gescripte automatiseringen wilt maken, moet je:

• De basisbeginselen van YAML kennen, een door mensen leesbare scripttaal waarmee je regel voor regel instructies kunt invoeren om automatiseringen in huis te maken.
• Weten hoe routines werken, waaronder terminologie zoals starters en acties.
• Weten hoe je de scripteditor gebruikt om gescripte automatiseringen te schrijven.

Volg Gescripte automatiseringen schrijven met de scripteditor voor meer informatie over hoe je een script schrijft.

Opmerking: Op een iPhone of iPad kun je automatiseringen bekijken, bewerken, deactiveren en uitvoeren in de Google Home-app, maar je kunt op dit moment geen nieuwe gescripte automatiseringen maken. Als je een iPhone of iPad hebt, raden we je aan Google Home voor het web te gebruiken om nieuwe automatiseringen te maken.

Basisbeginselen van de scripteditor

De scripteditor gebruikt YAML, een scripttaal waarmee je regel voor regel instructies kunt invoeren om automatiseringen in huis te maken. Meer informatie over hoe je gescripte automatiseringen schrijft met de scripteditor

Snelle referentiehandleiding voor YAML

YAML-concepten	Voorbeeld
Sleutel/waarde-paren YAML wordt geschreven als een verzameling sleutel/waarde-paren die van elkaar worden gescheiden door een : en een spatie. Elk sleutel/waarde-paar begint op een nieuwe regel. Een sleutel is een letterlijk zoekwoord. De waarde die aan een sleutel is gekoppeld, kan zo simpel zijn als een tekenreeks, getal of datum, of zo complex als een andere verzameling sleutel/waarde-paren. In dit voorbeeld geldt het volgende: Sleutel = naam en Waarde = Tv aan lampen uit.	naam: Tv aan lampen uit
Inspringing en geneste sleutel/waarde-paren Je kunt meerdere sleutel/waarde-paren onder een bovenliggende sleutel 'nesten'. YAML gebruikt inspringingen (2 spaties) om de structuur en hiërarchie aan te geven en om geneste elementen te definiëren. Elk niveau van nesten wordt ingesprongen met hetzelfde aantal spaties. In het voorbeeld is de bovenliggende sleutel metadata. De waarde voor metadata bestaat uit 2 geneste sleutel/waarde-paren: Paar 1: Sleutel = naam; Waarde = Tv aan lampen uit Paar 2: Sleutel = beschrijving; Waarde = Lampen uitzetten als tv aangaat Elk paar wordt ingesprongen met 2 spaties om aan te geven dat het om een onderliggend item van de belangrijkste metadata gaat.	metadata: naame: Tv aan lampen uit beschrijving: Lampen uitzetten als tv aangaat
Meerdere waarden Als je met één sleutel meerdere waarden wilt opnemen, maak je een lijst. Gebruik een streepje vóór elk lijstitem. In het voorbeeld is de sleutel = weekdag en de waarde een lijst met Maandag en Donderdag.	weekdag: - MAANDAG - DONDERDAG
Opmerkingen Regels die beginnen met # zijn opmerkingen. Deze worden genegeerd door de automatiseringsengine.	# Dit is een opmerking. Deze wordt genegeerd.

Ondersteunde starters, voorwaarden en acties

Je definieert je automatiseringsgedrag met sleutels die starters, voorwaarden en acties worden genoemd:

• Starters vertellen je automatisering wanneer die moet beginnen. Starters kunnen specifieke tijden of apparaatstatussen bevatten. Een automatisering kan meer dan één starter bevatten.
• Voorwaarden zijn beperkingen voor wanneer je automatisering moet worden uitgevoerd. Elke keer dat een automatisering wordt gestart, worden de voorwaarden gecheckt. Je kunt bijvoorbeeld aangeven dat je automatisering alleen wordt uitgevoerd als je afwezig bent of na zonsondergang.
• Acties zijn wat je automatisering doet, zoals het volume van de speaker aanpassen of een lamp aan- of uitdoen.

Ga naar het Google Home-ontwikkelaarscentrum voor een volledige lijst met starters, voorwaarden en acties. Elk van deze componenten heeft een eigen set instructies en opmaak. Klik op een item in de tabel met ondersteunde starters, voorwaarden en acties voor specifieke instructies, hoe je deze opmaakt en een voorbeeldcode. Je kunt ook checken welke van je apparaten worden ondersteund en welke acties en opdrachten ze kunnen gebruiken.

Gescripte automatiseringen maken, bewerken en verwijderen

Gebruik de scripteditor in Google Home voor het web of de Google Home-app om aangepaste gescripte automatiseringen te schrijven en te bewerken.

Belangrijk: Alle leden van het huishouden kunnen checken wanneer deze routines worden uitgevoerd. Routines zijn alleen bedoeld voor gebruiksgemak en niet voor veiligheids- of beveiligingskritieke toepassingen. Maak geen routines die letsel of schade kunnen veroorzaken als ze niet kunnen worden gestart of gestopt. Routines kunnen afhankelijk zijn van een werkende internet- en wifi-verbinding en van de beschikbaarheid van de services van Google en de externe fabrikanten van de apparaten die voor de routines worden gebruikt. Routines werken misschien niet altijd en Google is niet verantwoordelijk voor eventuele schade of verliezen als gevolg van mislukte routines.

Een gescripte automatisering maken

Met de Google Home-app

1. Open de Google Home-app ..
2. Tik op Automatiseringen ..
3. Tik op Toevoegen Huishouden Meer opties Scripteditor.
4. Stel je nieuwe gescripte automatisering op. Neem Gescripte automatiseringen schrijven met de scripteditor door voor hulp bij het structureren van je script.
5. Tik op Valideren om te checken of je script wordt uitgevoerd. Je kunt een automatisering met fouten niet activeren.
6. Tik op Opslaan om je automatisering aan je huis toe te voegen of als werk in uitvoering op te slaan. Als je script geldig is wanneer je het opslaat, wordt je automatisering automatisch geactiveerd. Als je deze nog niet wilt laten uitvoeren, zet je Activeren uit.

Met Google Home voor het web

1. Open home.google.com/automations en log in op je account.
2. Click Add new.
3. Stel je nieuwe gescripte automatisering op. Neem Gescripte automatiseringen schrijven met de scripteditor door voor hulp bij het structureren van je script.
4. Click Validate to verify your script is able to run. You can't activate an automation with errors.
5. Click Save to add your automation to your home or save in-progress work. If your script is valid when you save it, your automation automatically activates. If you don't want it to run yet, turn Activate off.

Een gescripte automatisering bewerken

De meeste automatiseringen die je met de scripteditor hebt gemaakt, kun je bekijken en bewerken. Niet-gescripte automatiseringen en automatiseringen die actief worden uitgevoerd, kunnen niet worden bewerkt in de scripteditor. Nadat je een automatisering hebt gestopt, kun je deze bewerken.

Met de Google Home-app

1. Open de Google Home-app ..
2. Tik op Automatiseringen . de naam van je gescripte automatisering  Bewerken.
3. Bewerk je gescripte automatisering.
4. Tap Validate to verify your script is able to run. You can't activate an automation with errors.
5. Tap Save. If your script is valid when you save it, your automation automatically activates. If you don't want it to run yet, turn Activate off.

Zet je meestgebruikte apparaten, ruimtes, automatiseringen en acties vast in je favorieten  in de Google Home-app voor snelle en makkelijke toegang. Meer informatie over hoe je favorieten toevoegt en aanpast

Met Google Home voor het web

1. Open home.google.com/automations en log in op je account.
2. Selecteer je gescripte automatisering.
3. Bewerk je script.
4. Click Validate to verify your script is able to run. You can't activate an automation with errors.
5. Click Save to add your automation to your home or save in-progress work. If your script is valid when you save it, your automation automatically activates. If you don't want it to run yet, turn Activate off.

Een gescripte automatisering verwijderen

Belangrijk: Als je een routine of automatisering verwijdert, is dit definitief. Wil je een routine of automatisering tijdelijk stoppen, dan onderbreek je die.

Met de Google Home-app

1. Open de Google Home-app ..
2. Tik op Automatiseringen ..
3. Selecteer de routine die je wilt verwijderen.
4. Tik op Verwijderen Routine verwijderen.

Met Google Home voor het web

1. Open home.google.com/automations en log in op je account.
2. Klik op je gescripte automatisering .
3. Klik op Verwijderen Verwijderen.

Hulp bij gescripte automatiseringen

• Ga naar de Community voor Google Home-automatisering voor hulp met scripts en om te ontdekken waar anderen aan werken.
• Scripts moeten geldige code gebruiken, anders werken de automatiseringen niet. Als het script een fout bevat, verschijnt er een bericht. Meer informatie over validatiefouten en -waarschuwingen
• Klik of tik op Valideren in de scripteditor om je code te valideren. Hier volgen enkele veelvoorkomende fouten die zich kunnen voordoen:
  • Zorg dat je de juiste apparaatnaam gebruikt met de indeling Naam van apparaat - Naam van ruimte. Als je het niet zeker weet, check je de naam van je apparaat in de Google Home-app.
  • Zorg dat je apparaat de functie ondersteunt die je wilt laten uitvoeren. Je kunt ook automatisch aanvullen gebruiken om beschikbare opties te zoeken.
  • Zorg dat je een actie in het script opneemt. Acties zijn vereist om een automatisering uit te voeren.
• Als het script wordt opgeslagen maar de automatisering niet werkt zoals verwacht of niet meer werkt, check je handmatig of elke component in je script werkt. Als je bijvoorbeeld een script hebt geschreven om een lamp aan te doen en de helderheid bij zonsondergang te wijzigen, kun je deze taken uitvoeren met een Assistent-opdracht om na te gaan of elke afzonderlijke functie werkt. Je kunt ook het volgende checken:
  • Je apparaat is toegevoegd of gekoppeld in de Google Home-app.
  • Je apparaat is verbonden en online.
  • De apparaatnaam, starters, voorwaarden en acties zijn correct geschreven. Let op: Fabrikanten kunnen apparaatkenmerken wijzigen als ze updates uitvoeren. Dit kan ertoe leiden dat scripts niet meer werken. Je kunt automatisch aanvullen gebruiken om de betreffende scripts te updaten.
  • Je script heeft de juiste inspringing en opmaak.
• Met Google Home voor het web heb je toegang tot automatiseringslogboeken onder je script om de geschiedenis van je automatisering te bekijken en mogelijke problemen op te sporen. Meer informatie over de typen berichten die je in de automatiseringslogboeken ziet
• Gebruik de experimentele functie voor generatieve AI van de scripteditor om de gewenste automatisering te beschrijven. Er wordt dan een concept gemaakt van een script dat je kunt checken en bewerken.
• Meer informatie over de basisbeginselen van routines en hoe je problemen met routines oplost.
• Check Oefenen met het schrijven van je eerste script.