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

Send a Gmail message with a file attachment

See more GMail REST API Examples

Live send. Prepare a small file named attachment.pdf and replace the sample addresses. Add the file as a MIME attachment and upload the complete message as message/rfc822. The response is a Gmail Message. For larger uploads or unreliable connections, see Google’s resumable upload guidance.

Authorize the application with https://www.googleapis.com/auth/gmail.send. 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();
$email = chilkat::CkEmail->new();
#  Use the authorized mailbox or one of its configured send-as addresses.
$email->put_From('Sender <sender@example.com>');
$success = $email->AddTo("Recipient",'recipient@example.net');
if ($success != 1) {
    print $email->lastErrorText() . "\r\n";
    exit;
}

$email->put_Subject("Sample message");
$email->put_Charset("utf-8");
$email->put_Body("Hello from the Gmail API.");
$fileData = chilkat::CkBinData->new();
$success = $fileData->LoadFile("attachment.pdf");
if ($success != 1) {
    print "Could not read attachment.pdf." . "\r\n";
    exit;
}

$success = $email->AddAttachmentBd("attachment.pdf",$fileData,"application/pdf");
if ($success != 1) {
    print $email->lastErrorText() . "\r\n";
    exit;
}

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

$success = $http->HttpBd("POST","https://gmail.googleapis.com/upload/gmail/v1/users/me/messages/send?uploadType=media",$mime,"message/rfc822",$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("id") != 1) or ($reply->StringOfEquals("id","",1) == 1)) {
    print "Expected id in the response." . "\r\n";
    exit;
}

print "Gmail message ID: " . $reply->stringOf("id") . "\r\n";