-
Downloads
-
Platforms
-
Resources
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.
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.
