(DataFlex) Send GMail with BCC Recipients using REST API

See more GMail REST API Examples

Demonstrates how to send an email with BCC recipients using the GMail REST API.

Note: This example requires Chilkat v9.5.0.91 or greater.

Chilkat ActiveX Downloads

ActiveX for 32-bit and 64-bit Windows

Use ChilkatAx-win32.pkg

Procedure Test
    Boolean iSuccess
    Handle hoEmail
    String sCid
    Handle hoSbHtml
    Integer iNumReplacements
    Variant vSbMime
    Handle hoSbMime
    Variant vJson
    Handle hoJson
    Handle hoHttp
    String sUrl
    Variant vResp
    Handle hoResp
    String sTemp1
    Integer iTemp1
    Boolean bTemp1

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

    // Use the Chilkat Email API to create or load an email.
    Get Create (RefClass(cComChilkatEmail)) To hoEmail
    If (Not(IsComObjectCreated(hoEmail))) Begin
        Send CreateComObject of hoEmail
    End

    // The From name/address don't need to be specified. 
    // GMail will automatically use your Gmail address if the following 2 lines are omitted.
    Set ComFromName Of hoEmail To "My Name"
    Set ComFromAddress Of hoEmail To "my_account_name@gmail.com"

    Get ComAddTo Of hoEmail "John Smith" "somebody@somewhere.com" To iSuccess
    // To add more recipients, make additional calls to AddTo or AddCC, one per recipient...

    // -----------------------------------------------------------------------------------------
    // This section of this example demonstrates how to add BCC recipients.
    // 
    // Technically, an email should never contain a "Bcc" MIME header because it would
    // effectively nullify the purpose of BCC -- which means "Blind Carbon Copy".
    // Email recipients should not be able to see the BCC recipients.
    // Chilkat never adds a "Bcc" header field.
    // However.. in this case, the GMail REST server will look for the Bcc header field,
    // and will include those email addresses when sending, and also removes the Bcc header
    // from the email that is sent.
    // 
    // Starting in Chilkat v9.5.0.91, we can tell the email object to add the Bcc header
    // using the "UseBccHeader" UncommonOptions.  For example:
    Set ComUncommonOptions Of hoEmail To "UseBccHeader"
    Get ComAddBcc Of hoEmail "Joe" "joe@example.com" To iSuccess
    Get ComAddBcc Of hoEmail "Dave" "dave@example.com" To iSuccess
    // ...
    // -----------------------------------------------------------------------------------------

    Set ComSubject Of hoEmail To "This is a test GMail email created using Chilkat."
    Set ComCharset Of hoEmail To "utf-8"
    Get ComAddPlainTextAlternativeBody Of hoEmail "This is a test" To iSuccess

    // Create an HTML email body with an embedded image.
    Get ComAddRelatedFile Of hoEmail "qa_data/jpg/starfish.jpg" To sCid
    Get Create (RefClass(cComChilkatStringBuilder)) To hoSbHtml
    If (Not(IsComObjectCreated(hoSbHtml))) Begin
        Send CreateComObject of hoSbHtml
    End
    Get ComAppend Of hoSbHtml '<html><body>This is a <b>test</b><br><img src="cid:STARFISH_CID"/></body></html>' To iSuccess
    Get ComReplace Of hoSbHtml "STARFISH_CID" sCid To iNumReplacements

    Get ComGetAsString Of hoSbHtml To sTemp1
    Get ComAddHtmlAlternativeBody Of hoEmail sTemp1 To iSuccess

    // OK.. we now have an HTML email with an embedded JPG image
    // We'll need to get the full MIME of the email encoded to a base64url string.
    Get Create (RefClass(cComChilkatStringBuilder)) To hoSbMime
    If (Not(IsComObjectCreated(hoSbMime))) Begin
        Send CreateComObject of hoSbMime
    End
    Get pvComObject of hoSbMime to vSbMime
    Get ComGetMimeSb Of hoEmail vSbMime To iSuccess
    Get ComEncode Of hoSbMime "base64url" "utf-8" To iSuccess

    // The body of the HTTP request will be JSON..
    Get Create (RefClass(cComChilkatJsonObject)) To hoJson
    If (Not(IsComObjectCreated(hoJson))) Begin
        Send CreateComObject of hoJson
    End
    Get pvComObject of hoSbMime to vSbMime
    Get ComUpdateSb Of hoJson "raw" vSbMime To iSuccess

    // Send the email...
    Get Create (RefClass(cComChilkatHttp)) To hoHttp
    If (Not(IsComObjectCreated(hoHttp))) Begin
        Send CreateComObject of hoHttp
    End
    Set ComAuthToken Of hoHttp To "GMAIL-ACCESS-TOKEN"

    Move "https://www.googleapis.com/gmail/v1/users/me/messages/send" To sUrl
    Get pvComObject of hoJson to vJson
    Get ComPostJson3 Of hoHttp sUrl "application/json" vJson To vResp
    If (IsComObject(vResp)) Begin
        Get Create (RefClass(cComChilkatHttpResponse)) To hoResp
        Set pvComObject Of hoResp To vResp
    End
    Get ComLastMethodSuccess Of hoHttp To bTemp1
    If (bTemp1 <> True) Begin
        Get ComLastErrorText Of hoHttp To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // A status code of 200 indicates success.
    Get ComStatusCode Of hoResp To iTemp1
    Showln "Response status code: " iTemp1
    Showln "Response body:"
    Get ComBodyStr Of hoResp To sTemp1
    Showln sTemp1
    Send Destroy of hoResp

    // 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"
    //  ]
    // }


End_Procedure