Amazon Drive Getting Started Guide

Important: Amazon Drive has been deprecated! No apps using Amazon Drive can be submitted to the Appstore.

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.

Create a new security profile or select an existing security profile.
Enter your app information; including name, description, privacy policy URI, and logo image.
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.

Adding Your App to the Allow List

You must be invited into the Amazon Drive API service to add your app to the allow list 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 add your app to the allow list 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 during registration and adding your app to the allow list, you are allowed to use one or more of the following scopes.

Allowed scope	Permissions	Supported content type	Setting options when being added to the allow list
`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.

Last updated: Jul 07, 2021