Library . Google . Spreadsheets . RetrieveWorksheet

Retrieves a specified worksheet from a Google spreadsheet in CSV, XML, or JSON format.

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.
• SpreadsheetKey The unique key of the spreadsheet associated with the worksheet you want to retrieve. Required unless SpreadsheetName and WorksheetName are supplied.
• WorksheetId The unique ID of the worksheet that you want to retrieve. Required unless SpreadsheetName and WorksheetName are supplied.
Optional Input
• AccessToken A valid Access Token retrieved during the OAuth process. This is required unless you provide the ClientID, ClientSecret, and RefreshToken to generate a new Access Token.
• ResponseFormat The format that the response should be in. Valid values are: csv (the default), xml, and json.
• SpreadsheetName The name of the spreadsheet to retrieve. This and WorksheetName can be used as an alternative to SpreadsheetKey and WorksheetId to lookup spreadsheet details by name.
• WorksheetName The name of the worksheet to retrieve. This and SpreadsheetName can be used as an alternative to SpreadsheetKey and WorksheetId to lookup spreadsheet details by name.
Log In To Run
• Output
  Actuator Trigger Condition

  If{"NewAccessToken":{"type":"string","description":"Contains a new AccessToken when the RefreshToken is provided."},"Response":{"type":"multiline","description":"The response from Google."},"Success":{"type":"boolean"}}NewAccessTok...ResponseSuccess then write

  High Low

  to at

  • NewAccessToken Contains a new AccessToken when the RefreshToken is provided.
  • Response The response from Google.
• 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");
    
    RetrieveWorksheet retrieveWorksheetChoreo = new RetrieveWorksheet(session);
    
    // Get an InputSet object for the choreo
    RetrieveWorksheetInputSet retrieveWorksheetInputs = retrieveWorksheetChoreo.newInputSet();
    
    // Set inputs
    
    // Execute Choreo
    RetrieveWorksheetResultSet retrieveWorksheetResults = retrieveWorksheetChoreo.execute(retrieveWorksheetInputs);

• 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 a specified worksheet from a Google spreadsheet in CSV, XML, or JSON format. The Choreo returns worksheet data in CSV by default, but you can request XML or JSON by setting the optional ResponseFormat input.

    There are two options for specifying the spreadsheet and worksheet you want to retrieve:

    • You can provide the SpreadsheetKey and WorksheetId which can be retrieved easily using the /Library/Google/Spreadsheets/RetrieveSpreadsheetsByName Choreo
    • You can provide the SpreadsheetName and WorksheetName. This option will lookup the spreadsheet details by name before making the request.

    Note: This Choreo retrieves the worksheet feed using the list-based feed method described here. The feed will contain all rows after the first row up to the first blank row. The first blank row terminates the result set. If you find that expected data isn't appearing in the Choreo result, check the worksheet for an unexpected blank row in the middle of the data, and remove it. In particular, if the second row of the worksheet is empty, the list will contain no data.

    Here is an example of acceptable inputs:

    ClientID: {YOUR CLIENT ID}
    ClientSecret: {YOUR CLIENT SECRET}
    RefreshToken: {YOUR REFRESH TOKEN}
    SpreadsheetName: MyNewSpreadsheet
    WorksheetName: Sheet2

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

    firstname,lastname,email
    Stan,Johnson,stan@temboo.com
    Lucy,Phillips,lucy@temboo.com
    John,Smith,john@temboo.com