com.dropbox.core.v2.paper

Class DbxUserPaperRequests

java.lang.Object

com.dropbox.core.v2.paper.DbxUserPaperRequests

public class DbxUserPaperRequests
extends java.lang.Object

Routes in namespace "paper".

Constructor Summary

Constructors

Constructor and Description
DbxUserPaperRequests(DbxRawClientV2 client)

Method Summary

Modifier and Type	Method and Description
void	docsArchive(java.lang.String docId) Deprecated.
DocsCreateUploader	docsCreate(ImportFormat importFormat) Deprecated.
DocsCreateUploader	docsCreate(ImportFormat importFormat, java.lang.String parentFolderId) Deprecated.
DbxDownloader<PaperDocExportResult>	docsDownload(java.lang.String docId, ExportFormat exportFormat) Deprecated.
DocsDownloadBuilder	docsDownloadBuilder(java.lang.String docId, ExportFormat exportFormat) Deprecated.
ListUsersOnFolderResponse	docsFolderUsersList(java.lang.String docId) Deprecated.
ListUsersOnFolderResponse	docsFolderUsersList(java.lang.String docId, int limit) Deprecated.
ListUsersOnFolderResponse	docsFolderUsersListContinue(java.lang.String docId, java.lang.String cursor) Deprecated.
FoldersContainingPaperDoc	docsGetFolderInfo(java.lang.String docId) Deprecated.
ListPaperDocsResponse	docsList() Deprecated.
DocsListBuilder	docsListBuilder() Deprecated.
ListPaperDocsResponse	docsListContinue(java.lang.String cursor) Deprecated.
void	docsPermanentlyDelete(java.lang.String docId) Deprecated.
SharingPolicy	docsSharingPolicyGet(java.lang.String docId) Deprecated.
void	docsSharingPolicySet(java.lang.String docId, SharingPolicy sharingPolicy) Deprecated.
DocsUpdateUploader	docsUpdate(java.lang.String docId, PaperDocUpdatePolicy docUpdatePolicy, long revision, ImportFormat importFormat) Deprecated.
java.util.List<AddPaperDocUserMemberResult>	docsUsersAdd(java.lang.String docId, java.util.List<AddMember> members) Deprecated.
DocsUsersAddBuilder	docsUsersAddBuilder(java.lang.String docId, java.util.List<AddMember> members) Deprecated.
ListUsersOnPaperDocResponse	docsUsersList(java.lang.String docId) Deprecated.
DocsUsersListBuilder	docsUsersListBuilder(java.lang.String docId) Deprecated.
ListUsersOnPaperDocResponse	docsUsersListContinue(java.lang.String docId, java.lang.String cursor) Deprecated.
void	docsUsersRemove(java.lang.String docId, MemberSelector member) Deprecated.
PaperFolderCreateResult	foldersCreate(java.lang.String name) Deprecated.
FoldersCreateBuilder	foldersCreateBuilder(java.lang.String name) Deprecated.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DbxUserPaperRequests

public DbxUserPaperRequests(DbxRawClientV2 client)

Method Detail

docsArchive

@Deprecated
public void docsArchive(java.lang.String docId)
                             throws DocLookupErrorException,
                                    DbxException

Deprecated.

Marks the given Paper doc as archived.

This action can be performed or undone by anyone with edit permissions to the doc.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

This endpoint will be retired in September 2020. Refer to the Paper Migration Guide for more information.

Parameters:

docId - The Paper doc ID. Must not be null.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DocLookupErrorException

DbxException

docsCreate

@Deprecated
public DocsCreateUploader docsCreate(ImportFormat importFormat)
                                          throws DbxException

Deprecated.

Creates a new Paper doc with the provided content.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

This endpoint will be retired in September 2020. Refer to the Paper Migration Guide for more information.

Parameters:

importFormat - The format of provided data. Must not be null.

Returns:

Uploader used to upload the request body and finish request.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DbxException

docsCreate

@Deprecated
public DocsCreateUploader docsCreate(ImportFormat importFormat,
                                                 java.lang.String parentFolderId)
                                          throws DbxException

Deprecated.

Creates a new Paper doc with the provided content.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

This endpoint will be retired in September 2020. Refer to the Paper Migration Guide for more information.

Parameters:

importFormat - The format of provided data. Must not be null.

parentFolderId - The Paper folder ID where the Paper document should be created. The API user has to have write access to this folder or error is thrown.

Returns:

Uploader used to upload the request body and finish request.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DbxException

docsDownload

@Deprecated
public DbxDownloader<PaperDocExportResult> docsDownload(java.lang.String docId,
                                                                    ExportFormat exportFormat)
                                                             throws DocLookupErrorException,
                                                                    DbxException

Deprecated.

Exports and downloads Paper doc either as HTML or markdown.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

Parameters:

docId - The Paper doc ID. Must not be null.

exportFormat - Must not be null.

Returns:

Downloader used to download the response body and view the server response.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DocLookupErrorException

DbxException

docsDownloadBuilder

@Deprecated
public DocsDownloadBuilder docsDownloadBuilder(java.lang.String docId,
                                                           ExportFormat exportFormat)

Deprecated.

Exports and downloads Paper doc either as HTML or markdown. Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper. Refer to the Paper Migration Guide for migration information.

Parameters:

docId - The Paper doc ID. Must not be null.

exportFormat - Must not be null.

Returns:

Downloader builder for configuring the request parameters and instantiating a downloader.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

docsFolderUsersList

@Deprecated
public ListUsersOnFolderResponse docsFolderUsersList(java.lang.String docId)
                                                          throws DocLookupErrorException,
                                                                 DbxException

Deprecated.

Lists the users who are explicitly invited to the Paper folder in which the Paper doc is contained. For private folders all users (including owner) shared on the folder are listed and for team folders all non-team users shared on the folder are returned.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

The limit request parameter will default to 1000 (see docsFolderUsersList(String,int)).

Parameters:

docId - The Paper doc ID. Must not be null.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DocLookupErrorException

DbxException

docsFolderUsersList

@Deprecated
public ListUsersOnFolderResponse docsFolderUsersList(java.lang.String docId,
                                                                 int limit)
                                                          throws DocLookupErrorException,
                                                                 DbxException

Deprecated.

Lists the users who are explicitly invited to the Paper folder in which the Paper doc is contained. For private folders all users (including owner) shared on the folder are listed and for team folders all non-team users shared on the folder are returned.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

Parameters:

docId - The Paper doc ID. Must not be null.

limit - Size limit per batch. The maximum number of users that can be retrieved per batch is 1000. Higher value results in invalid arguments error. Must be greater than or equal to 1 and be less than or equal to 1000.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DocLookupErrorException

DbxException

docsFolderUsersListContinue

@Deprecated
public ListUsersOnFolderResponse docsFolderUsersListContinue(java.lang.String docId,
                                                                         java.lang.String cursor)
                                                                  throws ListUsersCursorErrorException,
                                                                         DbxException

Deprecated.

Once a cursor has been retrieved from docsFolderUsersList(String,int), use this to paginate through all users on the Paper folder.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

Parameters:

docId - The Paper doc ID. Must not be null.

cursor - The cursor obtained from docsFolderUsersList(String,int) or docsFolderUsersListContinue(String,String). Allows for pagination. Must not be null.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

ListUsersCursorErrorException

DbxException

docsGetFolderInfo

@Deprecated
public FoldersContainingPaperDoc docsGetFolderInfo(java.lang.String docId)
                                                        throws DocLookupErrorException,
                                                               DbxException

Deprecated.

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.

If the Paper doc is not in any folder (aka unfiled) the response will be empty.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

Parameters:

docId - The Paper doc ID. Must not be null.

Returns:

Metadata about Paper folders containing the specififed Paper doc.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DocLookupErrorException

DbxException

docsList

@Deprecated
public ListPaperDocsResponse docsList()
                                           throws DbxApiException,
                                                  DbxException

Deprecated.

Return the list of all Paper docs according to the argument specifications. To iterate over through the full pagination, pass the cursor to docsListContinue(String).

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

The default values for the optional request parameters will be used. See DocsListBuilder for more details.

Throws:

DbxApiException

DbxException

docsListBuilder

@Deprecated
public DocsListBuilder docsListBuilder()

Deprecated.

Return the list of all Paper docs according to the argument specifications. To iterate over through the full pagination, pass the cursor to docsListContinue(String). Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper. Refer to the Paper Migration Guide for migration information.

Returns:

Request builder for configuring request parameters and completing the request.

docsListContinue

@Deprecated
public ListPaperDocsResponse docsListContinue(java.lang.String cursor)
                                                   throws ListDocsCursorErrorException,
                                                          DbxException

Deprecated.

Once a cursor has been retrieved from docsList(com.dropbox.core.v2.paper.ListPaperDocsArgs), use this to paginate through all Paper doc.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

Parameters:

cursor - The cursor obtained from docsList(com.dropbox.core.v2.paper.ListPaperDocsArgs) or docsListContinue(String). Allows for pagination. Must not be null.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

ListDocsCursorErrorException

DbxException

docsPermanentlyDelete

@Deprecated
public void docsPermanentlyDelete(java.lang.String docId)
                                       throws DocLookupErrorException,
                                              DbxException

Deprecated.

Permanently deletes the given Paper doc. This operation is final as the doc cannot be recovered.

This action can be performed only by the doc owner.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

Parameters:

docId - The Paper doc ID. Must not be null.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DocLookupErrorException

DbxException

docsSharingPolicyGet

@Deprecated
public SharingPolicy docsSharingPolicyGet(java.lang.String docId)
                                               throws DocLookupErrorException,
                                                      DbxException

Deprecated.

Gets the default sharing policy for the given Paper doc.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

Parameters:

docId - The Paper doc ID. Must not be null.

Returns:

Sharing policy of Paper doc.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DocLookupErrorException

DbxException

docsSharingPolicySet

@Deprecated
public void docsSharingPolicySet(java.lang.String docId,
                                             SharingPolicy sharingPolicy)
                                      throws DocLookupErrorException,
                                             DbxException

Deprecated.

Sets the default sharing policy for the given Paper doc. The default 'team_sharing_policy' can be changed only by teams, omit this field for personal accounts.

The 'public_sharing_policy' policy can't be set to the value 'disabled' because this setting can be changed only via the team admin console.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

Parameters:

docId - The Paper doc ID. Must not be null.

sharingPolicy - The default sharing policy to be set for the Paper doc. Must not be null.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DocLookupErrorException

DbxException

docsUpdate

@Deprecated
public DocsUpdateUploader docsUpdate(java.lang.String docId,
                                                 PaperDocUpdatePolicy docUpdatePolicy,
                                                 long revision,
                                                 ImportFormat importFormat)
                                          throws DbxException

Deprecated.

Updates an existing Paper doc with the provided content.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

This endpoint will be retired in September 2020. Refer to the Paper Migration Guide for more information.

Parameters:

docId - The Paper doc ID. Must not be null.

docUpdatePolicy - The policy used for the current update call. Must not be null.

revision - The latest doc revision. This value must match the head revision or an error code will be returned. This is to prevent colliding writes.

importFormat - The format of provided data. Must not be null.

Returns:

Uploader used to upload the request body and finish request.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DbxException

docsUsersAdd

@Deprecated
public java.util.List<AddPaperDocUserMemberResult> docsUsersAdd(java.lang.String docId,
                                                                            java.util.List<AddMember> members)
                                                                     throws DocLookupErrorException,
                                                                            DbxException

Deprecated.

Allows an owner or editor to add users to a Paper doc or change their permissions using their email address or Dropbox account ID.

The doc owner's permissions cannot be changed.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

The default values for the optional request parameters will be used. See DocsUsersAddBuilder for more details.

Parameters:

docId - The Paper doc ID. Must not be null.

members - User which should be added to the Paper doc. Specify only email address or Dropbox account ID. Must contain at most 20 items, not contain a null item, and not be null.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DocLookupErrorException

DbxException

docsUsersAddBuilder

@Deprecated
public DocsUsersAddBuilder docsUsersAddBuilder(java.lang.String docId,
                                                           java.util.List<AddMember> members)

Deprecated.

Allows an owner or editor to add users to a Paper doc or change their permissions using their email address or Dropbox account ID. The doc owner's permissions cannot be changed. Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper. Refer to the Paper Migration Guide for migration information.

Parameters:

docId - The Paper doc ID. Must not be null.

members - User which should be added to the Paper doc. Specify only email address or Dropbox account ID. Must contain at most 20 items, not contain a null item, and not be null.

Returns:

Request builder for configuring request parameters and completing the request.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

docsUsersList

@Deprecated
public ListUsersOnPaperDocResponse docsUsersList(java.lang.String docId)
                                                      throws DocLookupErrorException,
                                                             DbxException

Deprecated.

Lists all users who visited the Paper doc or users with explicit access. This call excludes users who have been removed. The list is sorted by the date of the visit or the share date.

The list will include both users, the explicitly shared ones as well as those who came in using the Paper url link.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

The default values for the optional request parameters will be used. See DocsUsersListBuilder for more details.

Parameters:

docId - The Paper doc ID. Must not be null.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DocLookupErrorException

DbxException

docsUsersListBuilder

@Deprecated
public DocsUsersListBuilder docsUsersListBuilder(java.lang.String docId)

Deprecated.

Lists all users who visited the Paper doc or users with explicit access. This call excludes users who have been removed. The list is sorted by the date of the visit or the share date. The list will include both users, the explicitly shared ones as well as those who came in using the Paper url link. Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper. Refer to the Paper Migration Guide for migration information.

Parameters:

docId - The Paper doc ID. Must not be null.

Returns:

Request builder for configuring request parameters and completing the request.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

docsUsersListContinue

@Deprecated
public ListUsersOnPaperDocResponse docsUsersListContinue(java.lang.String docId,
                                                                     java.lang.String cursor)
                                                              throws ListUsersCursorErrorException,
                                                                     DbxException

Deprecated.

Once a cursor has been retrieved from docsUsersList(String), use this to paginate through all users on the Paper doc.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

Parameters:

docId - The Paper doc ID. Must not be null.

cursor - The cursor obtained from docsUsersList(String) or docsUsersListContinue(String,String). Allows for pagination. Must not be null.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

ListUsersCursorErrorException

DbxException

docsUsersRemove

@Deprecated
public void docsUsersRemove(java.lang.String docId,
                                        MemberSelector member)
                                 throws DocLookupErrorException,
                                        DbxException

Deprecated.

Allows an owner or editor to remove users from a Paper doc using their email address or Dropbox account ID.

The doc owner cannot be removed.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

Parameters:

docId - The Paper doc ID. Must not be null.

member - User which should be removed from the Paper doc. Specify only email address or Dropbox account ID. Must not be null.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

DocLookupErrorException

DbxException

foldersCreate

@Deprecated
public PaperFolderCreateResult foldersCreate(java.lang.String name)
                                                  throws PaperFolderCreateErrorException,
                                                         DbxException

Deprecated.

Create a new Paper folder with the provided info.

Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper.

Refer to the Paper Migration Guide for migration information.

Parameters:

name - The name of the new Paper folder. Must not be null.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.

PaperFolderCreateErrorException

DbxException

foldersCreateBuilder

@Deprecated
public FoldersCreateBuilder foldersCreateBuilder(java.lang.String name)

Deprecated.

Create a new Paper folder with the provided info. Note that this endpoint will continue to work for content created by users on the older version of Paper. To check which version of Paper a user is on, use /users/features/get_values. If the paper_as_files feature is enabled, then the user is running the new version of Paper. Refer to the Paper Migration Guide for migration information.

Parameters:

name - The name of the new Paper folder. Must not be null.

Returns:

Request builder for configuring request parameters and completing the request.

Throws:

java.lang.IllegalArgumentException - If any argument does not meet its preconditions.