Personal Cloud Storage SDK for Android Version 1.8 Release Guide

Release date 01/12/2017

Contents

Introduction

The following features are included in this release. Refer to the sections below for detailed listing of supported APIs.

The SDK Hubble Media Browser Kepler File Manager
Authentication and authorization Authentication and authorization Authentication and authorization
Account information Account information Account information
Contacts* Contacts* Contacts
Favorites Favorites
File and folder operations File and folder operations File and folder operations
Log Log
Playlists Playlists
Shares Shares
Tags Tags
Trash Can Trash Can
Virtual Folder Virtual Folder

* Updated in this release to enable contacts search.

The SDK

Supported API Calls

The gateway to access Personal Cloud Storage APIs is the CloudAPI class. Included in this class are all main methods that you can use to make the API calls.

  • Authentication and Authorization
    • authorize - authenticates the user and authorizes the application to access user’s cloud content through Verizon Personal Cloud Storage APIs.
    • getAccessToken - allow you to retrieve the access token.
    • hasAuthorization - verifies if the user is authorized.
    • logout - logs the user out from the current session.
  • Account Information
    • getAccountInfo - retrieves the information about user’s cloud account.
  • Contacts
    • getContacts - retrieves the contacts information stored under user’s cloud storage account.
  • Favorites
    • deleteFavorite - deletes favorites.
    • getFavorites - retrieves favorites.
    • setFavorites - adds to favorites.
  • File and Folder Operations
    • DELETE /fops/delete - deletes a file or a folder at a specified path.
    • POST /fops/copy -creates a copy of a file or folder.
    • POST /fops/createfolder - creates a folder at a given path.
    • POST /fops/move - moves a file or folder.
    • POST /fops/rename - renames a file or a folder.
    • downloadFile - retrieves the binary content of a file.
    • getMetadata - obtains metadata for files and folders in a user’s folder.
    • getThumbnail - retrieves the thumbnail for a file stored under user’s cloud storage account.
    • search - searches for files of folders. The SDK supports both Lucene and SQL query syntax.
    • uploadFile - uploads a file to user’s Verizon Personal Cloud Storage account.
  • Log

    • setLogLevel - sets log level.
  • Playlists

    • addToPlaylist - adds items to an existing playlist.
    • createPlaylist - creates a playlist.
    • deletePlaylist - deletes an existing playlist.
    • deletePlaylistItem - deletes an item from a playlist.
    • updatePlaylist - updates a playlist’s name.
    • updatePlaylistDefinition - updates current playlist definition.
  • Shares

    • createShare - creates a share.
    • deleteShare - deletes a share.
    • getShares - lists user’s shares.
  • Tags

    • deleteTags - deletes tags.
    • getTags - retrieves tags.
    • setTags - updates tags.
  • Trash Can

    • getTrash - retrieves a list of files and folders that have been deleted.
    • purgeTrash - purges all the files and folder that are in a deleted state.
    • restoreTrash - restores files and folders from trash to their original location.
  • Virtual Folder

    • createVirtualFolder - creates a virtual folder.
    • renameVirtualFolder - renames a virtual folder.
    • deleteVirtualFolder - deletes a virtual folder.

Classes

  • CloudAPI - gateway to access Personal Cloud Storage APIs. Included in this class are all main methods that you can use to make the API calls.
  • ShareResource - stores details of a share resource.

Interfaces

Exceptions

  • CloudAPIException - general exception class forwarded to the view layer informing the user of abnormal runtime behavior.
  • SearchException - generic exception class for all exceptions thrown from inside Search aAPI call.

Enums

Hubble Media Browser

The gateway to access Personal Cloud Storage APIs is the CloudAPI class. Included in this class are all main methods that you can use to make the API calls.

Supported API Calls

  • Authentication and Authorization
    • authorize - authenticates the user and authorizes the application to access user’s cloud content through Verizon Personal Cloud Storage APIs.
    • hasAuthorization - verifies if the user is authorized.
    • logout - logs the user out from the current session.
  • Account Information
    • getAccountInfo - retrieves the information about user’s cloud account.
  • Contacts
    • getContacts - retrieves the contacts information stored under user’s cloud storage account.
  • Favorites
    • deleteFavorite - deletes favorites.
    • getFavorites - retrieves favorites.
    • setFavorites - adds to favorites.
  • File and Folder Operations
    • downloadFile - retrieves the binary content of a file.
    • getThumbnail - retrieves the thumbnail for a file stored under user’s cloud storage account.
    • fullview - retrieves the information about all files and folders.
    • search - searches for files of folders. The SDK supports both Lucene and SQL query syntax.
    • uploadFile - uploads a file to user’s Verizon Personal Cloud Storage account.
  • Log
    • setLogLevel - sets log level.
  • Playlists
    • addToPlaylist - adds items to an existing playlist.
    • createPlaylist - creates a playlist.
    • deletePlaylist - deletes an existing playlist.
    • deletePlaylistItem - deletes an item from a playlist.
    • updatePlaylist - updates a playlist’s name.
    • updatePlaylistDefinition - updates current playlist definition.
  • Shares
    • createShare - creates a share.
    • deleteShare - deletes a share.
    • getShares - lists user’s shares.
  • Tags
    • deleteTags - deletes tags.
    • getTags - retrieves tags.
    • setTags - updates tags.

Kepler File Manager

Supported API Calls

The gateway to access Personal Cloud Storage APIs is the CloudAPI class. Included in this class are all main methods that you can use to make the API calls.

  • Authentication and Authorization
    • authorize - authenticates the user and authorizes the application to access user’s cloud content through Verizon Personal Cloud Storage APIs.
    • hasAuthorization - verifies if the user is authorized.
    • logout - logs the user out from the current session.
  • Account Information
    • getAccountInfo - retrieves the information about user’s cloud account.
  • File and Folder Operations
    • DELETE /fops/delete - deletes a file or a folder at a specified path.
    • POST /fops/copy - creates a copy of a file or folder.
    • POST /fops/createfolder - creates a folder at a given path.
    • POST /fops/move - moves a file or folder.
    • POST /fops/rename - renames a file or a folder.
    • downloadFile - retrieves the binary content of a file.
    • getMetadata - obtains metadata for files and folders in a user’s folder.
    • getThumbnail - retrieves the thumbnail for a file stored under user’s cloud storage account.
    • search - searches for files of folders. The SDK supports both Lucene and SQL query syntax.
    • uploadFile - uploads a file to user’s Verizon Personal Cloud Storage account.
  • Trash Can
    • getTrash - retrieves a list of files and folders that have been deleted.
    • purgeTrash - purges all the files and folder that are in a deleted state.
    • restoreTrash - restores files and folders from trash to their original location.
  • Virtual Folder
    • createVirtualFolder - creates a virtual folder.
    • renameVirtualFolder - renames a virtual folder.
    • deleteVirtualFolder - deletes a virtual folder.

Copyright © 2015-2017, Verizon and/or its Licensors. All rights reserved.