Tcl

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

Tcl

load ./chilkat.dll

set success 0

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

set email [new_CkEmail]

# This example chooses to load an email from a file.
set success [CkEmail_LoadEml $email "qa_data/eml/testEmail.eml"]
if {$success == 0} then {
    puts [CkEmail_lastErrorText $email]
    delete_CkEmail $email
    exit
}

# Get the email as MIME.
set sbMime [new_CkStringBuilder]

CkEmail_GetMimeSb $email $sbMime

set http [new_CkHttp]

set resp [new_CkHttpResponse]

CkHttp_put_AuthToken $http "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.

set url "https://www.googleapis.com/upload/gmail/v1/users/me/messages?uploadType=media"
CkHttp_put_UncommonOptions $http "SendGzipped"
set success [CkHttp_HttpSb $http "POST" $url $sbMime "utf-8" "message/rfc822" $resp]
if {$success == 0} then {
    puts [CkHttp_lastErrorText $http]
    delete_CkEmail $email
    delete_CkStringBuilder $sbMime
    delete_CkHttp $http
    delete_CkHttpResponse $resp
    exit
}

CkHttp_put_UncommonOptions $http ""

# A status code of 200 indicates success.
puts "Response status code: [CkHttpResponse_get_StatusCode $resp]"
puts "Response body:"
puts [CkHttpResponse_bodyStr $resp]

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

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

set json [new_CkJsonObject]

CkJsonObject_Load $json [CkHttpResponse_bodyStr $resp]
set id [CkJsonObject_stringOf $json "id"]

# Add the Inbox label to the inserted email so that it appears in Inbox.
puts "---- Adding the Inbox label to the newly inserted email. ----"

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

set json2 [new_CkJsonObject]

CkJsonObject_UpdateString $json2 "addLabelIds[0]" "INBOX"

CkHttp_SetUrlVar $http "id" $id
set url "https://www.googleapis.com/gmail/v1/users/me/messages/{$id}/modify"

set success [CkHttp_HttpJson $http "POST" $url $json2 "application/json" $resp]
if {$success == 0} then {
    puts [CkHttp_lastErrorText $http]
    delete_CkEmail $email
    delete_CkStringBuilder $sbMime
    delete_CkHttp $http
    delete_CkHttpResponse $resp
    delete_CkJsonObject $json
    delete_CkJsonObject $json2
    exit
}

# A status code of 200 indicates success.
puts "Response status code: [CkHttpResponse_get_StatusCode $resp]"
puts "Response body:"
puts [CkHttpResponse_bodyStr $resp]

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

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

delete_CkEmail $email
delete_CkStringBuilder $sbMime
delete_CkHttp $http
delete_CkHttpResponse $resp
delete_CkJsonObject $json
delete_CkJsonObject $json2