Sample code for 30+ languages & platforms
Ruby

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 Ruby Downloads

Ruby
require 'chilkat'

success = false

# 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 == false)
    print email.lastErrorText() + "\n";
    exit
end

# 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 == false)
    print http.lastErrorText() + "\n";
    exit
end

http.put_UncommonOptions("")

# A status code of 200 indicates success.
print "Response status code: " + resp.get_StatusCode().to_s() + "\n";
print "Response body:" + "\n";
print resp.bodyStr() + "\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. ----" + "\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 == false)
    print http.lastErrorText() + "\n";
    exit
end

# A status code of 200 indicates success.
print "Response status code: " + resp.get_StatusCode().to_s() + "\n";
print "Response body:" + "\n";
print resp.bodyStr() + "\n";

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

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