DriveFolder | Android Developers

Quicknav Quicknav
Links

- Google Play Developer Console
- Android Developers Blog
- About Android

Android Sites

- Android.com
- Android Developers
- Android Open Source Project

Language
close

- - About
  - Wear
  - TV
  - Auto
- - Get Started
  - Devices
  - Style
  - Patterns
  - Building Blocks
  - Downloads
  - Videos
- - Training
  - API Guides
  - Reference
  - Tools
  - Google Services
  - Samples
- - Google Play
  - Essentials
  - Get Users
  - Engage & Retain
  - Monetize
  - Tools & Reference
  - Developer Stories

## Results

Loading...
Summary: Nested Classes | Constants | Methods | Inherited Methods | [Expand All]
public interface

# DriveFolder

implements DriveResource

com.google.android.gms.drive.DriveFolder

## Class Overview

A folder in Drive. This class provides access to list or query the contents of the folder, or create new resources within it.

To retrieve a DriveFolder from a known drive id, use `getFolder(GoogleApiClient, DriveId)`.

## Summary

Nested Classes
interface | DriveFolder.DriveFileResult | A result that contains a DriveFile.
interface | DriveFolder.DriveFolderResult | A result that contains a DriveFolder.

Constants
String | MIME_TYPE | The MIME type associated with folder resources.

Public Methods
abstract PendingResult<DriveFolder.DriveFileResult> | createFile(GoogleApiClient apiClient, MetadataChangeSet changeSet, Contents contents) Creates a new binary file within this folder, with the provided initial metadata and contents.
abstract PendingResult<DriveFolder.DriveFolderResult> | createFolder(GoogleApiClient apiClient, MetadataChangeSet changeSet) Creates a new folder within this folder, with the provided initial metadata.
abstract PendingResult<DriveApi.MetadataBufferResult> | listChildren(GoogleApiClient apiClient) Retrieves a collection of metadata for the direct children of this folder.
abstract PendingResult<DriveApi.MetadataBufferResult> | queryChildren(GoogleApiClient apiClient, Query query) Retrieves a collection of metadata for the all authorized direct children of this folder.

[Expand] Inherited Methods
From interface com.google.android.gms.drive.DriveResource
abstract PendingResult<Status> | addChangeListener(GoogleApiClient apiClient, Listener<ChangeEvent> listener) Adds a new listener for changes on this resources.
abstract DriveId | getDriveId() Returns the DriveId that uniquely identifies this resource.
abstract PendingResult<DriveResource.MetadataResult> | getMetadata(GoogleApiClient apiClient) Retrieves the Metadata that is associated with this resource.
abstract PendingResult<DriveApi.MetadataBufferResult> | listParents(GoogleApiClient apiClient) Retrieves a collection of metadata for all of the parents of this resource that the calling app has been authorized to view.
abstract PendingResult<Status> | removeChangeListener(GoogleApiClient apiClient, Listener<ChangeEvent> listener) Removes a listener for changes on this resource that was previously added by `addChangeListener(GoogleApiClient, DriveEvent.Listener)`.
abstract PendingResult<DriveResource.MetadataResult> | updateMetadata(GoogleApiClient apiClient, MetadataChangeSet changeSet) Updates the Metadata that is associated with this resource with the changes described in the `MetadataChangeSet`.

## Constants

#### public static final String MIME_TYPE

The MIME type associated with folder resources.

Constant Value: "application/vnd.google-apps.folder"

## Public Methods

#### public abstract PendingResult<DriveFolder.DriveFileResult> createFile (GoogleApiClient apiClient, MetadataChangeSet changeSet, Contents contents)

Creates a new binary file within this folder, with the provided initial metadata and contents. See `DriveFile` for more details on binary files.

##### Parameters

apiClient | The `GoogleApiClient` to service the call. The client must be connected before invoking this method.
changeSet | A set of metadata fields that should be initially set. This should minimally include a title and mime type.
contents | The initial contents.

##### Returns

- A PendingResult which can be used to retrieve the newly created DriveFile.

#### public abstract PendingResult<DriveFolder.DriveFolderResult> createFolder (GoogleApiClient apiClient, MetadataChangeSet changeSet)

Creates a new folder within this folder, with the provided initial metadata.

##### Parameters

apiClient | The `GoogleApiClient` to service the call. The client must be connected before invoking this method.
changeSet | A set of metadata fields that should be initially set. This should minimally include a title. The mime type will be set to the folder mime type.

##### Returns

- A PendingResult which can be used to retrieve the newly created DriveFile.

#### public abstract PendingResult<DriveApi.MetadataBufferResult> listChildren (GoogleApiClient apiClient)

Retrieves a collection of metadata for the direct children of this folder. The result will include metadata for both files and folders.

##### Parameters

apiClient | The `GoogleApiClient` to service the call.

##### Returns

- a PendingResult which can be used to retrieve the children list.

#### public abstract PendingResult<DriveApi.MetadataBufferResult> queryChildren (GoogleApiClient apiClient, Query query)

Retrieves a collection of metadata for the all authorized direct children of this folder. Unless restricted by the query, the result will include metadata for both files and folders.

##### Parameters

apiClient | The `GoogleApiClient` to service the call.
query | A query that will restrict the results of the retrieved children.

##### Returns

- a PendingResult which can be used to retrieve the children list.