Library . Google . Gmailv2 . Messages . GetLatestMessage

Retrieves the latest email from a user's inbox.

Input
• ClientID The Client ID provided by Google. Required unless providing a valid AccessToken.
• ClientSecret The Client Secret provided by Google. Required unless providing a valid AccessToken.
• RefreshToken An OAuth Refresh Token used to generate a new Access Token when the original token is expired. Required unless providing a valid AccessToken.
Optional Input
• AccessToken A valid Access Token retrieved during the OAuth2 process. This is required unless you provide the ClientID, ClientSecret, and RefreshToken to generate a new Access Token.
• EncodeMessage When set to "true" (the default), the message Body will be Base64 encoded.
• IncludeSpamTrash Set to "true" to include messages from SPAM and TRASH in the results. Defaults to "false".
• LabelID Returns messages with a label matching this ID.
• StartHistoryID Returns history records after the specified marker. The history ID is returned by this Choreo after retrieving a message.
• UserID The ID of the acting user. Defaults to "me" indicating the user associated with the Access Token or Refresh Token provided.
Log In To Run
• Output
  Actuator Trigger Condition

  If{"Body":{"type":"string","description":"The message body."},"From":{"type":"string","description":"The sender address."},"HistoryID":{"type":"string","description":"The history ID. This can be passed to the StartHistoryID input to retrieve only mail received after this marker."},"MessageID":{"type":"string","description":"The ID of the message."},"NewAccessToken":{"type":"string","description":"Contains a new AccessToken when the RefreshToken is provided."},"Response":{"type":"json","description":"The response from Google."},"Snippet":{"type":"string","description":"The email body snippet."},"Subject":{"type":"string","description":"The message subject."},"Success":{"type":"boolean"}}BodyFromHistoryIDMessageIDNewAccessTok...ResponseSnippetSubjectSuccess then write

  High Low

  to at

  • Body The message body.
  • From The sender address.
  • HistoryID The history ID. This can be passed to the StartHistoryID input to retrieve only mail received after this marker.
  • MessageID The ID of the message.
  • NewAccessToken Contains a new AccessToken when the RefreshToken is provided.
  • Response The response from Google.
  • Snippet The email body snippet.
  • Subject The message subject.
• CHOREO CLASS

  • /*
    TembooTask class placeholder
    */

• iOS HEADER

  • /*
    TembooTask header placeholder
    */

• • Simple
  Enhanced
  Add a sensor via the virtual pin board above to generate code for sensor data graphs.
  Compiled
  Add a sensor or actuator via the virtual pin board above to generate compiled code for sensor data graphs and remote actuator control.
  Device Configure Changed

  Since you've changed your device configuration, you'll need to tell us about this new device.

  Update Device
  1. Add a sensor or actuator to your device.
  2. Register your board and download your code.

  Download
  • Download editable code
  • Commit to GitHub
  • Send to CCS Cloud

  OK! Let's set up your device

  This feature is in experimental mode - pricing coming soon.

  Device Name *

  Device ID

  Description

  Location *

  Use lat/long

  Sensor Data
  Frequency *

  Pro Tip!

  Power consumption will increase if you choose a higher frequency.

  Every 30 seconds Every minute Every 5 minutes Every 30 minutes Every hour Every day Custom interval

  Safeguard data

  what's this?

  If connectivity is lost, up to 2MB of data will be stored locally on your device, and updated when connectivity is restored.

  + new tag

  Save
  Commit your generated code
  and collaborate with others.

  Send your code straight to a GitHub repository.

  Collaborating on GitHub?

  Your code will be visible by others in your repos. Keep credentials private by saving a Profile or commit code with Placeholder inputs.

  Choose a GitHub Repository

  Name:

  The following files will be added to this repo:

  * Don't worry! Your credentials and any inputs that aren't saved in a Profile will not be included.

  Success!

  Visit the link below to view, modify, and share code.

  Cancel Commit code to GitHub Use Placeholders Save a Profile Commit Close
  Send code to CCS Cloud.

  You'll be able to edit and share your code from TI's CCS Cloud IDE.

  Name your application

  Names can only contain letters, numbers, hyphens, and underscores.

  The following will be sent to CCS Cloud:

  TembooMain.c

  TembooAccount.h

  instructions.txt

  + 9 others

  Success!

  Visit the link below to view, modify, and share code.

  https://dev.ti.com/ide/

  Cancel Send to CCS Cloud Send Close
  Code

  • // Instantiate the Choreo, using a previously instantiated TembooSession object, eg:
    // TembooSession session = new TembooSession("accountName", "myFirstApp", "abc123xxxxxxxxxxxxxx");
    
    GetLatestMessage getLatestMessageChoreo = new GetLatestMessage(session);
    
    // Get an InputSet object for the choreo
    GetLatestMessageInputSet getLatestMessageInputs = getLatestMessageChoreo.newInputSet();
    
    // Set inputs
    
    // Execute Choreo
    GetLatestMessageResultSet getLatestMessageResults = getLatestMessageChoreo.execute(getLatestMessageInputs);

• Header File

  • /* 
    A header file containing your Temboo account information will appear here once you've
    configured your device above.
    */

• Proxy Code

  • /*
    Please log in to generate proxy server code for use with the JavaScript SDK.
    */

• Notes

  • This Choreo retrieves the latest email from a user's inbox. The documentation for this Gmail resource can be found here.

    The optional StartHistoryID input can be passed to request the latest message since the last time your application requested a message. When the Choreo retrieves a message, it will always return a HistoryID that can be used for this purpose.

    Note: this method requires that you request one of the following scopes during the OAuth process:

    https://mail.google.com/
    https://www.googleapis.com/auth/gmail.modify
    https://www.googleapis.com/auth/gmail.readonly

    Here is an example of acceptable inputs:

    ClientID: {YOUR CLIENT ID}
    ClientSecret: {YOUR CLIENT SECRET}
    RefreshToken: {YOUR REFRESH TOKEN}
    

    The following is a sample of the JSON information returned by this Choreo:

    {
        "id": "1473fa6aca5e0543",
        "threadId": "1473fa6aca5e0543",
        "labelIds": [
            "SENT",
            "INBOX",
            "UNREAD"
        ],
        "snippet": "this is a test -- Aaron Jennings | Temboo | 104 Franklin Street NYC | www.temboo.com",
        "historyId": "3812809",
        "payload": {
            "mimeType": "multipart/alternative",
            "filename": "",
            "headers": [
                {
                    "name": "MIME-Version",
                    "value": "1.0"
                },
                {
                    "name": "Received",
                    "value": "by 10.152.87.42 with HTTP; Wed, 16 Jul 2014 07:49:53 -0700 (PDT)"
                },
                {
                    "name": "Date",
                    "value": "Wed, 16 Jul 2014 10:49:53 -0400"
                },
                {
                    "name": "Delivered-To",
                    "value": "aaron.jennings@temboo.com"
                },
                {
                    "name": "Message-ID",
                    "value": "<CAEqmo6-YNV0FrS0qyfNpxJLWMX3NnewewMX8mkA5jYxFUSFuhw@mail.gmail.com>"
                },
                {
                    "name": "Subject",
                    "value": "test email"
                },
                {
                    "name": "From",
                    "value": "Aaron Jennings <aaron.jennings@temboo.com>"
                },
                {
                    "name": "To",
                    "value": "Aaron Jennings <aaron.jennings@temboo.com>"
                },
                {
                    "name": "Content-Type",
                    "value": "multipart/alternative; boundary=001a11c258b813a03e04fe50a31b"
                }
            ],
            "body": {
                "size": 0
            },
            "parts": [
                {
                    "partId": "0",
                    "mimeType": "text/plain",
                    "filename": "",
                    "headers": [
                        {
                            "name": "Content-Type",
                            "value": "text/plain; charset=UTF-8"
                        }
                    ],
                    "body": {
                        "size": 91,
                        "data": "dGhpcyBpcyBhIHRlc3QNCg0KLS0gDQpBYXJvbiBKZW5uaW5ncyB8IFRlbWJvbyB8IDEwNCBGcmFua2xpbiBTdHJlZXQgTllDIHwgd3d3LnRlbWJvby5jb20NCg=="
                    }
                },
                {
                    "partId": "1",
                    "mimeType": "text/html",
                    "filename": "",
                    "headers": [
                        {
                            "name": "Content-Type",
                            "value": "text/html; charset=UTF-8"
                        },
                        {
                            "name": "Content-Transfer-Encoding",
                            "value": "quoted-printable"
                        }
                    ],
                    "body": {
                        "size": 254,
                        "data": "PGRpdiBkaXI9Imx0ciI-dGhpcyBpcyBhIHRlc3Q8YnIgY2xlYXI9ImFsbCI-PGRpdj48YnI-PC9kaXY-LS0gPGJyPjxkaXYgZGlyPSJsdHIiPkFhcm9uIEplbm5pbmdzIHzCoFRlbWJvbyB8IDEwNCBGcmFua2xpbiBTdHJlZXQgTllDIHzCoDxhIGhyZWY9Imh0dHA6Ly93d3cudGVtYm9vLmNvbS8iIHN0eWxlPSJjb2xvcjpyZ2IoMTcsODUsMjA0KSIgdGFyZ2V0PSJfYmxhbmsiPnd3dy50ZW1ib28uY29tPC9hPjxicj4NCjwvZGl2Pg0KPC9kaXY-DQo="
                    }
                }
            ]
        },
        "sizeEstimate": 1058
    }