A sample app for sharing datastores.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.idea
libs
res
src/com/dropbox/examples/lists
.gitignore
AndroidManifest.xml
LICENSE.txt
Lists.iml
README.md
ant.properties
build.xml
proguard-project.txt
project.properties

README.md

Update: The Datastore API has been deprecated. Learn more.

Lists

This app demonstrates the Dropbox Datastore API, in particular the use of datastore sharing to support collaboration. You can try the app at dslists.site44.com.

Read more about Lists on the Dropbox developer blog.

Understanding the data model

The Lists app lets you create multiple lists, add items to those lists, and share those lists with other users.

  • Each list is a datastore.
  • Each datastore contains an "items" table.
  • Each record in the "items" table has the following fields:
    • "text": The text of the item.
    • "date": When the item was created (used for sorting).

Sharing a datastore

When sharing a datastore, the user needs to set the role for one or more principal. For example, the user might set the "public" role to "viewer" to allow viewing but not editing of the list. To learn more about the datastore sharing model, see the Datastore API HTTP documentation.

Once a role has been set to allow other users to view or edit a datastore, the datastore may be shared via a URL (dslists.site44.com#<datastore ID>) in an email or text message.

If the URL is opened on an Android device, the user will be prompted to open the datastore in the Android app. The Android app intercepts URLs of the form https://dslists.site44.com/#<datastore ID> to open the app to the correct list.

All versions