Google Mail
Yhdistetty Google Mail (Gmail) -tili, jonka avulla automaatiot voivat lähettää siitä sähköpostia ja joka raportoi saapuneiden viestien laskurit vain luku -antureina - sama selainuudelleenohjaus-OAuth2-suostumusnäyttö kuin Google Drivella, omilla Google Cloud -sovellustunnistetiedoillasi.
Yhdistäminen
Laitteet ja palvelut > Google Mail > "+ Add account" tarvitsee Client ID:n ja Client
Secretin sovelluksesta, jonka luot itse Google Cloud Consolessa (Gmail API käytössä ja näytetty
Redirect URI lisättynä siihen), ja uudelleenohjaa sitten selaimesi Googlen omalle
suostumusnäytölle; sen hyväksyminen ohjaa takaisin Athenaan ja tallentaa tilin automaattisesti.
Athena pyytää vain suppean gmail.send-oikeuden (vain lähetysoikeus, ei muuta) ja
gmail.metadata-oikeuden (vain otsikot ja tunnisteet) - se ei koskaan pysty lukemaan
minkään olemassa olevan viestin sisältöä tai liitteitä.
Käytätkö Athenaa suoraan lähiverkon IP-osoitteen kautta (esim. https://192.168.1.50:8088)? Google ei hyväksy pelkkää IP-osoitetta uudelleenohjaus-URI:na - eikä myöskään paikallisia päätteitä kuten .local tai .home, koska se vaatii uudelleenohjaus-URI:n oman verkkotunnuksen päättyvän oikeaan ylätason verkkotunnukseen kuten .com tai .org. Tuon verkkotunnuksen ei koskaan tarvitse olla rekisteröity tai tavoitettavissa julkisessa internetissä - vain oman hosts-tiedostosi täytyy osata ratkaista se, ja vain omalle selaimellesi. Lisää hosts-tiedostoon rivi kuten 192.168.1.50 local.athena.com (käyttäen tämän palvelimen omaa IP-osoitetta ja mitä tahansa nimeä, kunhan se päättyy .com/.org-tyyliseen päätteeseen) - Athena on silloin tavoitettavissa osoitteessa https://local.athena.com:8088. Käytä sitä Redirect URI:na sekä täällä yhdistämislomakkeessa että sovelluksessa Google Cloud Consolessa. Hosts-tiedosto on /etc/hosts Linuxissa ja macOS:ssä (muokkaa sudo-oikeuksin), tai C:\Windows\System32\drivers\etc\hosts Windowsissa (muokkaa Muistiota pääkäyttäjänä).
Entiteetit
Tarkistetaan 2 minuutin välein: unread_count, total_messages ja
starred_count (kaikki koko postilaatikon viestilaskureita), sekä
latest_sender/latest_subject/latest_message_time
postilaatikon uusimmasta viestistä. Toimii
Ohjauspaneelin korttien,
Historian ja
Automaatioiden kanssa tarkalleen kuten mikä tahansa
muu integraatio - mitään ohjattavaa ei tässä ole, joten se ei näy Toiminto-solmun kohteena.
Sähköpostin lähetys automaatiosta
"Send Email" -toimintosolmu asettaa vastaanottajan, otsikon ja viestin. Viesti voi sisältää
kirjaimellisen paikkamerkin {value}, joka korvataan lähetyshetkellä sillä arvolla,
joka laukaisi automaation - kätevä minkä tahansa anturin muutoksen muuttamiseen
sähköposti-ilmoitukseksi.
Uudelleenyhdistäminen
Googlen oma refresh-tunnus voi lakata toimimasta - yleisimmin siksi, että yhdistetty sovellus on
yhä "Testing"-tilassa Google Cloud Consolessa, jolloin Google vanhentaa refresh-tunnukset noin
viikossa. Silloin tilin omalle sivulle ilmestyy "Reconnect"-painike (ajaa suostumusnäytön
uudelleen menettämättä historiaa), ilmoitus ohjaa suoraan siihen, ja
needs_reconnect-anturi on käytettävissä, jos haluat rakentaa oman automaation sen
ympärille (esim. push-ilmoituksen ntfy:n kautta).
Google Cast, Google Drive, Google Kalenteri ja Google Mail jakavat saman "Google"-kohdan uutta integraatiota valittaessa Laitteista ja palveluista, koska kaikki neljä yhdistyvät saman tilin perheeseen - kun mikä tahansa on asetettu, jokainen saa silti oman erillisen korttinsa.