Windows apps
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.


Try out code samples  Get started

Your apps can work with a Microsoft OneDrive user's folders, files, albums, photos, videos, audio, tags, and comments by using the Live SDK.

In this section


Common tasks

How to do common tasks when accessing a user's OneDrive contents from your app.

Folders and files

How to create, read, update, and delete folders and files from a user's OneDrive.

Albums, photos, videos, audio, and tags

How to create, read, update, and delete albums, photos, videos, and audio from a user's OneDrive.


How to read, delete, and create comments associated with the folders, files, albums, photos, and videos in a user's OneDrive.

File picker for web apps

How to include a file picker in your web page or web app that provides a consistent UI to upload and download files to and from a user's OneDrive.

OneDrive core concepts

The concepts that apply to accessing a user's OneDrive contents from your app.


Guidelines for apps that interact with OneDrive

Apps that interact with OneDrive must conform to these principles:

  • Upload files to OneDrive only in response to an explicit user request or choice. Your apps must always ensure that a user intentionally chooses to save any new data to OneDrive. Apps must not upload files to OneDrive automatically without a user making an explicit choice to upload those files.

    Here are some examples of conforming apps:

    • Apps that display an "Upload to OneDrive" or "Share on OneDrive" button that a user must click before each upload of a photo, video, document, or other file.
    • Document-editing apps that require a user to click an "Upload to OneDrive" button initially, so that the app can save that document later without further user interaction.

    Here are some examples of nonconforming apps:

    • Apps that automatically upload to OneDrive any file added to a specific location on a user’s devices.
    • Apps that automatically back up files or folders to OneDrive.
  • Use OneDrive for the things that it’s good at. OneDrive includes features both for high-quality document viewing and editing, and for creating and sharing beautiful photo albums. If possible, have your apps take advantage of these features.
  • Don't undermine trust in OneDrive. Over the years that OneDrive has been available, users have come to trust it. Preserving that trust is critical and your apps must not undermine it by doing things that users don’t expect, especially with regard to data privacy.

    Here are some examples of conforming apps:

    • Apps that upload documents or photos to OneDrive with user-only access as the default.
    • Apps that warn users that, when the users send a link to their content stored on OneDrive, anyone who receives that link can read the associated files.

    Here's an example of a nonconforming app:

    • An app that makes all shared files in OneDrive publicly accessible by default, without clearly communicating this behavior to users.


See also

  • Video: The complete developer’s guide to the OneDrive API

    Learn how you can easily enable your users to read and write documents, photos, and other files to and from their OneDrive account using simple Representational State Transfer (REST) API calls.


    Learn how to develop rich, interactive mashups on your web site using this Microsoft Excel Web App on OneDrive.



© 2017 Microsoft