Sample code for 30+ languages & platforms
CkPerl 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 CkPerl Downloads

CkPerl
use chilkat();

$success = 0;

#  Assumes Chilkat is unlocked. See Global Unlock Sample.

$token = chilkat::CkJsonObject->new();
$success = $token->LoadFile("gmail-token.json");
if ($success != 1) {
    print "Could not read gmail-token.json from the private working directory." . "\r\n";
    exit;
}

if (($token->JsonTypeOf("access_token") != 1) or ($token->StringOfEquals("access_token","",1) == 1)) {
    print "An OAuth access token is required." . "\r\n";
    exit;
}

$http = chilkat::CkHttp->new();
$http->put_RequireSslCertVerify(1);
$http->put_AuthToken($token->stringOf("access_token"));
$resp = chilkat::CkHttpResponse->new();
$reply = chilkat::CkJsonObject->new();
$url = chilkat::CkStringBuilder->new();
$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);
if ($resp->get_StatusCode() == 0) {
    print "Gmail did not return an HTTP response." . "\r\n";
    exit;
}

if (($success != 1) or ($resp->get_StatusCode() < 200) or ($resp->get_StatusCode() >= 300)) {
    print "Gmail HTTP " . $resp->get_StatusCode() . "\r\n";
    $success = $reply->Load($resp->bodyStr());
    if ($success == 1) {
        print $reply->stringOf("error.message") . "\r\n";
    }

    exit;
}

$success = $reply->Load($resp->bodyStr());
if ($success != 1) {
    print "Expected a Gmail JSON response." . "\r\n";
    exit;
}

if (($reply->JsonTypeOf("raw") != 1) or ($reply->StringOfEquals("raw","",1) == 1)) {
    print "Expected raw in the response." . "\r\n";
    exit;
}

$mime = chilkat::CkBinData->new();
$success = $reply->BytesOf("raw","base64url",$mime);
if ($success != 1) {
    print "Could not decode the raw MIME." . "\r\n";
    exit;
}

$success = $mime->WriteFile("downloaded.eml");
if ($success != 1) {
    print "Could not write downloaded.eml." . "\r\n";
    exit;
}

$email = chilkat::CkEmail->new();
$success = $email->SetFromMimeBd($mime);
if ($success != 1) {
    print $email->lastErrorText() . "\r\n";
    exit;
}

print "From: " . $email->ck_from() . "\r\n";
print "Subject: " . $email->subject() . "\r\n";
print "Attachments: " . $email->get_NumAttachments() . "\r\n";