addEditor(emailAddress)

Adds the given user to the list of editors for the Folder. If the user was already on the list of viewers, this method promotes the user out of the list of viewers.

Parameters

Return

Folder — this Folder, for chaining

addEditor(user)

Adds the given user to the list of editors for the Folder. If the user was already on the list of viewers, this method promotes the user out of the list of viewers.

Parameters

Return

Folder — this Folder, for chaining

addEditors(emailAddresses)

Adds the given array of users to the list of editors for the Folder. If any of the users were already on the list of viewers, this method promotes them out of the list of viewers.

Parameters

Return

Folder — this Folder, for chaining

addToFolder(parent)

Adds the item to the given folder.

 
// This example creates a new file and adds it to a folder
 // Note: This can also be used on a folder to add it to another folder
 var file = DocsList.createFile('my test file', 'test file contents');
 var folder = DocsList.createFolder('My Test Folder');
 file.addToFolder(folder);
 Logger.log(file.getParents()[0].getName()); // logs 'My Test Folder'
 

Parameters

addViewer(emailAddress)

Adds the given user to the list of viewers for the Folder. If the user was already on the list of editors, this method has no effect.

Parameters

Return

Folder — this Folder, for chaining

addViewer(user)

Adds the given user to the list of viewers for the Folder. If the user was already on the list of editors, this method has no effect.

Parameters

Return

Folder — this Folder, for chaining

addViewers(emailAddresses)

Adds the given array of users to the list of viewers for the Folder. If any of the users were already on the list of editors, this method has no effect for them.

Parameters

Return

Folder — this Folder, for chaining

createFile(blob)

Creates a file using the data stored in this blob.

 
// Fetches the Google logo and saves it to a folder
 var url = 'https://www.google.com/images/srpr/logo3w.png';
 var imageBlob = UrlFetchApp.fetch(url).getBlob();
 var folder = DocsList.createFolder('my folder');
 folder.createFile(imageBlob);
 

Parameters

Return

File — the newly created file

createFile(name, contents)

Creates a file with the given name and contents in the current folder. If the file name does not contain an extension, it defaults to plain text.

 
// Creates a file called 'new kitten' in the 'kittens' folder
 var folder = DocsList.getFolder('kittens');
 folder.createFile('new kitten', 'meow');
 

Parameters

Return

File — the newly created file

createFile(name, contents, mimeType)

Creates a file with the given name and contents in the current folder with the given MIME type. If the file name does not contain an extension, it defaults to plain text.

 
// Creates a simple XML file in the 'kittens' folder
 var folder = DocsList.getFolder('kittens');
 var contents = '<kitten><name>Tiny</name><age>1</age></kitten>';
 folder.createFile('kittens.xml', contents, 'application/xml');
 

Parameters

Return

File — the newly created file

createFolder(name)

Creates a sub-folder with the given name in the current folder.

 
// Creates a subfolder in a folder called 'cats'
 var folder = DocsList.createFolder('cats');
 folder.createFolder('cool cats');
 

Parameters

Return

Folder — the newly created folder

find(query)

Returns an array of all the files in the container that contain the given string.

 
// Logs the name of all the files resulting from a search for 'cool cats'
 var folder = DocsList.getFolder('cats');
 var coolCats = folder.find('cool cats');
 for (var i in coolCats) {
   Logger.log(coolCats[i].getName());
 }
 

Parameters

Return

File[] — the matching files

findForPaging(query, number)

Returns the next number files maching the search query and a paging token. If the requested number of files do not exist, it returns the available files.

 
// Logs the name of the first 3 files resulting from a search for 'cool cats'
 var folder = DocsList.getFolder('cats');
 var filesResult = folder.findForPaging('cool cats', 3);
 var files = FilesResult.getFiles();
 for (var i in files) {
   Logger.log(files[i].getName());
 }
 

Parameters

Return

FilesResult — the requested number of matching files and a paging token

findForPaging(query, number, token)

Returns the next number files maching the search query, picking up from where the token from the previous lookup left off. If the requested number of files do not exist, it returns the available files.

 
// Logs the first 6 file names resulting from a search but does it 3 at
 // a time.
 var folder = DocsList.getFolder('cats');
 var filesResult = folder.findForPaging('cool cats', 3);
 var files = filesResult.getFiles();
 var token = filesResult.getToken();
 // log the first 3 file names
 for (var i in files) {
   Logger.log(files[i].getName());
 }
 filesResult = folder.findForPaging('cool cats', 3, token); // pass in previous token
 files = filesResult.getFiles();
 // log the next 3 file names
 for (var i in files) {
   Logger.log(files[i].getName());
 }
 

Parameters

Return

FilesResult — the requested number of matching files and a paging token

getDateCreated()

Gets the date that this item was created.

 
// This example logs the date the first file was created.
 // Note: This can also be used on a folder
 var file = DocsList.getAllFiles[0];
 Logger.log(file.getDateCreated());
 

Return

Date — the date this item was created

getDescription()

Returns the description of the item or null if a description doesn't exist.

 
// Gets the first document's description.
 // Note: This can also be used on a folder
 var doc = DocsList.getFilesByType(DocsList.FileType.DOCUMENT)[0];
 Logger.log(doc.getDescription());
 

Return

String — the item's description

getEditors()

Gets the list of editors for this Folder. If the user who executes the script does not have edit access to the Folder, this method throws an exception.

Return

User[] — an array of users with edit permission

getFiles()

Returns all the files in the container (up to a maximum of DocsList.DEFAULT_RESULT_SIZE).

 
// Logs the number of files in the 'kittens' folder
 var folder = DocsList.getFolder('kittens');
 var files = folder.getFiles();
 Logger.log(files.length);
 

Return

File[] — the requested files

getFilesByType(type)

Returns all files of a given type. See FileType for the list of possible file types.

 
// Logs the names of the first document in the 'kittens' folder
 var folder = DocsList.getFolder('kittens');
 var file = folder.getFilesByType(DocsList.FileType.DOCUMENT)[0];
 Logger.log(file.getName());
 

Parameters

Return

File[] — the requested files

See also

• FileType

getFilesByTypeForPaging(type, number)

Returns the next number files of the given type in this container and a paging token. If the requested number of files do not exist, it returns the available files.

 
// Logs the first 3 document names (or less if there are fewer
 // than 3 documents) from the 'kittens' folder
 var folder = DocsList.getFolder('kittens');
 var filesResult = folder.getFilesForPaging(DocsList.FileType.DOCUMENT, 3);
 var files = FilesResult.getFiles();
 for (var i in files) {
   Logger.log(files[i].getName());
 }
 

Parameters

Return

FilesResult — the requested files and a paging token

See also

• FileType

getFilesByTypeForPaging(type, number, token)

Returns the next number files of the given type in this container, picking up from where the token from the previous lookup left off. If the requested number of files do not exist, it returns the available files.

 
// Logs the first 6 document names in the 'kittens' folder but does it 3 at
 // a time.
 var folder = DocsList.getFolder('kittens');
 var filesResult = folder.getFilesForPaging(DocsList.FileType.DOCUMENT, 3);
 var files = filesResult.getFiles();
 var token = filesResult.getToken();
 // log the first 3 document names
 for (var i in files) {
   Logger.log(files[i].getName());
 }
 // pass in previous token
 filesResult = folder.getFilesForPaging(DocsList.FileType.DOCUMENT, 3, token);
 files = filesResult.getFiles();
 // log the next 3 document names
 for (var i in files) {
   Logger.log(files[i].getName());
 }
 

Parameters

Return

FilesResult — the requested files and paging token

getFilesForPaging(number)

Returns the next number files in this container and a paging token. If the requested number of files do not exist, it returns the available files.

 
// Logs the first 3 file names (or less if there are fewer
 // than 3 files) from the 'kittens' folder
 var folder = DocsList.getFolder('kittens');
 var filesResult = folder.getFilesForPaging(3);
 var files = filesResult.getFiles();
 for (var i in files) {
   Logger.log(files[i].getName());
 }
 

Parameters

Return

FilesResult — the requested files and paging token

getFilesForPaging(number, token)

Returns the next number files in this container, picking up from where the token from the previous lookup left off. If the requested number of files do not exist, it returns the available files.

 
// Logs the first 6 file names in the 'kittens' folder but does it 3 at
 // a time.
 var folder = DocsList.getFolder('kittens');
 var filesResult = folder.getFilesForPaging(3);
 var files = filesResult.getFiles();
 var token = filesResult.getToken();
 // log the first 3 file names
 for (var i in files) {
   Logger.log(files[i].getName());
 }
 filesResult = folder.getFilesForPaging(3, token); // pass in previous token
 files = filesResult.getFiles();
 // log the next 3 file names
 for (var i in files) {
   Logger.log(files[i].getName());
 }
 

Parameters

Return

FilesResult — the requested files and paging token

getFolders()

Returns all the folders in this container (up to a maximum of DocsList.DEFAULT_RESULT_SIZE).

 
// Logs the number of folders in the 'kittens' folder
 var folder = DocsList.getFolder('kittens');
 var subFolders = folder.getFolders();
 Logger.log(subFolders.length);
 

Return

Folder[] — the requested folders

getFoldersForPaging(number)

Returns the first number of folders in this container and a paging token. If the requested number of folders do not exist, it returns the available folders.

 
// Logs the first 3 folder names (or less if there are fewer
 // than 3 folders) from the 'kittens' folder
 var folder = DocsList.getFolder('kittens');
 var subFoldersResult = folder.getFoldersForPaging(3);
 var subFolders = subFoldersResult.getFolders();
 for (var i in subFolders) {
   Logger.log(subFolders[i].getName());
 }
 

Parameters

Return

FoldersResult — the requested folders and a paging token

getFoldersForPaging(number, token)

Returns the next number folders in this container, picking up from where the token from the previous lookup left off. If the requested number of folders do not exist, it returns the available folders.

 
// Logs the first 6 folder names in the 'kittens' folder but does it 3 at
 // a time.
 var folder = DocsList.getFolder('kittens');
 var foldersResult = folder.getFoldersForPaging(3);
 var subFolders = foldersResult.getFolders();
 var token = foldersResult.getToken();
 // log the first 3 sub folder names
 for (var i in subFolders) {
   Logger.log(subFolders[i].getName());
 }
 folderResult = folder.getAllFoldersForPaging(3, token); // pass in previous token
 subFolders = foldersResult.getFolders();
 // log the next 3 sub folder names
 for (var i in subFolders) {
   Logger.log(subFolders[i].getName());
 }
 

Parameters

Return

FoldersResult — the requested folders and paging token

getId()

Returns the document ID associated with the item.

 
// Logs the first file's document ID.
 // Note: This can also be used on a folder.
 var file = DocsList.getAllFiles()[0];
 Logger.log(file.getId());
 

Return

String — the document ID of the item

getLastUpdated()

Gets the date that this item was last updated.

 
// This example logs the date the first file was last updated.
 // Note: This can also be used on a folder
 var file = DocsList.getAllFiles[0];
 Logger.log(file.getLastUpdated());
 

Return

Date — the date this item was last updated

getName()

Returns the name of the item.

 
// Logs the first file's name.
 // Note: This can also be used on a folder.
 var file = DocsList.getAllFiles()[0];
 Logger.log(file.getName());
 

Return

String — the name of the item

getOwner()

Gets the owner of the item.

 
// This example creates a file and logs the owner's email address
 // Note: This can also be used on a folder
 var file = DocsList.createFile('my test file', 'test file contents');
 Logger.log(file.getOwner().getEmail()); // logs your own email address
 

Return

User — the owner of the item

getParents()

Returns the parent folders. If called on a top level item, it returns the root folder. An item can be placed in multiple folders in drive. See the drive documentation.

 
// This example logs the name of the parent folder of the first doc.
 // Note: This can also be used on a folder to get its parent
 var file = DocsList.getFilesByType(DocsList.FileType.DOCUMENT)[0];
 Logger.log(file.getParents()[0].getName());
 

Return

Folder[] — the parent folders containing the item

getSize()

Returns the amount of disk space used by the item. Note that it returns zero if called on an item that does not consume disk space, such as a Google document type file.

 
// This example logs the first file's size in bytes
 // Note: This can also be used on a folder to get the size of its contents
 var file = DocsList.getAllFiles[0];
 Logger.log(file.getSize());
 

Return

Integer — the item's size in bytes, or zero if the item is a Google document type or does not consume space

getUrl()

Returns a URL to access the particular item.

 
// This example logs the first file's URL
 // Note: This can also be used on a folder
 var file = DocsList.getAllFiles[0];
 Logger.log(file.getUrl());
 

Return

String — the item's URL

getViewers()

Gets the list of viewers and commenters for this Folder. If the user who executes the script does not have edit access to the Folder, this method throws an exception.

Return

User[] — an array of users with view or comment permission

isStarred()

Gets whether the item is starred.

 
// This example creates a new file, stars it, and tests whether it is starred.
 // Note: This can also be used on a folder
 var file = DocsList.createFile('my test file', 'test file contents');
 file.setStarred(true); // the file should be starred in drive
 Logger.log(file.isStarred()); // logs true
 

Return

Boolean — true if the item is starred

isTrashed()

Checks whether the item is trashed.

 
// This example creates a new file and then sets it trashed.
 // Note: This can also be used on a folder
 var file = DocsList.createFile('my test file', 'test file contents');
 file.setTrashed(true); // the file should be trashed in drive
 Logger.log(file.isTrashed()); // logs true
 

Return

Boolean — true if the item is trashed

removeEditor(emailAddress)

Removes the given user from the list of editors for the Folder. This method does not block users from accessing the Folder if they belong to a class of users who have general access — for example, if the Folder is shared with the user's entire domain.

Parameters

Return

Folder — this Folder, for chaining

removeEditor(user)

Removes the given user from the list of editors for the Folder. This method does not block users from accessing the Folder if they belong to a class of users who have general access — for example, if the Folder is shared with the user's entire domain.

Parameters

Return

Folder — this Folder, for chaining

removeFromFolder(parent)

Removes this object from the given folder. If the item does not belong to the folder, this does nothing.

 
// This example creates a new file, adds it to a folder, and then removes
  // it from the folder.
 // Note: This can also be used on a folder to remove it from another folder
 var file = DocsList.createFile('my test file', 'test file contents');
 var folder = DocsList.createFolder('My Test Folder');
 file.addToFolder(folder);
 Logger.log(folder.getFiles().length); // logs 1
 file.removeFromFolder(folder);
 Logger.log(folder.getFiles().length); // logs 0
 

Parameters

removeViewer(emailAddress)

Removes the given user from the list of viewers and commenters for the Folder. This method has no effect if the user is an editor, not a viewer or commenter. This method also does not block users from accessing the Folder if they belong to a class of users who have general access — for example, if the Folder is shared with the user's entire domain.

Parameters

Return

Folder — this Folder for chaining

removeViewer(user)

Removes the given user from the list of viewers and commenters for the Folder. This method has no effect if the user is an editor, not a viewer. This method also does not block users from accessing the Folder if they belong to a class of users who have general access — for example, if the Folder is shared with the user's entire domain.

Parameters

Return

Folder — this Folder for chaining

rename(newName)

Rename the item.

 
// Creates a file called 'Old File' and renames it 'New File'.
 // Note: This can also be used on a folder
 var oldFile = DocsList.createFile('Old File', '');
 oldFile.rename('New File');
 Logger.log(oldFile.getName()); // This should log "New File"
 

Parameters

setDescription(description)

Update's the item's description.

 
// This example sets the first document's description
 // Note: This can also be used on a folder
 var doc = DocsList.getFilesByType(DocsList.FileType.DOCUMENT)[0];
 doc.setDescription('My First Doc');
 Logger.log(doc.getDescription()); // logs 'My First Doc'
 

Parameters

setStarred(starred)

Sets the item's starred status in drive.

 
// This example creates a new file and stars it.
 // Note: This can also be used on a folder
 var file = DocsList.createFile('my test file', 'test file contents');
 file.setStarred(true); // the file should be starred in drive
 

Parameters

setTrashed(trash)

Sets the trashed status of an item but does not permanently delete it.

 
// This example creates a new file and then sets it trashed.
 // Note: This can also be used on a folder
 var file = DocsList.createFile('my test file', 'test file contents');
 file.setTrashed(true); // the file should be trashed in drive
 Logger.log(file.isTrashed()); // logs true
 

Parameters