cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 
Announcements
Want to learn some quick and useful tips to make your day easier? Check out how Calvin uses Replay to get feedback from other teams at Dropbox here.

Dropbox API Support & Feedback

Find help with the Dropbox API from other developers.

cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 

include_has_explicit_shared_members returns false

include_has_explicit_shared_members returns false

Ashley B.15
Helpful | Level 7
Go to solution

Hi,

I was wondering if there was any documentation around include_has_explicit_shared_members? Should this return true for the following example

 

I have a shared folder with a number of files.  If I share the file with another user that is not included on the orginal share. Should this return true indicating I need to make a request to get the extra members this file is shared with?

 

If not, when would this return true?

 

Thanks

1 Accepted Solution

Accepted Solutions

Greg-DB
Dropbox Staff
Go to solution

Hi Ashley, "include_has_explicit_shared_members" is a parameter that you can set on some endpoints, such as /2/files/get_metadata. The documenation there documents it as:

 

"include_has_explicit_shared_members Boolean If true, the results will include a flag for each file indicating whether or not that file has any explicit members. The default for this field is False."

 

If you click on the "FileMetadata" return type to expand it, you'll also see the corresponding "has_explicit_shared_members" response field, which is documented as:

 

"has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional."

 

You asked about what "include_has_explicit_shared_members" would return, but that's the argument, not part of the response. To summarize though, "has_explicit_shared_members" will only be returned if you did set "include_has_explicit_shared_members" to true in the call, and then the value of "has_explicit_shared_members" will only be true if the file has explicit shared members. That should include the particular scenario you described.

View solution in original post

2 Replies 2

Greg-DB
Dropbox Staff
Go to solution

Hi Ashley, "include_has_explicit_shared_members" is a parameter that you can set on some endpoints, such as /2/files/get_metadata. The documenation there documents it as:

 

"include_has_explicit_shared_members Boolean If true, the results will include a flag for each file indicating whether or not that file has any explicit members. The default for this field is False."

 

If you click on the "FileMetadata" return type to expand it, you'll also see the corresponding "has_explicit_shared_members" response field, which is documented as:

 

"has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional."

 

You asked about what "include_has_explicit_shared_members" would return, but that's the argument, not part of the response. To summarize though, "has_explicit_shared_members" will only be returned if you did set "include_has_explicit_shared_members" to true in the call, and then the value of "has_explicit_shared_members" will only be true if the file has explicit shared members. That should include the particular scenario you described.

webfort
Explorer | Level 3
Go to solution

Thanks, been a long day. Can't believe I missed that one.

 

Need more support?
Who's talking

Top contributors to this post

  • User avatar
    webfort Explorer | Level 3
  • User avatar
    Greg-DB Dropbox Staff
What do Dropbox user levels mean?