Generated against spec 222ba8c

Author: Diwaker Gupta

dropbox/files/client.go

@@ -247,16 +247,19 @@ type Client interface {
 	// upload session with `uploadSessionStart`.
 	Upload(arg *CommitInfo, content io.Reader) (res *FileMetadata, err error)
 	// UploadSessionAppend : Append more data to an upload session. A single
-	// request should not upload more than 150 MB.
+	// request should not upload more than 150 MB. The maximum size of a file
+	// one can upload to an upload session is 350 GB.
 	// Deprecated: Use `UploadSessionAppendV2` instead
 	UploadSessionAppend(arg *UploadSessionCursor, content io.Reader) (err error)
 	// UploadSessionAppendV2 : Append more data to an upload session. When the
 	// parameter close is set, this call will close the session. A single
-	// request should not upload more than 150 MB.
+	// request should not upload more than 150 MB. The maximum size of a file
+	// one can upload to an upload session is 350 GB.
 	UploadSessionAppendV2(arg *UploadSessionAppendArg, content io.Reader) (err error)
 	// UploadSessionFinish : Finish an upload session and save the uploaded data
 	// to the given file path. A single request should not upload more than 150
-	// MB.
+	// MB. The maximum size of a file one can upload to an upload session is 350
+	// GB.
 	UploadSessionFinish(arg *UploadSessionFinishArg, content io.Reader) (res *FileMetadata, err error)
 	// UploadSessionFinishBatch : This route helps you commit many files at once
 	// into a user's Dropbox. Use `uploadSessionStart` and
@@ -266,11 +269,12 @@ type Client interface {
 	// route to finish all your upload sessions in a single request.
 	// `UploadSessionStartArg.close` or `UploadSessionAppendArg.close` needs to
 	// be true for the last `uploadSessionStart` or `uploadSessionAppendV2`
-	// call. This route will return a job_id immediately and do the async commit
-	// job in background. Use `uploadSessionFinishBatchCheck` to check the job
-	// status. For the same account, this route should be executed serially.
-	// That means you should not start the next job before current job finishes.
-	// We allow up to 1000 entries in a single request.
+	// call. The maximum size of a file one can upload to an upload session is
+	// 350 GB. This route will return a job_id immediately and do the async
+	// commit job in background. Use `uploadSessionFinishBatchCheck` to check
+	// the job status. For the same account, this route should be executed
+	// serially. That means you should not start the next job before current job
+	// finishes. We allow up to 1000 entries in a single request.
 	UploadSessionFinishBatch(arg *UploadSessionFinishBatchArg) (res *UploadSessionFinishBatchLaunch, err error)
 	// UploadSessionFinishBatchCheck : Returns the status of an asynchronous job
 	// for `uploadSessionFinishBatch`. If success, it returns list of result for
@@ -281,8 +285,9 @@ type Client interface {
 	// than 150 MB.  This call starts a new upload session with the given data.
 	// You can then use `uploadSessionAppendV2` to add more data and
 	// `uploadSessionFinish` to save all the data to a file in Dropbox. A single
-	// request should not upload more than 150 MB. An upload session can be used
-	// for a maximum of 48 hours. Attempting to use an
+	// request should not upload more than 150 MB. The maximum size of a file
+	// one can upload to an upload session is 350 GB. An upload session can be
+	// used for a maximum of 48 hours. Attempting to use an
 	// `UploadSessionStartResult.session_id` with `uploadSessionAppendV2` or
 	// `uploadSessionFinish` more than 48 hours after its creation will return a
 	// `UploadSessionLookupError.not_found`.

dropbox/files/types.go

@@ -3158,7 +3158,8 @@ type UploadError struct {
 	dropbox.Tagged
 	// Path : Unable to save the uploaded contents to a file.
 	Path *UploadWriteFailed `json:"path,omitempty"`
-	// PropertiesError : The supplied property group is invalid.
+	// PropertiesError : The supplied property group is invalid. The file has
+	// uploaded without property groups.
 	PropertiesError *file_properties.InvalidPropertyGroupError `json:"properties_error,omitempty"`
 }
 
@@ -3175,7 +3176,8 @@ func (u *UploadError) UnmarshalJSON(body []byte) error {
 		dropbox.Tagged
 		// Path : Unable to save the uploaded contents to a file.
 		Path json.RawMessage `json:"path,omitempty"`
-		// PropertiesError : The supplied property group is invalid.
+		// PropertiesError : The supplied property group is invalid. The file
+		// has uploaded without property groups.
 		PropertiesError json.RawMessage `json:"properties_error,omitempty"`
 	}
 	var w wrap
@@ -3206,7 +3208,8 @@ type UploadErrorWithProperties struct {
 	dropbox.Tagged
 	// Path : Unable to save the uploaded contents to a file.
 	Path *UploadWriteFailed `json:"path,omitempty"`
-	// PropertiesError : The supplied property group is invalid.
+	// PropertiesError : The supplied property group is invalid. The file has
+	// uploaded without property groups.
 	PropertiesError *file_properties.InvalidPropertyGroupError `json:"properties_error,omitempty"`
 }
 
@@ -3223,7 +3226,8 @@ func (u *UploadErrorWithProperties) UnmarshalJSON(body []byte) error {
 		dropbox.Tagged
 		// Path : Unable to save the uploaded contents to a file.
 		Path json.RawMessage `json:"path,omitempty"`
-		// PropertiesError : The supplied property group is invalid.
+		// PropertiesError : The supplied property group is invalid. The file
+		// has uploaded without property groups.
 		PropertiesError json.RawMessage `json:"properties_error,omitempty"`
 	}
 	var w wrap
@@ -3467,14 +3471,20 @@ type UploadSessionFinishError struct {
 	// LookupFailed : The session arguments are incorrect; the value explains
 	// the reason.
 	LookupFailed *UploadSessionLookupError `json:"lookup_failed,omitempty"`
-	// Path : Unable to save the uploaded contents to a file.
+	// Path : Unable to save the uploaded contents to a file. Data has already
+	// been appended to the upload session. Please retry with empty data body
+	// and updated offset.
 	Path *WriteError `json:"path,omitempty"`
+	// PropertiesError : The supplied property group is invalid. The file has
+	// uploaded without property groups.
+	PropertiesError *file_properties.InvalidPropertyGroupError `json:"properties_error,omitempty"`
 }
 
 // Valid tag values for UploadSessionFinishError
 const (
 	UploadSessionFinishErrorLookupFailed               = "lookup_failed"
 	UploadSessionFinishErrorPath                       = "path"
+	UploadSessionFinishErrorPropertiesError            = "properties_error"
 	UploadSessionFinishErrorTooManySharedFolderTargets = "too_many_shared_folder_targets"
 	UploadSessionFinishErrorTooManyWriteOperations     = "too_many_write_operations"
 	UploadSessionFinishErrorOther                      = "other"
@@ -3487,8 +3497,13 @@ func (u *UploadSessionFinishError) UnmarshalJSON(body []byte) error {
 		// LookupFailed : The session arguments are incorrect; the value
 		// explains the reason.
 		LookupFailed json.RawMessage `json:"lookup_failed,omitempty"`
-		// Path : Unable to save the uploaded contents to a file.
+		// Path : Unable to save the uploaded contents to a file. Data has
+		// already been appended to the upload session. Please retry with empty
+		// data body and updated offset.
 		Path json.RawMessage `json:"path,omitempty"`
+		// PropertiesError : The supplied property group is invalid. The file
+		// has uploaded without property groups.
+		PropertiesError json.RawMessage `json:"properties_error,omitempty"`
 	}
 	var w wrap
 	var err error
@@ -3506,6 +3521,12 @@ func (u *UploadSessionFinishError) UnmarshalJSON(body []byte) error {
 	case "path":
 		err = json.Unmarshal(w.Path, &u.Path)
 
+		if err != nil {
+			return err
+		}
+	case "properties_error":
+		err = json.Unmarshal(w.PropertiesError, &u.PropertiesError)
+
 		if err != nil {
 			return err
 		}
@@ -3529,6 +3550,7 @@ const (
 	UploadSessionLookupErrorIncorrectOffset = "incorrect_offset"
 	UploadSessionLookupErrorClosed          = "closed"
 	UploadSessionLookupErrorNotClosed       = "not_closed"
+	UploadSessionLookupErrorTooLarge        = "too_large"
 	UploadSessionLookupErrorOther           = "other"
 )
 
@@ -3605,8 +3627,9 @@ func NewUploadSessionStartResult(SessionId string) *UploadSessionStartResult {
 type UploadWriteFailed struct {
 	// Reason : The reason why the file couldn't be saved.
 	Reason *WriteError `json:"reason"`
-	// UploadSessionId : The upload session ID; this may be used to retry the
-	// commit.
+	// UploadSessionId : The upload session ID; data has already been uploaded
+	// to the corresponding upload session and this ID may be used to retry the
+	// commit with `uploadSessionFinish`.
 	UploadSessionId string `json:"upload_session_id"`
 }
 

dropbox/paper/client.go

@@ -52,9 +52,9 @@ type Client interface {
 	// DocsGetFolderInfo : Retrieves folder information for the given Paper doc.
 	// This includes:   - folder sharing policy; permissions for subfolders are
 	// set by the top-level folder.   - full 'filepath', i.e. the list of
-	// folders (both folderId and folderName) from the root folder to the folder
-	// directly containing the Paper doc.  Note: If the Paper doc is not in any
-	// folder (aka unfiled) the response will be empty.
+	// folders (both folderId and folderName) from     the root folder to the
+	// folder directly containing the Paper doc.  Note: If the Paper doc is not
+	// in any folder (aka unfiled) the response will be empty.
 	DocsGetFolderInfo(arg *RefPaperDoc) (res *FoldersContainingPaperDoc, err error)
 	// DocsList : Return the list of all Paper docs according to the argument
 	// specifications. To iterate over through the full pagination, pass the

dropbox/sdk.go

@@ -36,8 +36,8 @@ const (
 	hostAPI       = "api"
 	hostContent   = "content"
 	hostNotify    = "notify"
-	sdkVersion    = "4.6.0"
-	specVersion   = "ffd6841"
+	sdkVersion    = "4.2.0"
+	specVersion   = "222ba8c"
 )
 
 // Version returns the current SDK version and API Spec version

dropbox/team/types.go

@@ -1947,6 +1947,8 @@ type MemberAddArg struct {
 	SendWelcomeEmail bool `json:"send_welcome_email"`
 	// Role : has no documentation (yet)
 	Role *AdminTier `json:"role"`
+	// IsDirectoryRestricted : Whether a user is directory restricted.
+	IsDirectoryRestricted bool `json:"is_directory_restricted,omitempty"`
 }
 
 // NewMemberAddArg returns a new MemberAddArg instance
@@ -2161,6 +2163,8 @@ type MemberProfile struct {
 	// PersistentId : Persistent ID that a team can attach to the user. The
 	// persistent ID is unique ID to be used for SAML authentication.
 	PersistentId string `json:"persistent_id,omitempty"`
+	// IsDirectoryRestricted : Whether the user is a directory restricted user.
+	IsDirectoryRestricted bool `json:"is_directory_restricted,omitempty"`
 }
 
 // NewMemberProfile returns a new MemberProfile instance
@@ -2640,6 +2644,9 @@ type MembersSetProfileArg struct {
 	// NewPersistentId : New persistent ID. This field only available to teams
 	// using persistent ID SAML configuration.
 	NewPersistentId string `json:"new_persistent_id,omitempty"`
+	// NewIsDirectoryRestricted : New value for whether the user is a directory
+	// restricted user.
+	NewIsDirectoryRestricted bool `json:"new_is_directory_restricted,omitempty"`
 }
 
 // NewMembersSetProfileArg returns a new MembersSetProfileArg instance
@@ -2666,6 +2673,7 @@ const (
 	MembersSetProfileErrorParamCannotBeEmpty               = "param_cannot_be_empty"
 	MembersSetProfileErrorPersistentIdDisabled             = "persistent_id_disabled"
 	MembersSetProfileErrorPersistentIdUsedByOtherUser      = "persistent_id_used_by_other_user"
+	MembersSetProfileErrorDirectoryRestrictedOff           = "directory_restricted_off"
 	MembersSetProfileErrorOther                            = "other"
 )
 

dropbox/team_log/client.go

@@ -33,7 +33,12 @@ import (
 type Client interface {
 	// GetEvents : Retrieves team events. Events have a lifespan of two years.
 	// Events older than two years will not be returned. Many attributes note
-	// 'may be missing due to historical data gap'. Permission : Team Auditing.
+	// 'may be missing due to historical data gap'. Note that the
+	// file_operations category and & analogous paper events are not available
+	// on all Dropbox Business `plans` </business/plans-comparison>. Use
+	// `features/get_values`
+	// </developers/documentation/http/teams#team-features-get_values> to check
+	// for this feature. Permission : Team Auditing.
 	GetEvents(arg *GetTeamEventsArg) (res *GetTeamEventsResult, err error)
 	// GetEventsContinue : Once a cursor has been retrieved from `getEvents`,
 	// use this to paginate through all events. Permission : Team Auditing.