DriveApi

Retrieves a DriveId object that can be used in further drive api operations (e.g. getFile, getFolder). An error result will be returned if the given resource ID does not exist.

Returns a DriveFolder object that can be used to interact with the App Folder.

The App Folder is a special folder that is only accessible by your application. Its content is hidden from the user and from other apps. Despite being hidden from the user, the App Folder is stored on the user's Drive and therefore uses the user's Drive storage quota.

The App Folder can be used to store configuration files, temporary files, or any other types of files that belong to the user but should not be tampered with.

The AppData scope is required to access this folder. If the app does not have SCOPE_APPFOLDER it will return null.

See the App Folder developer guide for more information.

This method will return synchronously, and is safe to invoke from the UI thread.

Returns a DriveFolder object that can be used to interact with the root folder. This method will return synchronously, and is safe to invoke from the UI thread.

SCOPE_FILE is required to access this folder. If the app only has SCOPE_APPFOLDER it will return null.

Creates a builder for a Create File activity where a user can select a file name and destination for a new binary file in their Drive with the contents and additional metadata provided in the builder.

This method requires authorization with at least one of the following scopes: SCOPE_FILE. Otherwise, a RuntimeException will be thrown when the builder is built.

Retrieves a new DriveContents instance that can be used to provide initial contents for a new file. The returned contents will be in MODE_WRITE_ONLY and can be used to write the initial contents through the file APIs provided in DriveContents.

To be persisted, the contents must be saved by being passed as initial contents to createFile(GoogleApiClient, MetadataChangeSet, DriveContents) or setInitialDriveContents(DriveContents).

To discard the contents without saving them, invoke discard(GoogleApiClient).

Creates a builder for an Open File activity that allows user selection of a Drive file. Upon completion, the result Intent will contain the DriveId for the selected file. This activity will authorize the requesting app to interact with the selected file.

This method requires authorization with at least one of the following scopes: SCOPE_FILE. Otherwise, a RuntimeException will be thrown when the builder is built.

Retrieves a collection of metadata for the files and folders that match the specified query.

Requests synchronization with the server to download any metadata changes that occurred since the last sync with the server.

Typically you'd call this method when the user asks to refresh their list of files. Waiting on the PendingResult and then performing a query will return fresh results.

In order to avoid excessive load on the device and the server, sync requests are rate limited. In this case, the operation will fail with DRIVE_RATE_LIMIT_EXCEEDED status, which indicates that a sync already happened quite recently so there is no need for another sync. The operation will succeed when reattempted after a sufficient backoff duration.