Gmail IMAP: Workspace Service Account with a JSON Key
Use a service-account JSON key with Google Workspace domain-wide delegation. A Workspace administrator must authorize the service account's numeric OAuth client ID for https://mail.google.com/. Set SubEmailAddress to the Workspace user whose active Gmail mailbox is being accessed, and use that same address for IMAP login.
A service account has no Gmail mailbox of its own; leaving the impersonated user empty does not grant access to a personal Gmail account. The signed JWT exchange yields a short-lived token without a refresh token. Obtain another when needed, protect the private key, and keep the computer clock accurate.
This example lists visible folders and examines INBOX read-only. For the different visibility rules of the IMAP-only administrative scope, see gmail.imap_admin delegation.
See the Gmail SMTP, IMAP, and POP3 guide for current authentication choices and Gmail-specific examples.
Chilkat Unicode C Downloads
#include <C_CkJsonObjectW.h>
#include <C_CkAuthGoogleW.h>
#include <C_CkSocketW.h>
#include <C_CkImapW.h>
#include <C_CkMailboxesW.h>
void ChilkatSample(void)
{
BOOL success;
const wchar_t *mailbox;
HCkJsonObjectW key;
HCkAuthGoogleW auth;
HCkSocketW connection;
HCkImapW imap;
HCkMailboxesW folders;
int i;
success = FALSE;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
mailbox = L"user@example.com";
key = CkJsonObjectW_Create();
success = CkJsonObjectW_LoadFile(key,L"gmail-service-account.json");
if (success != TRUE) {
wprintf(L"Could not load the private service-account key.\n");
CkJsonObjectW_Dispose(key);
return;
}
if ((CkJsonObjectW_StringOfEquals(key,L"type",L"service_account",TRUE) != TRUE) || (CkJsonObjectW_JsonTypeOf(key,L"private_key") != 1)) {
wprintf(L"Expected a Google service-account JSON key.\n");
CkJsonObjectW_Dispose(key);
return;
}
auth = CkAuthGoogleW_Create();
CkAuthGoogleW_putJsonKey(auth,CkJsonObjectW_emit(key));
CkAuthGoogleW_putSubEmailAddress(auth,mailbox);
CkAuthGoogleW_putScope(auth,L"https://mail.google.com/");
CkAuthGoogleW_putExpireNumSeconds(auth,3600);
connection = CkSocketW_Create();
CkSocketW_putRequireSslCertVerify(connection,TRUE);
success = CkSocketW_Connect(connection,L"www.googleapis.com",443,TRUE,10000);
if (success != TRUE) {
wprintf(L"Could not establish the Google token connection.\n");
CkJsonObjectW_Dispose(key);
CkAuthGoogleW_Dispose(auth);
CkSocketW_Dispose(connection);
return;
}
success = CkAuthGoogleW_ObtainAccessToken(auth,connection);
CkSocketW_Close(connection,1000);
if (success != TRUE) {
wprintf(L"Check the key, domain-wide delegation client ID/scope, user, and computer clock.\n");
CkJsonObjectW_Dispose(key);
CkAuthGoogleW_Dispose(auth);
CkSocketW_Dispose(connection);
return;
}
imap = CkImapW_Create();
CkImapW_putSsl(imap,TRUE);
CkImapW_putPort(imap,993);
CkImapW_putRequireSslCertVerify(imap,TRUE);
CkImapW_putAuthMethod(imap,L"XOAUTH2");
success = CkImapW_Connect(imap,L"imap.gmail.com");
if (success != TRUE) {
wprintf(L"Could not establish the Gmail IMAP TLS connection.\n");
CkJsonObjectW_Dispose(key);
CkAuthGoogleW_Dispose(auth);
CkSocketW_Dispose(connection);
CkImapW_Dispose(imap);
return;
}
success = CkImapW_Login(imap,mailbox,CkAuthGoogleW_accessToken(auth));
if (success != TRUE) {
CkImapW_Disconnect(imap);
wprintf(L"IMAP authentication failed. Check the mailbox, scope, expiry, and account policy.\n");
CkJsonObjectW_Dispose(key);
CkAuthGoogleW_Dispose(auth);
CkSocketW_Dispose(connection);
CkImapW_Dispose(imap);
return;
}
folders = CkMailboxesW_Create();
success = CkImapW_MbxList(imap,FALSE,L"",L"*",folders);
if (success != TRUE) {
CkImapW_Logout(imap);
CkImapW_Disconnect(imap);
wprintf(L"Could not list Gmail folders.\n");
CkJsonObjectW_Dispose(key);
CkAuthGoogleW_Dispose(auth);
CkSocketW_Dispose(connection);
CkImapW_Dispose(imap);
CkMailboxesW_Dispose(folders);
return;
}
// List the labels visible through ordinary full-mail IMAP access.
i = 0;
while ((i < CkMailboxesW_getCount(folders))) {
wprintf(L"%s\n",CkMailboxesW_getName(folders,i));
i = i + 1;
}
success = CkImapW_ExamineMailbox(imap,L"INBOX");
if (success != TRUE) {
CkImapW_Logout(imap);
CkImapW_Disconnect(imap);
wprintf(L"Could not examine the impersonated user's INBOX.\n");
CkJsonObjectW_Dispose(key);
CkAuthGoogleW_Dispose(auth);
CkSocketW_Dispose(connection);
CkImapW_Dispose(imap);
CkMailboxesW_Dispose(folders);
return;
}
wprintf(L"INBOX messages: %d\n",CkImapW_getNumMessages(imap));
CkImapW_Logout(imap);
CkImapW_Disconnect(imap);
CkJsonObjectW_Dispose(key);
CkAuthGoogleW_Dispose(auth);
CkSocketW_Dispose(connection);
CkImapW_Dispose(imap);
CkMailboxesW_Dispose(folders);
}