Gmail IMAP: Refresh an OAuth2 Token
See more GMail SMTP/IMAP/POP Examples
Refresh a Gmail access token without opening a browser. Use the same OAuth client and the offline refresh token saved during initial authorization. A refreshed token can authenticate SMTP, IMAP, or POP3 for the authorized mailbox.
Google normally does not return another refresh token. The example retains the saved refresh token when omitted, accepts a replacement when provided, preserves the granted scope when omitted, and records the new access token's issue time and lifetime. A failed exchange leaves the old cache untouched. File writes are checked; production applications should use protected storage and serialize/atomically commit updates.
Access tokens normally last about an hour. Refresh ahead of expiry and reconnect long-lived protocol sessions when necessary. Refresh does not add scopes or restore a revoked grant. An invalid_grant response can require fresh user authorization; do not retry it indefinitely. External apps in Testing normally receive seven-day refresh tokens for this scope.
Gmail SMTP, IMAP, and POP3 use the https://mail.google.com/ OAuth scope. Narrower Gmail REST scopes such as gmail.send or gmail.readonly do not authorize these protocols. Public applications using this restricted scope must meet Google's verification requirements. See Gmail OAuth scopes and XOAUTH2.
Chilkat AutoIt Downloads
Local $bSuccess = False
; Assumes Chilkat is unlocked. See Global Unlock Sample.
$oToken = ObjCreate("Chilkat.JsonObject")
$bSuccess = $oToken.LoadFile("gmail-mail-token.json")
If ($bSuccess <> True) Then
ConsoleWrite("Could not read gmail-mail-token.json from the private working directory." & @CRLF)
Exit
EndIf
If (($oToken.JsonTypeOf("refresh_token") <> 1) Or ($oToken.StringOfEquals("refresh_token","",True) = True)) Then
ConsoleWrite("Authorize the account for offline access first." & @CRLF)
Exit
EndIf
$oOauth = ObjCreate("Chilkat.OAuth2")
$oOauth.TokenEndpoint = "https://oauth2.googleapis.com/token"
$oOauth.ClientId = "YOUR_DESKTOP_CLIENT_ID"
$oOauth.ClientSecret = "YOUR_DESKTOP_CLIENT_SECRET"
$oOauth.RefreshToken = $oToken.StringOf("refresh_token")
$bSuccess = $oOauth.RefreshAccessToken()
If ($bSuccess <> True) Then
ConsoleWrite("Refresh failed. Check the OAuth client and grant. A revoked or expired grant requires fresh consent." & @CRLF)
Exit
EndIf
$oFresh = ObjCreate("Chilkat.JsonObject")
$bSuccess = $oFresh.Load($oOauth.AccessTokenResponse)
If ($bSuccess <> True) Then
ConsoleWrite("Could not parse the refresh response." & @CRLF)
Exit
EndIf
If (($oFresh.JsonTypeOf("access_token") <> 1) Or ($oFresh.StringOfEquals("access_token","",True) = True)) Then
ConsoleWrite("The refresh response did not contain an access token." & @CRLF)
Exit
EndIf
If (($oFresh.JsonTypeOf("refresh_token") <> 1) Or ($oFresh.StringOfEquals("refresh_token","",True) = True)) Then
$oFresh.UpdateString("refresh_token",$oToken.StringOf("refresh_token"))
EndIf
If (($oFresh.HasMember("scope") <> True) And ($oToken.JsonTypeOf("scope") = 1)) Then
$oFresh.UpdateString("scope",$oToken.StringOf("scope"))
EndIf
; Google normally omits refresh_token on refresh. Keep the previous one in that case.
; Use the new expires_in, not the old response's expiration information.
$oObtained = ObjCreate("Chilkat.CkDateTime")
$oObtained.SetFromCurrentSystemTime()
$oFresh.UpdateString("obtained_at",$oObtained.GetAsTimestamp(False))
$bSuccess = $oFresh.WriteFile("gmail-mail-token.json")
If ($bSuccess <> True) Then
ConsoleWrite("Could not save the refreshed credentials." & @CRLF)
Exit
EndIf
ConsoleWrite("Refreshed the access token." & @CRLF)