Package com.smartsheet.api

Interface HomeResources

  • @Deprecated(since="3.4.0",
            forRemoval=true)
public interface HomeResources
    Deprecated, for removal: This API element is subject to removal in a future version.
    Home resources have been deprecated and will be removed in a future version.

    This interface provides methods to access Home resources.

    Thread Safety: Implementation of this interface must be thread safe.

    • Method Summary

      All Methods Instance Methods Abstract Methods Deprecated Methods 
      Modifier and Type Method Description
      HomeFolderResources folderResources()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Home resources have been deprecated and will be removed in a future version.
      Home getHome​(java.util.EnumSet<SourceInclusion> includes)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Home resources have been deprecated and will be removed in a future version.
      Home getHome​(java.util.EnumSet<SourceInclusion> includes, java.util.EnumSet<SourceExclusion> excludes)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Home resources have been deprecated and will be removed in a future version.

    • Method Detail

      • getHome

        @Deprecated(since="3.4.0",
            forRemoval=true)
Home getHome​(java.util.EnumSet<SourceInclusion> includes)
      throws SmartsheetException
        Deprecated, for removal: This API element is subject to removal in a future version.
        Home resources have been deprecated and will be removed in a future version.

        Get a nested list of all Home objects, including sheets, workspaces and folders, and optionally reports and/or templates, as shown on the Home tab.

        It mirrors to the following Smartsheet REST API method: GET /home

        Parameters:
        includes - used to specify the optional objects to include.
        Returns:
        the home resource (note that if there is no such resource, this method will throw ResourceNotFoundException rather than returning null).
        Throws:
        java.lang.IllegalArgumentException - if any argument is null or empty string
        InvalidRequestException - if there is any problem with the REST API request
        AuthorizationException - if there is any problem with the REST API authorization (access token)
        ResourceNotFoundException - if the resource cannot be found
        ServiceUnavailableException - if the REST API service is not available (possibly due to rate limiting)
        SmartsheetException - if there is any other error during the operation

      • getHome

        @Deprecated(since="3.4.0",
            forRemoval=true)
Home getHome​(java.util.EnumSet<SourceInclusion> includes,
             java.util.EnumSet<SourceExclusion> excludes)
      throws SmartsheetException
        Deprecated, for removal: This API element is subject to removal in a future version.
        Home resources have been deprecated and will be removed in a future version.

        Get a nested list of all Home objects, including sheets, workspaces and folders, and optionally reports and/or templates, as shown on the Home tab.

        It mirrors to the following Smartsheet REST API method: GET /home

        Parameters:
        includes - used to specify the optional objects to include.
        excludes - used to specify the optional objects to exclude.
        Returns:
        the home resource (note that if there is no such resource, this method will throw ResourceNotFoundException rather than returning null).
        Throws:
        java.lang.IllegalArgumentException - if any argument is null or empty string
        InvalidRequestException - if there is any problem with the REST API request
        AuthorizationException - if there is any problem with the REST API authorization (access token)
        ResourceNotFoundException - if the resource cannot be found
        ServiceUnavailableException - if the REST API service is not available (possibly due to rate limiting)
        SmartsheetException - if there is any other error during the operation

      • folderResources

        @Deprecated(since="3.4.0",
            forRemoval=true)
HomeFolderResources folderResources()
        Deprecated, for removal: This API element is subject to removal in a future version.
        Home resources have been deprecated and will be removed in a future version.

        Return the HomeFolderResources object that provides access to Folder resources under home.

        Returns:
        the home folder resources