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

PowerShell
Add-Type -Path "C:\chilkat\ChilkatDotNet47-x64\ChilkatDotNet47.dll"

$success = $false

#  Assumes Chilkat is unlocked. See Global Unlock Sample.

$token = New-Object Chilkat.JsonObject
$success = $token.LoadFile("gmail-token.json")
if ($success -ne $true) {
    $("Could not read gmail-token.json from the private working directory.")
    exit
}

if (($token.JsonTypeOf("access_token") -ne 1) -or ($token.StringOfEquals("access_token","",$true) -eq $true)) {
    $("An OAuth access token is required.")
    exit
}

$http = New-Object Chilkat.Http
$http.RequireSslCertVerify = $true
$http.AuthToken = $token.StringOf("access_token")
$resp = New-Object Chilkat.HttpResponse
$reply = New-Object Chilkat.JsonObject
$url = New-Object Chilkat.StringBuilder
$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.StatusCode -eq 0) {
    $("Gmail did not return an HTTP response.")
    exit
}

if (($success -ne $true) -or ($resp.StatusCode -lt 200) -or ($resp.StatusCode -ge 300)) {
    $("Gmail HTTP " + $resp.StatusCode)
    $success = $reply.Load($resp.BodyStr)
    if ($success -eq $true) {
        $($reply.StringOf("error.message"))
    }

    exit
}

$success = $reply.Load($resp.BodyStr)
if ($success -ne $true) {
    $("Expected a Gmail JSON response.")
    exit
}

if (($reply.JsonTypeOf("raw") -ne 1) -or ($reply.StringOfEquals("raw","",$true) -eq $true)) {
    $("Expected raw in the response.")
    exit
}

$mime = New-Object Chilkat.BinData
$success = $reply.BytesOf("raw","base64url",$mime)
if ($success -ne $true) {
    $("Could not decode the raw MIME.")
    exit
}

$success = $mime.WriteFile("downloaded.eml")
if ($success -ne $true) {
    $("Could not write downloaded.eml.")
    exit
}

$email = New-Object Chilkat.Email
$success = $email.SetFromMimeBd($mime)
if ($success -ne $true) {
    $($email.LastErrorText)
    exit
}

$("From: " + $email.From)
$("Subject: " + $email.Subject)
$("Attachments: " + $email.NumAttachments)