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

Download the original Gmail message as EML

See more GMail REST API Examples

Supply a Gmail message ID and request format=raw. Decode the complete MIME message directly to bytes and save them in downloaded.eml. Parse those same bytes with Chilkat.Email to read the subject, sender, and attachment count without a text-encoding round trip.

Authorize the application with https://www.googleapis.com/auth/gmail.readonly. The example reads the access token from gmail-token.json in a private working directory. Authorize a desktop application.

Google documentation

Chilkat Delphi ActiveX Downloads

Delphi ActiveX
var
success: Integer;
token: TChilkatJsonObject;
http: TChilkatHttp;
resp: TChilkatHttpResponse;
reply: TChilkatJsonObject;
url: TChilkatStringBuilder;
mime: TChilkatBinData;
email: TChilkatEmail;

begin
success := 0;

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

token := TChilkatJsonObject.Create(Self);
success := token.LoadFile('gmail-token.json');
if (success <> 1) then
  begin
    Memo1.Lines.Add('Could not read gmail-token.json from the private working directory.');
    Exit;
  end;
if ((token.JsonTypeOf('access_token') <> 1) or (token.StringOfEquals('access_token','',1) = 1)) then
  begin
    Memo1.Lines.Add('An OAuth access token is required.');
    Exit;
  end;
http := TChilkatHttp.Create(Self);
http.RequireSslCertVerify := 1;
http.AuthToken := token.StringOf('access_token');
resp := TChilkatHttpResponse.Create(Self);
reply := TChilkatJsonObject.Create(Self);
url := TChilkatStringBuilder.Create(Self);
url.Append('https://gmail.googleapis.com/gmail/v1/users/me/messages/');
url.Append('GMAIL_MESSAGE_ID');
url.Append('?format=raw');
success := http.HttpNoBody('GET',url.GetAsString(),resp.ControlInterface);
if (resp.StatusCode = 0) then
  begin
    Memo1.Lines.Add('Gmail did not return an HTTP response.');
    Exit;
  end;
if ((success <> 1) or (resp.StatusCode < 200) or (resp.StatusCode >= 300)) then
  begin
    Memo1.Lines.Add('Gmail HTTP ' + IntToStr(resp.StatusCode));
    success := reply.Load(resp.BodyStr);
    if (success = 1) then
      begin
        Memo1.Lines.Add(reply.StringOf('error.message'));
      end;
    Exit;
  end;
success := reply.Load(resp.BodyStr);
if (success <> 1) then
  begin
    Memo1.Lines.Add('Expected a Gmail JSON response.');
    Exit;
  end;
if ((reply.JsonTypeOf('raw') <> 1) or (reply.StringOfEquals('raw','',1) = 1)) then
  begin
    Memo1.Lines.Add('Expected raw in the response.');
    Exit;
  end;
mime := TChilkatBinData.Create(Self);
success := reply.BytesOf('raw','base64url',mime.ControlInterface);
if (success <> 1) then
  begin
    Memo1.Lines.Add('Could not decode the raw MIME.');
    Exit;
  end;
success := mime.WriteFile('downloaded.eml');
if (success <> 1) then
  begin
    Memo1.Lines.Add('Could not write downloaded.eml.');
    Exit;
  end;
email := TChilkatEmail.Create(Self);
success := email.SetFromMimeBd(mime.ControlInterface);
if (success <> 1) then
  begin
    Memo1.Lines.Add(email.LastErrorText);
    Exit;
  end;
Memo1.Lines.Add('From: ' + email.From);
Memo1.Lines.Add('Subject: ' + email.Subject);
Memo1.Lines.Add('Attachments: ' + IntToStr(email.NumAttachments));