Sample code for 30+ languages & platforms
JavaScript Requires Chilkat v11.0.0+

Authorize a desktop application to use Gmail

See more GMail REST API Examples

Enable the Gmail API, configure the OAuth consent screen, and create a Desktop app OAuth client. Launch the system browser and receive the authorization code on a loopback listener. The sample requests read-only access with PKCE and offline access. For another operation, select the scope in that example before authorizing. Gmail scopes.

Run in a private, user-only directory. The file contains bearer credentials. In a deployed application use protected credential storage. To reuse an existing grant, copy the older examples’ qa_data/tokens/gmail.json to gmail-token.json in this private directory. The token retains its original scopes. Gmail clients using IMAP, POP, or SMTP with OAuth need the https://mail.google.com/ scope. Use a separate cache for each user and client.

Google documentation

Note
This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.
JavaScript
var success = false;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.

var oauth = new CkOAuth2();
oauth.TokenEndpoint = "https://oauth2.googleapis.com/token";
oauth.ClientId = "YOUR_DESKTOP_CLIENT_ID";
oauth.ClientSecret = "YOUR_DESKTOP_CLIENT_SECRET";

oauth.AuthorizationEndpoint = "https://accounts.google.com/o/oauth2/v2/auth";
oauth.LocalHost = "127.0.0.1";
oauth.ListenPort = 55568;
oauth.ListenPortRangeEnd = 55578;
oauth.CodeChallenge = true;
oauth.CodeChallengeMethod = "S256";
oauth.Scope = "https://www.googleapis.com/auth/gmail.readonly";
success = oauth.AddAuthQueryParam("access_type","offline");
if (success !== true) {
    console.log("Could not configure offline access.");
    return;
}

//  This is the interactive setup step. Subsequent refreshes use the saved refresh token.
success = oauth.AddAuthQueryParam("prompt","consent");
if (success !== true) {
    console.log("Could not configure consent.");
    return;
}

var authUrl = oauth.StartAuth();
if (oauth.LastMethodSuccess !== true) {
    console.log("Could not start the loopback listener.");
    return;
}

success = oauth.LaunchBrowser(authUrl);
if (success !== true) {
    oauth.Cancel();
    console.log("Could not open the system browser.");
    return;
}

var waited = 0;
while (((oauth.AuthFlowState < 3) && (waited < 180000))) {
    oauth.SleepMs(200);
    waited = waited+200;
}

if (oauth.AuthFlowState < 3) {
    oauth.Cancel();
    console.log("Authorization timed out.");
    return;
}

if (oauth.AuthFlowState !== 3) {
    console.log("Authorization did not complete. Flow state: " + oauth.AuthFlowState);
    return;
}

var token = new CkJsonObject();
success = token.Load(oauth.AccessTokenResponse);
if (success !== true) {
    console.log("Could not parse the token response.");
    return;
}

if ((token.JsonTypeOf("refresh_token") !== 1) || (token.StringOfEquals("refresh_token","",true) == true)) {
    console.log("No offline refresh token was issued. The existing cache was preserved.");
    return;
}

success = token.WriteFile("gmail-token.json");
if (success !== true) {
    console.log("Could not save the token file.");
    return;
}

console.log("Credentials saved in the private working directory.");