Developer Console

Amazon Drive Getting Started Guide

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. 

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

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