Google’s Gmail API giver fleksibel, RESTful adgang til at læse og sende meddelelser, administrer udkast og vedhæftede filer, søge tråde og meddelelser, opsæt push push-notifications og administrere andre Gmail indstillinger. I det følgende vises hvorledes der genereres de nødvendige nøgler og hvorledes de kan anvendes for at sende emails direkte fra javascript. Der forudsættes ikke andet end en eksisterende Gmail-konto.
- Først skal apllikationen registreres for Gmail APIøen i Google API Console. Gå til Google’s Wizard og opret et projekt
Gmail API er nu aktiveret.Klik ”Continue” og Herefter ”Go to Credentials”.
- Vælg “Gmail API”, “Webbrowser (Javascript)” og ”User Data” Klik på ”What Credentials do I need”
- Fra popup’en vælg “Setup Consent Screen”:
- Giv applikationen et navn og udfyld øvrige felter efter behag og Gem.
- Klik på ”Create Credentials” og vælg først ”Api Key” fra DropDown menuen:
- Api nøglen er nu dannet. Fra popup’en vælg enten ”Close” eller ”Restrict key” for at give Api’nøglen er fornuftigt navn f.eks ”Development Apikey”. Restriktioner på hvorfra API’en kan kaldes i Applikationen kan sættes senere eller vælg f.eks. ”http referers (Web sites)” og tilføj under ”website restrictions” “http://localhost” med den port som dev-serveren anvender, f.eks. “https://localhost:5500”.
- Vælg igen ”Create Credentials” og denne gang ”oAuth Client ID” fra dropdown-menuen:
- Under application type” vælg ”Web application”. Giv Webclient-nøglen et genkendeligt navn f.eks. ”Development Client ID”. Under Authorized Javascript origins angiv foreløbig ”http://localhost” med den port, som den lokale dev-server anvender, f.eks.: ”https://localhost:5500”. Klik på ”Create”. Der kan IKKE anvendes IP-adresser, f.eks. “127.0.0.1”:
- Der er nu også blevet dannet et oAuth Client ID:
- Både API-nøglen og oAuth Client ID skal anvendes ved kald til Gmail API’en. De kan altid tilgås fra Dashboardet.