Soon, using the Dropbox API, developers can integrate with G Suite content. New endpoints and extensions to existing endpoints will help Dropbox developers work with these files to serve shared users. This post outlines the changes and updates you should be aware of when handling Google Docs, Sheets, and Slides with the Dropbox API.
G Suite files will be returned by files/list_folder, and can be moved, renamed, and deleted like other Dropbox files. Previews and thumbnails are supported as well.
The new is_downloadable value will indicate if calling files/download is supported to return the binary file.Calling files/download and related endpoints will return an unsupported_file exception when is_downloadable is false.
Non-downloadable files can instead be exported in the new files/export API call, to an appropriate filetype indicated in the file’s export_info.
The new include_non_downloadable_filesparameter on files/list_folder, which defaults to true, can be used to omit these types of files from list results.
Shared Links Update
To date, shared links have granted read-only access to content. Starting with G Suite, some types of Dropbox files may also allow someone with the link to edit as well. We have enhanced our shared links API to support this.
If the link access level is unspecified, the access level will be“viewer” by default.
With this enhancement, it will be possible for these types of files to have multiple links — one for views and one for edits. The view access level can be used in conjunction with the audience parameter, so you could create a public view only link and an editable link for the team.
The password and expiration settings are not currently supported for G Suite shared links and will return an invalid_settings error if set.
These links will have an effective_audience parameter returned instead of resolve_visibility to indicate the effective visibility of the link. Eventually all links will transition to return effective_audience instead.
Historically, shared links have been unique to the link creator and content. Thus, the same piece of shared content may have multiple links created by different users. Starting with G Suite files, some types of shared links may be unique to the content only,so all users share the link to the content.
If you’re part of a Dropbox Business team, your admin can enable G Suite access in the Dropbox Admin Console so that you can test against the new document types in Dropbox.
Please feel free to contact us here with any questions or feedback about using the Dropbox API to manage G Suite files in Dropbox.