Home > Services & APIs > Build > Amazon Drive

Amazon Drive Getting Started Guide

Welcome to the Amazon Drive platform

Registering Your App

Once you receive your invitation to the Amazon Drive service you can register your app for the service. The Amazon Drive API and SDKs for Android and iOS use Login with Amazon for authentication. You can learn more about Login with Amazon or begin by registering your security profile.

  1. Create a new security profile or select an existing security profile.
  2. Enter your app information; including name, description, privacy policy URI, and logo image.
  3. After you have saved your information, navigate to the Login with Amazon page and click on the Settings icon under the Manage drop-down list. Enter your platform specific information; such as Web, Android, Kindle, or iOS settings.

The Amazon Drive API and SDKs for Android and iOS require a client_id for authorization of Amazon Drive. 

Whitelisting Your App

You must be invited into the Amazon Drive API service to whitelist your app for Amazon Drive or you will not be able to send any node-related requests. 

Scopes and Permissions

When you build an app using the Amazon Drive API you need to whitelist your app as described above. During this process you need to provide details about your app, whether you need read and/or write access, and the type of content you want to have access to in a customer account such as images, videos, or documents.

Based on the options you selected in App whitelisting/ registration, you are allowed to use one or more of the following scopes.

Allowed Scope Permissions Supported Content type Setting options during whitelisting
clouddrive:read_image List all content

Download only images
image/* Account Access control -> Select “Images”

Permission Level -> Select “Read” or “Read and Write
clouddrive:read_video List all content

Download only videos
video/* Account Access control -> Select “Videos”

Permission Level -> Select “Read” or “Read and Write”
clouddrive:read_document List all content

Download only documents
"application/msword", "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"application/rtf", "application/vnd.oasis.opendocument.text", "application/xml",
"application/vnd.ms-word.template.macroenabled.12", "application/msword",
"application/vnd.openxmlformats-officedocument.wordprocessingml.template",
"application/vnd.oasis.opendocument.text-template", “application/pdf", "application/x-pdf",
"application/acrobat", "applications/vnd.pdf", "text/plain", "text/pdf", "text/x-pdf"
Account Access control -> Select “Documents”

Permission Level -> Select “Read” or “Read and Write”
clouddrive:read_other List all content

Download other content
Every content type not covered under image, video, or document scopes Account Access control -> Select “Other Files”

Permission Level -> Select “Read” or “Read and Write”
clouddrive:read_all List all content

Download all content
All Account Access control -> Select all options

Permission Level -> Select “Read” or “Read and Write”
clouddrive:write Upload/modify all content All Permission Level -> Select “Write” or “Read and Write”
 

Note:
clouddrive:read scope will still work for the applications already using it. New applications will not be able to use older clouddrive:read scope.

Next Steps

Get started with the Android SDK
Get started with the iOS SDK
Get started with the REST APIs


Support

If you have any questions, see the Developer Forum.