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

Gmail SMTP: Workspace Service Account with a JSON Key

See more GMail SMTP/IMAP/POP Examples

Obtain a short-lived OAuth2 token for a Google Workspace user's mailbox, then send email using Gmail SMTP. This requires a Workspace administrator to authorize the service account's numeric OAuth client ID for https://mail.google.com/ in domain-wide delegation. Enable domain-wide delegation for the service account and impersonate a user with an active Gmail mailbox.

This is a signed JWT bearer grant with user impersonation, not an OAuth client-credentials grant. A service account has no Gmail mailbox of its own. This approach does not provide delegated access to personal @gmail.com accounts. Protect the private key and restrict who can run the application; anyone with this key can exercise its delegated privileges.

Set SubEmailAddress and the SMTP username to the same Workspace mailbox. Keep the computer clock accurate. The token lasts at most one hour and has no refresh token: obtain a new delegated token when needed. Gmail's normal sending limits still apply; delegation does not permit unlimited sending.

Send an email through smtp.gmail.com:587 with STARTTLS and an OAuth2 access token. Chilkat constructs the SASL XOAUTH2 authentication exchange; do not put the access token in SmtpPassword. Port 465 with implicit TLS is an alternative.

This example sends a real email. Set the mailbox to the account that authorized the token and use a recipient you control. The From address is that mailbox; another address must be an authorized Gmail send-as identity. Gmail normally saves SMTP submissions in Sent, so do not automatically append another copy through IMAP.

SMTP acceptance does not prove inbox delivery. Account sending limits, recipient limits, spam filtering, and Workspace policies still apply. A connection failure after message data was transmitted can leave the result uncertain; blind retries can create duplicate mail. Authentication/session logs can contain credentials and message data.

Google documentation

Chilkat DataFlex Downloads

DataFlex
Use ChilkatAx-win32.pkg

Procedure Test
    Boolean iSuccess
    Handle hoKey
    Handle hoAuth
    String sMailbox
    Variant vConnection
    Handle hoConnection
    Handle hoMailman
    Variant vEmail
    Handle hoEmail
    String sTemp1
    Integer iTemp1
    Integer iTemp2
    Boolean bTemp1

    Move False To iSuccess

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

    Get Create (RefClass(cComChilkatJsonObject)) To hoKey
    If (Not(IsComObjectCreated(hoKey))) Begin
        Send CreateComObject of hoKey
    End
    Get ComLoadFile Of hoKey "gmail-service-account.json" To iSuccess
    If (iSuccess <> True) Begin
        Showln "Could not read the service-account JSON key from the private working directory."
        Procedure_Return
    End

    Get ComStringOfEquals Of hoKey "type" "service_account" True To bTemp1
    Get ComJsonTypeOf Of hoKey "private_key" To iTemp1
    Get ComJsonTypeOf Of hoKey "client_email" To iTemp2
    If ((bTemp1 <> True) Or (iTemp1 <> 1) Or (iTemp2 <> 1)) Begin
        Showln "Expected a Google service-account JSON key, not an OAuth desktop client file."
        Procedure_Return
    End

    Get Create (RefClass(cComChilkatAuthGoogle)) To hoAuth
    If (Not(IsComObjectCreated(hoAuth))) Begin
        Send CreateComObject of hoAuth
    End
    Get ComEmit Of hoKey To sTemp1
    Set ComJsonKey Of hoAuth To sTemp1
    Move "user@example.com" To sMailbox
    Set ComScope Of hoAuth To "https://mail.google.com/"
    Set ComSubEmailAddress Of hoAuth To sMailbox
    Set ComExpireNumSeconds Of hoAuth To 3600

    //  AuthGoogle performs its Google token exchange over this TLS connection.
    Get Create (RefClass(cComChilkatSocket)) To hoConnection
    If (Not(IsComObjectCreated(hoConnection))) Begin
        Send CreateComObject of hoConnection
    End
    Set ComRequireSslCertVerify Of hoConnection To True
    Get ComConnect Of hoConnection "www.googleapis.com" 443 True 10000 To iSuccess
    If (iSuccess <> True) Begin
        Showln "Could not establish the Google token connection."
        Procedure_Return
    End

    Get pvComObject of hoConnection to vConnection
    Get ComObtainAccessToken Of hoAuth vConnection To iSuccess
    Get ComClose Of hoConnection 1000 To iSuccess
    If (iSuccess <> True) Begin
        Showln "Token exchange failed. Check the key, delegated scope, user, and computer clock."
        Procedure_Return
    End

    //  Keep the token in memory. Never print tokens or private keys.
    Get Create (RefClass(cComChilkatMailMan)) To hoMailman
    If (Not(IsComObjectCreated(hoMailman))) Begin
        Send CreateComObject of hoMailman
    End
    Set ComSmtpHost Of hoMailman To "smtp.gmail.com"
    Set ComSmtpPort Of hoMailman To 587
    Set ComSmtpSsl Of hoMailman To False
    Set ComStartTLS Of hoMailman To True
    Set ComRequireSslCertVerify Of hoMailman To True
    //  Alternative: port 465 with SmtpSsl=true and StartTLS=false (implicit TLS).
    Set ComSmtpUsername Of hoMailman To sMailbox
    Set ComSmtpPassword Of hoMailman To ""
    Get ComAccessToken Of hoAuth To sTemp1
    Set ComOAuth2AccessToken Of hoMailman To sTemp1

    Get Create (RefClass(cComChilkatEmail)) To hoEmail
    If (Not(IsComObjectCreated(hoEmail))) Begin
        Send CreateComObject of hoEmail
    End
    Set ComFrom Of hoEmail To sMailbox
    Set ComSubject Of hoEmail To "Sample message"
    Set ComBody Of hoEmail To "This message was sent through Gmail SMTP using OAuth2."
    Get ComAddTo Of hoEmail "Recipient" "recipient@example.net" To iSuccess
    If (iSuccess <> True) Begin
        Showln "Could not add the recipient."
        Procedure_Return
    End

    //  This sends a real message. Replace the recipient with an address you control.
    Get pvComObject of hoEmail to vEmail
    Get ComSendEmail Of hoMailman vEmail To iSuccess
    If (iSuccess <> True) Begin
        Get ComCloseSmtpConnection Of hoMailman To iSuccess
        Showln "SMTP send failed. Check the token, mailbox, recipient, and Gmail sending limits."
        //  Inspect LastErrorText privately if needed; do not publish authentication/session logs.
        //  A lost connection after DATA can leave acceptance uncertain. Avoid blindly retrying.
        Procedure_Return
    End

    Get ComCloseSmtpConnection Of hoMailman To iSuccess
    If (iSuccess <> True) Begin
        Showln "Gmail accepted the message, but closing the connection failed. Do not resend it."
        Procedure_Return
    End

    Showln "Gmail accepted the message for delivery."


End_Procedure