Update API spec and regerate SDK.

Author: Diwaker Gupta

dropbox/auth/client.go

@@ -18,7 +18,6 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 // THE SOFTWARE.
 
-// Package auth : has no documentation (yet)
 package auth
 
 import (

dropbox/files/client.go

@@ -18,8 +18,6 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 // THE SOFTWARE.
 
-// Package files : This namespace contains endpoints and data types for basic
-// file operations.
 package files
 
 import (

dropbox/files/types.go

@@ -114,8 +114,8 @@ func NewGetMetadataArg(Path string) *GetMetadataArg {
 // AlphaGetMetadataArg : has no documentation (yet)
 type AlphaGetMetadataArg struct {
 	GetMetadataArg
-	// IncludePropertyTemplates : If true, `FileMetadata.property_groups` is set
-	// for files with custom properties.
+	// IncludePropertyTemplates : If set to a valid list of template IDs,
+	// `FileMetadata.property_groups` is set for files with custom properties.
 	IncludePropertyTemplates []string `json:"include_property_templates,omitempty"`
 }
 
@@ -631,12 +631,21 @@ type FolderSharingInfo struct {
 	// SharedFolderId : If this folder is a shared folder mount point, the ID of
 	// the shared folder mounted at this location.
 	SharedFolderId string `json:"shared_folder_id,omitempty"`
+	// TraverseOnly : Specifies that the folder can only be traversed and the
+	// user can only see a limited subset of the contents of this folder because
+	// they don't have read access to this folder. They do, however, have access
+	// to some sub folder.
+	TraverseOnly bool `json:"traverse_only"`
+	// NoAccess : Specifies that the folder cannot be accessed by the user
+	NoAccess bool `json:"no_access"`
 }
 
 // NewFolderSharingInfo returns a new FolderSharingInfo instance
 func NewFolderSharingInfo(ReadOnly bool) *FolderSharingInfo {
 	s := new(FolderSharingInfo)
 	s.ReadOnly = ReadOnly
+	s.TraverseOnly = false
+	s.NoAccess = false
 	return s
 }
 

dropbox/sdk.go

@@ -34,7 +34,7 @@ const (
 	hostContent   = "content"
 	hostNotify    = "notify"
 	sdkVersion    = "1.0.0-beta"
-	specVersion   = "0697bd2"
+	specVersion   = "2fad251"
 )
 
 // Version returns the current SDK version and API Spec version
@@ -44,10 +44,14 @@ func Version() (string, string) {
 
 // Config contains parameters for configuring the SDK.
 type Config struct {
-	Token      string
-	Verbose    bool
+	// OAuth2 access token
+	Token string
+	// Enable verbose logging in SDK
+	Verbose bool
+	// Used with APIs that support operations as another user
 	AsMemberID string
-	Domain     string
+	// No need to set -- for testing only
+	Domain string
 }
 
 // Context is the base client context used to implement per-namespace clients.

dropbox/sharing/client.go

@@ -18,8 +18,6 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 // THE SOFTWARE.
 
-// Package sharing : This namespace contains endpoints and data types for
-// creating and managing shared links and shared folders.
 package sharing
 
 import (

dropbox/sharing/types.go

@@ -538,6 +538,7 @@ const (
 	FileActionUnshare               = "unshare"
 	FileActionRelinquishMembership  = "relinquish_membership"
 	FileActionShareLink             = "share_link"
+	FileActionCreateLink            = "create_link"
 	FileActionOther                 = "other"
 )
 
@@ -713,15 +714,41 @@ func NewFileLinkMetadata(Url string, Name string, LinkPermissions *LinkPermissio
 // FileMemberActionError : has no documentation (yet)
 type FileMemberActionError struct {
 	dropbox.Tagged
+	// AccessError : Specified file was invalid or user does not have access.
+	AccessError *SharingFileAccessError `json:"access_error,omitempty"`
 }
 
 // Valid tag values for FileMemberActionError
 const (
 	FileMemberActionErrorInvalidMember = "invalid_member"
 	FileMemberActionErrorNoPermission  = "no_permission"
+	FileMemberActionErrorAccessError   = "access_error"
 	FileMemberActionErrorOther         = "other"
 )
 
+// UnmarshalJSON deserializes into a FileMemberActionError instance
+func (u *FileMemberActionError) UnmarshalJSON(body []byte) error {
+	type wrap struct {
+		dropbox.Tagged
+		// AccessError : Specified file was invalid or user does not have
+		// access.
+		AccessError json.RawMessage `json:"access_error,omitempty"`
+	}
+	var w wrap
+	if err := json.Unmarshal(body, &w); err != nil {
+		return err
+	}
+	u.Tag = w.Tag
+	switch u.Tag {
+	case "access_error":
+		if err := json.Unmarshal(w.AccessError, &u.AccessError); err != nil {
+			return err
+		}
+
+	}
+	return nil
+}
+
 // FileMemberActionIndividualResult : has no documentation (yet)
 type FileMemberActionIndividualResult struct {
 	dropbox.Tagged
@@ -868,6 +895,7 @@ const (
 	FolderActionUnshare               = "unshare"
 	FolderActionLeaveACopy            = "leave_a_copy"
 	FolderActionShareLink             = "share_link"
+	FolderActionCreateLink            = "create_link"
 	FolderActionOther                 = "other"
 )
 
@@ -2880,6 +2908,11 @@ type SharedFileMetadata struct {
 	Name string `json:"name"`
 	// Id : The ID of the file.
 	Id string `json:"id"`
+	// TimeInvited : Timestamp indicating when the current user was invited to
+	// this shared file. If the user was not invited to the shared file, the
+	// timestamp will indicate when the user was invited to the parent shared
+	// folder. This value may be absent.
+	TimeInvited time.Time `json:"time_invited,omitempty"`
 }
 
 // NewSharedFileMetadata returns a new SharedFileMetadata instance

dropbox/team/client.go

@@ -18,7 +18,6 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 // THE SOFTWARE.
 
-// Package team : has no documentation (yet)
 package team
 
 import (

dropbox/team/types.go

@@ -1423,8 +1423,8 @@ type MemberAddResult struct {
 	// limit has been reached.
 	FreeTeamMemberLimitReached string `json:"free_team_member_limit_reached,omitempty"`
 	// UserAlreadyOnTeam : User is already on this team. The provided email
-	// address is associated with a user who is already a member of or invited
-	// to the team.
+	// address is associated with a user who is already a member of (including
+	// in recoverable state) or invited to the team.
 	UserAlreadyOnTeam string `json:"user_already_on_team,omitempty"`
 	// UserOnAnotherTeam : User is already on another team. The provided email
 	// address is associated with a user that is already a member or invited to
@@ -1435,7 +1435,7 @@ type MemberAddResult struct {
 	// UserMigrationFailed : User migration has failed.
 	UserMigrationFailed string `json:"user_migration_failed,omitempty"`
 	// DuplicateExternalMemberId : A user with the given external member ID
-	// already exists on the team.
+	// already exists on the team (including in recoverable state).
 	DuplicateExternalMemberId string `json:"duplicate_external_member_id,omitempty"`
 	// UserCreationFailed : User creation has failed.
 	UserCreationFailed string `json:"user_creation_failed,omitempty"`

dropbox/users/client.go

@@ -18,8 +18,6 @@
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 // THE SOFTWARE.
 
-// Package users : This namespace contains endpoints and data types for user
-// management.
 package users
 
 import (

dropbox/users/types.go

@@ -266,15 +266,19 @@ type Name struct {
 	// DisplayName : A name that can be used directly to represent the name of a
 	// user's Dropbox account.
 	DisplayName string `json:"display_name"`
+	// AbbreviatedName : An abbreviated form of the person's name. Their
+	// initials in most locales.
+	AbbreviatedName string `json:"abbreviated_name"`
 }
 
 // NewName returns a new Name instance
-func NewName(GivenName string, Surname string, FamiliarName string, DisplayName string) *Name {
+func NewName(GivenName string, Surname string, FamiliarName string, DisplayName string, AbbreviatedName string) *Name {
 	s := new(Name)
 	s.GivenName = GivenName
 	s.Surname = Surname
 	s.FamiliarName = FamiliarName
 	s.DisplayName = DisplayName
+	s.AbbreviatedName = AbbreviatedName
 	return s
 }