Sample code for 30+ languages & platforms
Perl

Insert Email into GMail Folder

See more GMail REST API Examples

Directly inserts a message into only this user's mailbox similar to IMAP APPEND, bypassing most scanning and classification. Does not send a message.

This example will create a Chilkat Email object and upload/insert it into GMail. Then adds the "INBOX" label to the email to make it appear in INBOX

Chilkat Perl Downloads

Perl
use chilkat();

$success = 0;

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

$email = chilkat::CkEmail->new();

# This example chooses to load an email from a file.
$success = $email->LoadEml("qa_data/eml/testEmail.eml");
if ($success == 0) {
    print $email->lastErrorText() . "\r\n";
    exit;
}

# Get the email as MIME.
$sbMime = chilkat::CkStringBuilder->new();
$email->GetMimeSb($sbMime);

$http = chilkat::CkHttp->new();
$resp = chilkat::CkHttpResponse->new();

$http->put_AuthToken("GMAIL-ACCESS-TOKEN");

# Upload to GMail (does not send, but just inserts).

# IMPORTANT: After uploading/inserting, you won't see the message in the Inbox.
# In your web browser, if you go to "All Mail", you will see it.

$url = "https://www.googleapis.com/upload/gmail/v1/users/me/messages?uploadType=media";
$http->put_UncommonOptions("SendGzipped");
$success = $http->HttpSb("POST",$url,$sbMime,"utf-8","message/rfc822",$resp);
if ($success == 0) {
    print $http->lastErrorText() . "\r\n";
    exit;
}

$http->put_UncommonOptions("");

# A status code of 200 indicates success.
print "Response status code: " . $resp->get_StatusCode() . "\r\n";
print "Response body:" . "\r\n";
print $resp->bodyStr() . "\r\n";

# The response body contains JSON.
# A sample successful JSON response:

# {
#  "id": "166f583051d36144",
#  "threadId": "166f5529e079a456"
# }

$json = chilkat::CkJsonObject->new();
$json->Load($resp->bodyStr());
$id = $json->stringOf("id");

# Add the Inbox label to the inserted email so that it appears in Inbox.
print "---- Adding the Inbox label to the newly inserted email. ----" . "\r\n";

# Create the following JSON to be sent in a POST to modify labels for this message.
# {
#   "addLabelIds": [
#     "INBOX"
#     ]
# }

$json2 = chilkat::CkJsonObject->new();
$json2->UpdateString("addLabelIds[0]","INBOX");

$http->SetUrlVar("id",$id);
$url = "https://www.googleapis.com/gmail/v1/users/me/messages/{$id}/modify";

$success = $http->HttpJson("POST",$url,$json2,"application/json",$resp);
if ($success == 0) {
    print $http->lastErrorText() . "\r\n";
    exit;
}

# A status code of 200 indicates success.
print "Response status code: " . $resp->get_StatusCode() . "\r\n";
print "Response body:" . "\r\n";
print $resp->bodyStr() . "\r\n";

# The response body contains JSON.
# A sample successful JSON response:

# {
#  "id": "166f583051d36144",
#  "threadId": "166f583051d36144",
#  "labelIds": [
#   "INBOX"
#  ]
# }