(PureBasic) Send GMail with Attachments

Demonstrates how to send an email containing attachments using the GMail REST API.

Chilkat PureBasic Module Download

Chilkat PureBasic Module

IncludeFile "CkHttpResponse.pb"
IncludeFile "CkHttp.pb"
IncludeFile "CkStringBuilder.pb"
IncludeFile "CkEmail.pb"

Procedure ChilkatExample()

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

    success.i

    ; Use the Chilkat Email API to create or load an email.
    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; The From name/address don't need to be specified. 
    ; GMail will automatically use your Gmail address if the following 2 lines are omitted.
    CkEmail::setCkFromName(email, "My Name")
    CkEmail::setCkFromAddress(email, "my_account_name@gmail.com")

    CkEmail::ckAddTo(email,"John Smith","somebody@somewhere.com")
    ; To add more recipients, make additional calls to AddTo or AddCC, one per recipient...

    CkEmail::setCkSubject(email, "This is a test GMail email created using Chilkat.")
    CkEmail::setCkCharset(email, "utf-8")
    CkEmail::ckAddPlainTextAlternativeBody(email,"This is a test")

    ; Create an HTML email body with an embedded image.
    cid.s = CkEmail::ckAddRelatedFile(email,"qa_data/jpg/starfish.jpg")
    sbHtml.i = CkStringBuilder::ckCreate()
    If sbHtml.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkStringBuilder::ckAppend(sbHtml,"<html><body>This is a <b>test</b><br><img src=" + Chr(34) + "cid:STARFISH_CID" + Chr(34) + "/></body></html>")
    numReplacements.i = CkStringBuilder::ckReplace(sbHtml,"STARFISH_CID",cid)

    CkEmail::ckAddHtmlAlternativeBody(email,CkStringBuilder::ckGetAsString(sbHtml))

    ; Add some attachments..
    mimeType.s = CkEmail::ckAddFileAttachment(email,"qa_data/helloWorld.pdf")
    If CkEmail::ckLastMethodSuccess(email) <> 1
        Debug "Failed to add PDF attachment."
        CkEmail::ckDispose(email)
        CkStringBuilder::ckDispose(sbHtml)
        ProcedureReturn
    EndIf

    mimeType = CkEmail::ckAddFileAttachment(email,"qa_data/msword/sample2.docx")
    If CkEmail::ckLastMethodSuccess(email) <> 1
        Debug "Failed to add MS-Word attachment."
        CkEmail::ckDispose(email)
        CkStringBuilder::ckDispose(sbHtml)
        ProcedureReturn
    EndIf

    ; OK.. we now have an HTML email with 2 attachments..
    sbMime.i = CkStringBuilder::ckCreate()
    If sbMime.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::ckGetMimeSb(email,sbMime)

    ; Send the email.  (GMail has a 5MB limit on the total email size.)
    http.i = CkHttp::ckCreate()
    If http.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkHttp::setCkAuthToken(http, "GMAIL-ACCESS-TOKEN")

    ; Send using the simple upload request for the Gmail API
    url.s = "https://www.googleapis.com/upload/gmail/v1/users/me/messages/send?uploadType=media"
    sendGzipped.i = 1
    resp.i = CkHttp::ckPTextSb(http,"POST",url,sbMime,"utf-8","message/rfc822",0,sendGzipped)
    If CkHttp::ckLastMethodSuccess(http) <> 1
        Debug CkHttp::ckLastErrorText(http)
        CkEmail::ckDispose(email)
        CkStringBuilder::ckDispose(sbHtml)
        CkStringBuilder::ckDispose(sbMime)
        CkHttp::ckDispose(http)
        ProcedureReturn
    EndIf

    ; A status code of 200 indicates success.
    Debug "Response status code: " + Str(CkHttpResponse::ckStatusCode(resp))
    Debug "Response body:"
    Debug CkHttpResponse::ckBodyStr(resp)
    CkHttpResponse::ckDispose(resp)

    ; The response body contains JSON.
    ; Use the online tool at Generate JSON Parsing Code
    ; to generate JSON parsing code.

    ; A sample successful JSON response:

    ; {
    ;  "id": "166f0d4ac39e50bf",
    ;  "threadId": "166f0d4ac39e50bf",
    ;  "labelIds": [
    ;   "SENT"
    ;  ]
    ; }


    CkEmail::ckDispose(email)
    CkStringBuilder::ckDispose(sbHtml)
    CkStringBuilder::ckDispose(sbMime)
    CkHttp::ckDispose(http)


    ProcedureReturn
EndProcedure