Search code examples
gmailgmail-api

How to access a gmail account I own using Gmail API?


I want to run a node script as a cronjob which uses Gmail's API to poll a gmail account I own.

I am following these quickstart instructions:

quickstart

I'm stuck on the first step. When requesting credentials for a cron script it tells me that "User data cannot be accessed from a platform without a UI because it requires user interaction for sign-in":

enter image description here

The docs are confusing in general, and mention "service accounts," "OAuth," and other things -- I cannot tell which apply to my use-case and which don't. I've used many SaaS APIs, and the typical workflow is to login to your account, get an API key and secret, and use those in your script to access the API. It seems this is not the paradigm used by the Gmail API, so I'd appreciate any guidance or links to clearer instructions.


Solution

  • I also find that the documentation can be confusing at times, but what you want to to is actually pretty straight forward once you get it:

    1. Register your App at Google, and say what APIs you want your App to have access to (only the Gmail API in this case). This will give you two strings, a client_id and a client_secret (which is the content of the client_secrets.json-file above).
    2. Since you are just going to write a script for your own account only, you don't need a http-server. The Oauth Playground will suffice. Press the Settings Cog on the top right and use your own OAuth credentials.
    3. Select the Gmail API in the list of APIs and follow the outlined steps.

    Now you have an access_token and a refresh_token you can use to keep your script going indefinitely!