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.
- 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 |
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 REST APIs
Support
If you have any questions, see the Developer Forum.
Last updated: Jul 07, 2021