Get all files in shared link loder

[Arron G.]

I'm looking to use the v2 api to download the contents of a shared folder from a link like this:

https://www.dropbox.com/sh/[some_junk]/[some_other_junk]?dl=0

this link is not necessarily generated by the user authenticating the API call but would be either a public link, or a team link from a team the authenticated user is a member of, or the user would have the password (so my API app would as well)  In short this is a link the user COULD access with a browser logged into the authenticating account.

I KNOW that you can add ?dl=1 to the URL to generate a zip.  i also know that folders that contain more than 10,000 files or are larger than 1 GB will fail to generate that zip.  This is what i'm trying to deal with.

I want to have my app download all of the files in that folder one by one and put them all into the right folder structure on another server so that humans don't need to waste their time doing exactly that.

so, what specific methods do I need to call to list the contents of folders in a shared link? then when there are subfolders there, how do i list THEIR contents?

Thanks.

[Steve M.]

See get_shared_link_metadata and get_shared_link_file.

[Steve M.]

Oh, actually, I think that get_shared_link_metadata doesn't give you a list of files in a folder...

API v1 has https://www.dropbox.com/developers-v1/core/docs#metadata-link, which should work for you right now, but API v1 is deprecated. I'll check with the team to see if equivalent functionality is available in API v2.

[Arron G.]

Thanks Steve. 

That's kind of you. I had a look at both of those endpoints before posting.  Unless I'm missing something, I don't think they will help here.

[Greg-DB]

Steve is correct, this isn't available in API v2, but I'll be sure to pass this along as a feature request. 

[Arron G.]

damn.  it's almost as if there is a concerted effort to stonewall any attempts i have of getting around the "more than 10,000 files or larger than 1 GB" limit.  it's relentlessly frustrating.

[Greg-DB]

Dropbox API v2 now supports listing the contents of a shared link for a folder. This can be accomplished using the same interface as listing a folder in a connected user's account, via the list_folder functionality. To list the contents of a shared link for a folder, you instead provide the shared link URL in the `shared_link` parameter to list_folder:

https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder

If you're using an official SDK, there will also be a corresponding method for this endpoint:


In the .NET SDK that's available as `ListFolderAsync`:

https://dropbox.github.io/dropbox-sdk-dotnet/html/M_Dropbox_Api_Files_Routes_FilesUserRoutes_ListFol...


In the Java SDK that's available via `listFolderBuilder` to get a `ListFolderBuilder` on which you can call `ListFolderBuilder.withSharedLink`:

https://dropbox.github.io/dropbox-sdk-java/api-docs/v3.0.x/com/dropbox/core/v2/files/DbxUserFilesReq...

https://dropbox.github.io/dropbox-sdk-java/api-docs/v3.0.x/com/dropbox/core/v2/files/ListFolderBuild...

https://dropbox.github.io/dropbox-sdk-java/api-docs/v3.0.x/com/dropbox/core/v2/files/ListFolderBuild...


In the JavaScript SDK that's available as `filesListFolder`:

https://dropbox.github.io/dropbox-sdk-js/Dropbox.html#filesListFolder__anchor


In the Python SDK that's available as `files_list_folder`:

https://dropbox-sdk-python.readthedocs.io/en/latest/moduledoc.html#dropbox.dropbox.Dropbox.files_lis...


In the Swift SDK that's available as `listFolder`:

https://dropbox.github.io/SwiftyDropbox/api-docs/latest/Classes/FilesRoutes.html#/s:13SwiftyDropbox1...


In the Objective-C SDK that's available as `listFolder`:

https://dropbox.github.io/dropbox-sdk-obj-c/api-docs/latest/Classes/DBFILESUserAuthRoutes.html#/c:ob...:

[jyotinarang]

Hi Greg,

I was successful in listing the folders and files from the shared folder, however, I am still having trouble downloading data. The meta-data shows the fields 'path_lower' and 'path_display'  to be empty. Could you suggest if I can download the files after listing the entries?

Thanks

Jyoti

[Greg-DB]

@jyotinarang It sounds like you're calling list_folder with a shared link owned by a different user than the one for the access token you're using. In that case, the path values won't be included, but I'll pass this along as a feature request. 

That means you'll need to manually build the relative path from the 'name' value. E.g., if the returned metadata entry for the file you want in the root of the folder is "test.txt", you would pass "/test.txt" to get_shared_link_file.

[jyotinarang]

Thanks Greg for the information. I can see that the function get_shared_link_file() expects a url as parameter. However, this value is not available to me when I get information about the folder. How do I construct a url from just the name?Even with relative paths, I don't see a way to construct the url of the files within the main folder.

Thanks

Jyoti