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

Inspect the MIME parts of a Gmail message

See more GMail REST API Examples

Supply a Gmail message ID and request format=full. Walk the root payload and every nested parts array, including a single-part root. For each part, show its MIME type, filename, and size. A body.attachmentId can be passed to the attachment download example. Inline body.data is already included as base64url.

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=full");
$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("payload") != 3) {
    print "Expected a MIME payload." . "\r\n";
    exit;
}

#  Queue paths into the original JSON document so any MIME nesting depth is supported.
$paths = chilkat::CkStringTable->new();
$success = $paths->Append("payload");
if ($success != 1) {
    print "Could not queue the root part." . "\r\n";
    exit;
}

$part = chilkat::CkJsonObject->new();
$childPath = chilkat::CkStringBuilder->new();
$p = 0;
while (($p < $paths->get_Count())) {
    $success = $reply->ObjectOf2($paths->stringAt($p),$part);
    if ($success != 1) {
        print "Could not read a MIME part." . "\r\n";
        exit;
    }

    print "Part: " . $part->stringOf("mimeType") . "  bytes: " . $part->IntOf("body.size") . "\r\n";
    if ($part->JsonTypeOf("filename") == 1) {
        if ($part->StringOfEquals("filename","",1) != 1) {
            print "Filename: " . $part->stringOf("filename") . "\r\n";
        }

    }

    if ($part->JsonTypeOf("body.attachmentId") == 1) {
        print "Attachment ID: " . $part->stringOf("body.attachmentId") . "\r\n";
    }
    else {
        if ($part->JsonTypeOf("body.data") == 1) {
            print "Body data is available in this part." . "\r\n";
        }

    }

    $j = 0;
    while (($j < $part->SizeOfArray("parts"))) {
        $childPath->SetString($paths->stringAt($p));
        $childPath->Append(".parts[");
        $childPath->AppendInt($j);
        $childPath->Append("]");
        $success = $paths->Append($childPath->getAsString());
        if ($success != 1) {
            print "Could not queue a child part." . "\r\n";
            exit;
        }

        $j = $j + 1;
    }

    $p = $p + 1;
}