Update to latest API spec.

Author: Diwaker Gupta

dropbox/file_properties/client.go

@@ -42,8 +42,8 @@ type Client interface {
 	// explicitly marked for deletion.
 	PropertiesOverwrite(arg *OverwritePropertyGroupArg) (err error)
 	// PropertiesRemove : Remove the specified property group from the file. To
-	// remove specific property field key value pairs, see route
-	// `propertiesUpdate`. To update a template, see `templatesUpdateForUser` or
+	// remove specific property field key value pairs, see `propertiesUpdate`.
+	// To update a template, see `templatesUpdateForUser` or
 	// `templatesUpdateForTeam`. Templates can't be removed once created.
 	PropertiesRemove(arg *RemovePropertiesArg) (err error)
 	// PropertiesSearch : Search across property templates for particular
@@ -57,29 +57,33 @@ type Client interface {
 	// `propertiesOverwrite` will delete any fields that are omitted from a
 	// property group.
 	PropertiesUpdate(arg *UpdatePropertiesArg) (err error)
-	// TemplatesAddForTeam : Add a template associated with a team. See route
+	// TemplatesAddForTeam : Add a template associated with a team. See
 	// `propertiesAdd` to add properties to a file or folder.
 	TemplatesAddForTeam(arg *AddTemplateArg) (res *AddTemplateResult, err error)
-	// TemplatesAddForUser : Add a template associated with a user. See route
-	// `propertiesAdd` to add properties to a file.
+	// TemplatesAddForUser : Add a template associated with a user. See
+	// `propertiesAdd` to add properties to a file. This endpoint can't be
+	// called on a team member or admin's behalf.
 	TemplatesAddForUser(arg *AddTemplateArg) (res *AddTemplateResult, err error)
 	// TemplatesGetForTeam : Get the schema for a specified template.
 	TemplatesGetForTeam(arg *GetTemplateArg) (res *GetTemplateResult, err error)
-	// TemplatesGetForUser : Get the schema for a specified template.
+	// TemplatesGetForUser : Get the schema for a specified template. This
+	// endpoint can't be called on a team member or admin's behalf.
 	TemplatesGetForUser(arg *GetTemplateArg) (res *GetTemplateResult, err error)
 	// TemplatesListForTeam : Get the template identifiers for a team. To get
 	// the schema of each template use `templatesGetForTeam`.
 	TemplatesListForTeam() (res *ListTemplateResult, err error)
 	// TemplatesListForUser : Get the template identifiers for a team. To get
-	// the schema of each template use `templatesGetForUser`.
+	// the schema of each template use `templatesGetForUser`. This endpoint
+	// can't be called on a team member or admin's behalf.
 	TemplatesListForUser() (res *ListTemplateResult, err error)
 	// TemplatesUpdateForTeam : Update a template associated with a team. This
 	// route can update the template name, the template description and add
 	// optional properties to templates.
 	TemplatesUpdateForTeam(arg *UpdateTemplateArg) (res *UpdateTemplateResult, err error)
 	// TemplatesUpdateForUser : Update a template associated with a user. This
 	// route can update the template name, the template description and add
-	// optional properties to templates.
+	// optional properties to templates. This endpoint can't be called on a team
+	// member or admin's behalf.
 	TemplatesUpdateForUser(arg *UpdateTemplateArg) (res *UpdateTemplateResult, err error)
 }
 

dropbox/file_requests/types.go

@@ -19,8 +19,7 @@
 // THE SOFTWARE.
 
 // Package file_requests : This namespace contains endpoints and data types for
-// file request operations. Warning: This namespace is in beta and is subject to
-// backwards-incompatible changes.
+// file request operations.
 package file_requests
 
 import (

dropbox/files/types.go

@@ -1123,6 +1123,11 @@ func NewGpsCoordinates(Latitude float64, Longitude float64) *GpsCoordinates {
 type ListFolderArg struct {
 	// Path : A unique identifier for the file.
 	Path string `json:"path"`
+	// SharedLink : A shared link to list the contents of, if the link is
+	// protected provide the password. if this field is present,
+	// `ListFolderArg.path` will be relative to root of the shared link. Only
+	// non-recursive mode is supported for shared link.
+	SharedLink *SharedLink `json:"shared_link,omitempty"`
 	// Recursive : If true, the list folder operation will be applied
 	// recursively to all subfolders and the response will contain contents of
 	// all subfolders.
@@ -2310,6 +2315,21 @@ func NewSearchResult(Matches []*SearchMatch, More bool, Start uint64) *SearchRes
 	return s
 }
 
+// SharedLink : has no documentation (yet)
+type SharedLink struct {
+	// Url : Shared link url.
+	Url string `json:"url"`
+	// Password : Password for the shared link.
+	Password string `json:"password,omitempty"`
+}
+
+// NewSharedLink returns a new SharedLink instance
+func NewSharedLink(Url string) *SharedLink {
+	s := new(SharedLink)
+	s.Url = Url
+	return s
+}
+
 // ThumbnailArg : has no documentation (yet)
 type ThumbnailArg struct {
 	// Path : The path to the image file you want to thumbnail.

dropbox/sdk.go

@@ -35,8 +35,8 @@ const (
 	hostAPI       = "api"
 	hostContent   = "content"
 	hostNotify    = "notify"
-	sdkVersion    = "3.0.0"
-	specVersion   = "52ee619"
+	sdkVersion    = "3.1.0"
+	specVersion   = "97eb698"
 )
 
 // Version returns the current SDK version and API Spec version

dropbox/sharing/types.go

@@ -3368,7 +3368,7 @@ func NewSharedContentLinkMetadata(AudienceOptions []*LinkAudience, CurrentAudien
 // part of the results for `listFileMembersBatch`.
 type SharedFileMembers struct {
 	// Users : The list of user members of the shared file.
-	Users []*UserMembershipInfo `json:"users"`
+	Users []*UserFileMembershipInfo `json:"users"`
 	// Groups : The list of group members of the shared file.
 	Groups []*GroupMembershipInfo `json:"groups"`
 	// Invitees : The list of invited members of a file, but have not logged in
@@ -3381,7 +3381,7 @@ type SharedFileMembers struct {
 }
 
 // NewSharedFileMembers returns a new SharedFileMembers instance
-func NewSharedFileMembers(Users []*UserMembershipInfo, Groups []*GroupMembershipInfo, Invitees []*InviteeMembershipInfo) *SharedFileMembers {
+func NewSharedFileMembers(Users []*UserFileMembershipInfo, Groups []*GroupMembershipInfo, Invitees []*InviteeMembershipInfo) *SharedFileMembers {
 	s := new(SharedFileMembers)
 	s.Users = Users
 	s.Groups = Groups
@@ -4106,6 +4106,41 @@ func (u *UpdateFolderPolicyError) UnmarshalJSON(body []byte) error {
 	return nil
 }
 
+// UserMembershipInfo : The information about a user member of the shared
+// content.
+type UserMembershipInfo struct {
+	MembershipInfo
+	// User : The account information for the membership user.
+	User *UserInfo `json:"user"`
+}
+
+// NewUserMembershipInfo returns a new UserMembershipInfo instance
+func NewUserMembershipInfo(AccessType *AccessLevel, User *UserInfo) *UserMembershipInfo {
+	s := new(UserMembershipInfo)
+	s.AccessType = AccessType
+	s.User = User
+	s.IsInherited = false
+	return s
+}
+
+// UserFileMembershipInfo : The information about a user member of the shared
+// content with an appended last seen timestamp.
+type UserFileMembershipInfo struct {
+	UserMembershipInfo
+	// TimeLastSeen : The UTC timestamp of when the user has last seen the
+	// content, if they have.
+	TimeLastSeen time.Time `json:"time_last_seen,omitempty"`
+}
+
+// NewUserFileMembershipInfo returns a new UserFileMembershipInfo instance
+func NewUserFileMembershipInfo(AccessType *AccessLevel, User *UserInfo) *UserFileMembershipInfo {
+	s := new(UserFileMembershipInfo)
+	s.AccessType = AccessType
+	s.User = User
+	s.IsInherited = false
+	return s
+}
+
 // UserInfo : Basic information about a user. Use `usersAccount` and
 // `usersAccountBatch` to obtain more detailed information.
 type UserInfo struct {
@@ -4126,23 +4161,6 @@ func NewUserInfo(AccountId string, SameTeam bool) *UserInfo {
 	return s
 }
 
-// UserMembershipInfo : The information about a user member of the shared
-// content.
-type UserMembershipInfo struct {
-	MembershipInfo
-	// User : The account information for the membership user.
-	User *UserInfo `json:"user"`
-}
-
-// NewUserMembershipInfo returns a new UserMembershipInfo instance
-func NewUserMembershipInfo(AccessType *AccessLevel, User *UserInfo) *UserMembershipInfo {
-	s := new(UserMembershipInfo)
-	s.AccessType = AccessType
-	s.User = User
-	s.IsInherited = false
-	return s
-}
-
 // ViewerInfoPolicy : has no documentation (yet)
 type ViewerInfoPolicy struct {
 	dropbox.Tagged

dropbox/team/client.go

@@ -241,8 +241,8 @@ type Client interface {
 	// TeamFolderArchiveCheck : Returns the status of an asynchronous job for
 	// archiving a team folder. Permission : Team member file access.
 	TeamFolderArchiveCheck(arg *async.PollArg) (res *TeamFolderArchiveJobStatus, err error)
-	// TeamFolderCreate : Creates a new, active, team folder. Permission : Team
-	// member file access.
+	// TeamFolderCreate : Creates a new, active, team folder with no members.
+	// Permission : Team member file access.
 	TeamFolderCreate(arg *TeamFolderCreateArg) (res *TeamFolderMetadata, err error)
 	// TeamFolderGetInfo : Retrieves metadata for team folders. Permission :
 	// Team member file access.