Code Generation for APIs
Program the world. Generate code in less than 10 minutes.
This feature isn't available on your account.
Want to account?
Back to Kosmos

Choreos

Public
Private

You have no favorites... yet!

Your Private APIs Here

Enable digital transformation at your organization.

Learn More
  • 0
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • A5
  • A4
  • A3
  • A2
  • A1
  • A0
Get started with Arduino
Arduino
Arduino
Texas Instruments
Samsung
C#
Java
JavaScript
Node.js
PHP
Processing
Python
REST API
Ruby
iOS
Android
What's your device?
How is it connected?

Library . Google . Gmailv2 . Messages . GetNextMessage

Retrieves the next 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.
    • LabelID Returns messages with a label matching this ID (e.g., INBOX, UNREAD, Label_1, etc.)
  • Optional Input
  • Output
    • Body The message body.
    • From The sender address.
    • MessageID The ID of the message.
    • NewAccessToken Contains a new AccessToken when the RefreshToken is provided.
    • Response The response from Google.
    • ResponseStatusCode The response code returned from Google. A 200 is expected for a successful request. A 404 indicates that the stored history id has become invalid or expired. See Choreo notes for more details.
    • Snippet The email body snippet.
    • Subject The message subject.
    • 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.

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

    OK! Let's set up your device

    This feature is in experimental mode - pricing coming soon.

    Use lat/long
    Pro Tip!
    Power consumption will increase if you choose a higher frequency.
    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.

    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.

    Commit code to GitHub

    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/
    Code 
    • /*
Your auto-generated code will appear here once you've configured your device above.
*/
  • Header File 
    • /* 
A header file containing your Temboo account information will appear here once you've
configured your device above.
*/
  • Notes

    • This Choreo retrieves the next email from a user's inbox. When running this Choreo for the first time, the latest message in the inbox will be retrieved. The message's history ID will be stored in your Temboo account and used the next time you run the Choreo to retrieve only the next message that has arrived.

      This Choreo can can be useful when setting up a Filter for certain emails so that a particular Gmail Label is applied to the message when it is received. Your app can then poll for new messages within the label. When using the LabelID input, history IDs will be stored along with the LabelID so that messages can be tracked per label.

      The history ID that is stored in order to keep track of previously retrieved messages is only valid for about a week. If the history ID becomes invalid or expired, the Choreo will retrieve the latest message from the specified Label and reset the stored history ID. A 404 ResponseStatusCode will be returned in this case to let your application know in case any special handling is needed. If at any time, you want to clear the stored history ID to retrieve the latest message and begin storing the latest message history ID, you can run the ClearStoredHistory Choreo.

      This Choreo can't retrieve messages from TRASH or SPAM.

      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}
      LabelID: Label_1

      The following message fields are returned as outputs: Body, From, MessageID, Snippet, Subject. In addition to these fields, the following is a sample of the JSON information returned in the Google Response:

      {
    "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
}
Welcome to Temboo
Program the world. Generate code in less than 10 minutes.
What type of code would you like to generate?
Arduino
Texas Instruments
Samsung
C#
Java
JavaScript
Node.js
PHP
Processing
Python
REST API
Ruby
iOS
Android