Class Folder

Thư mục

Một thư mục trong Google Drive. Bạn có thể truy cập hoặc tạo thư mục bằng DriveApp. 

// Log the name of every folder in the user's Drive.
var folders = DriveApp.getFolders();
while (folders.hasNext()) {
  var folder = folders.next();
  Logger.log(folder.getName());
}

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
addEditor(emailAddress)FolderThêm người dùng đã cho vào danh sách người chỉnh sửa của Folder.
addEditor(user)FolderThêm người dùng đã cho vào danh sách người chỉnh sửa của Folder.
addEditors(emailAddresses)FolderThêm mảng người dùng đã cho vào danh sách trình chỉnh sửa của Folder.
addViewer(emailAddress)FolderThêm người dùng cụ thể vào danh sách người xem của Folder.
addViewer(user)FolderThêm người dùng cụ thể vào danh sách người xem của Folder.
addViewers(emailAddresses)FolderThêm mảng người dùng đã cho vào danh sách người xem của Folder.
createFile(blob)FileTạo một tệp trong thư mục hiện tại từ Blob dữ liệu tuỳ ý nhất định.
createFile(name, content)FileTạo một tệp văn bản trong thư mục hiện tại có tên và nội dung đã cho.
createFile(name, content, mimeType)FileTạo một tệp trong thư mục hiện tại có tên, nội dung và loại MIME đã cho.
createFolder(name)FolderTạo một thư mục trong thư mục hiện tại bằng tên đã cho.
createShortcut(targetId)FileTạo một lối tắt đến mã mục Drive được cung cấp rồi trả về mã đó.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileTạo một lối tắt đến mã mục Drive và khoá tài nguyên được cung cấp rồi trả về mã đó.
getAccess(email)PermissionNhận quyền được cấp cho người dùng cụ thể.
getAccess(user)PermissionNhận quyền được cấp cho người dùng cụ thể.
getDateCreated()DateLấy ngày tạo Folder.
getDescription()StringLấy nội dung mô tả cho Folder.
getEditors()User[]Lấy danh sách người chỉnh sửa cho Folder này.
getFiles()FileIteratorLấy một tập hợp gồm tất cả các tệp là tệp con của thư mục hiện tại.
getFilesByName(name)FileIteratorLấy một tập hợp gồm tất cả các tệp là tệp con của thư mục hiện tại và có tên cụ thể.
getFilesByType(mimeType)FileIteratorLấy một tập hợp tất cả các tệp là tệp con của thư mục hiện tại và có loại MIME đã cho.
getFolders()FolderIteratorLấy một tập hợp tất cả các thư mục là thư mục con của thư mục hiện tại.
getFoldersByName(name)FolderIteratorLấy một tập hợp tất cả các thư mục là thư mục con của thư mục hiện tại và có tên cụ thể.
getId()StringLấy mã nhận dạng của Folder.
getLastUpdated()DateLấy ngày cập nhật Folder gần đây nhất.
getName()StringLấy tên của Folder.
getOwner()UserTìm chủ sở hữu của Folder này.
getParents()FolderIteratorLấy một tập hợp các thư mục là thành phần mẹ trực tiếp của Folder.
getResourceKey()StringLấy khoá tài nguyên của Folder cần thiết để truy cập vào các mục đã được chia sẻ bằng một đường liên kết.
getSecurityUpdateEligible()BooleanKiểm tra xem Folder này có đủ điều kiện áp dụng bản cập nhật bảo mật yêu cầu khoá tài nguyên để truy cập khi được chia sẻ bằng một đường liên kết hay không.
getSecurityUpdateEnabled()BooleanBiết được Folder này có yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng một đường liên kết.
getSharingAccess()AccessLấy thông tin về lớp người dùng có thể truy cập vào Folder, ngoài từng người dùng riêng lẻ đã được cấp quyền truy cập một cách rõ ràng.
getSharingPermission()PermissionNhận quyền được cấp cho những người dùng có thể truy cập vào Folder, ngoài người dùng cá nhân đã được cấp quyền truy cập một cách rõ ràng.
getSize()IntegerLấy số byte dùng để lưu trữ Folder trong Drive.
getUrl()StringLấy URL có thể dùng để mở Folder trong một ứng dụng Google như Drive hoặc Tài liệu.
getViewers()User[]Xem danh sách người xem và người nhận xét cho Folder này.
isShareableByEditors()BooleanXác định xem người dùng có quyền chỉnh sửa đối với Folder có được phép chia sẻ với người dùng khác hoặc thay đổi quyền hay không.
isStarred()BooleanXác định xem Folder đã được gắn dấu sao trong Drive của người dùng hay chưa.
isTrashed()BooleanXác định xem Folder có trong thùng rác trong Drive của người dùng hay không.
moveTo(destination)FolderDi chuyển mục này sang thư mục đích đã cung cấp.
removeEditor(emailAddress)FolderXoá người dùng cụ thể khỏi danh sách người chỉnh sửa của Folder.
removeEditor(user)FolderXoá người dùng cụ thể khỏi danh sách người chỉnh sửa của Folder.
removeViewer(emailAddress)FolderXoá người dùng cụ thể khỏi danh sách người xem và người nhận xét của Folder.
removeViewer(user)FolderXoá người dùng cụ thể khỏi danh sách người xem và người nhận xét của Folder.
revokePermissions(emailAddress)FolderThu hồi quyền truy cập Folder đã cấp cho người dùng đã cấp.
revokePermissions(user)FolderThu hồi quyền truy cập Folder đã cấp cho người dùng đã cấp.
searchFiles(params)FileIteratorLấy một tập hợp gồm tất cả các tệp là tệp con của thư mục hiện tại và khớp với các tiêu chí tìm kiếm nhất định.
searchFolders(params)FolderIteratorLấy một tập hợp tất cả các thư mục là thư mục con của thư mục hiện tại và khớp với các tiêu chí tìm kiếm nhất định.
setDescription(description)FolderĐặt nội dung mô tả cho Folder.
setName(name)FolderĐặt tên cho Folder.
setOwner(emailAddress)FolderThay đổi chủ sở hữu của Folder.
setOwner(user)FolderThay đổi chủ sở hữu của Folder.
setSecurityUpdateEnabled(enabled)FolderThiết lập xem Folder có yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng một đường liên kết.
setShareableByEditors(shareable)FolderThiết lập xem người dùng có quyền chỉnh sửa đối với Folder có được phép chia sẻ với người dùng khác hoặc thay đổi quyền hay không.
setSharing(accessType, permissionType)FolderĐặt lớp người dùng có thể truy cập vào Folder và những quyền mà người dùng đó được cấp, ngoài bất kỳ người dùng cá nhân nào đã được cấp quyền truy cập rõ ràng.
setStarred(starred)FolderThiết lập xem Folder có được gắn dấu sao trong Drive của người dùng hay không.
setTrashed(trashed)FolderThiết lập liệu Folder có trong thùng rác trong Drive của người dùng hay không.

Tài liệu chi tiết

addEditor(emailAddress)

Thêm người dùng đã cho vào danh sách người chỉnh sửa của Folder. Nếu người dùng đã có trong danh sách người xem, phương thức này sẽ đẩy người dùng ra khỏi danh sách người xem.

Các tham số

TênLoạiNội dung mô tả
emailAddressStringĐịa chỉ email của người dùng cần thêm.

Cầu thủ trả bóng

Folder – Folder này, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

addEditor(user)

Thêm người dùng đã cho vào danh sách người chỉnh sửa của Folder. Nếu người dùng đã có trong danh sách người xem, phương thức này sẽ đẩy người dùng ra khỏi danh sách người xem.

Các tham số

TênLoạiNội dung mô tả
userUserĐại diện cho người dùng mà bạn cần thêm.

Cầu thủ trả bóng

Folder – Folder này, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

addEditors(emailAddresses)

Thêm mảng người dùng đã cho vào danh sách trình chỉnh sửa của Folder. Nếu bất kỳ người dùng nào đã có trong danh sách người xem, phương thức này sẽ thăng hạng họ ra khỏi danh sách người xem.

Các tham số

TênLoạiNội dung mô tả
emailAddressesString[]Một mảng địa chỉ email của người dùng cần thêm.

Cầu thủ trả bóng

Folder – Folder này, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

addViewer(emailAddress)

Thêm người dùng cụ thể vào danh sách người xem của Folder. Nếu người dùng đã có trong danh sách người chỉnh sửa, thì phương thức này sẽ không có hiệu lực.

Các tham số

TênLoạiNội dung mô tả
emailAddressStringĐịa chỉ email của người dùng cần thêm.

Cầu thủ trả bóng

Folder – Folder này, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

addViewer(user)

Thêm người dùng cụ thể vào danh sách người xem của Folder. Nếu người dùng đã có trong danh sách người chỉnh sửa, thì phương thức này sẽ không có hiệu lực.

Các tham số

TênLoạiNội dung mô tả
userUserĐại diện cho người dùng mà bạn cần thêm.

Cầu thủ trả bóng

Folder – Folder này, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

addViewers(emailAddresses)

Thêm mảng người dùng đã cho vào danh sách người xem của Folder. Nếu bất kỳ người dùng nào đã có trong danh sách người chỉnh sửa, thì phương thức này sẽ không có hiệu lực đối với họ.

Các tham số

TênLoạiNội dung mô tả
emailAddressesString[]Một mảng địa chỉ email của người dùng cần thêm.

Cầu thủ trả bóng

Folder – Folder này, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

createFile(blob)

Tạo một tệp trong thư mục hiện tại từ Blob dữ liệu tuỳ ý nhất định. 

// Create an image file in Google Drive using the Maps service.
var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob();
DriveApp.getRootFolder().createFile(blob);

Các tham số

TênLoạiNội dung mô tả
blobBlobSourceDữ liệu của tệp mới.

Cầu thủ trả bóng

File – Tệp mới.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

createFile(name, content)

Tạo một tệp văn bản trong thư mục hiện tại có tên và nội dung đã cho. Gửi một trường hợp ngoại lệ nếu content lớn hơn 50 MB. 

// Create a text file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New Text File', 'Hello, world!');

Các tham số

TênLoạiNội dung mô tả
nameStringTên của tệp mới.
contentStringNội dung của tệp mới.

Cầu thủ trả bóng

File – Tệp mới.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

createFile(name, content, mimeType)

Tạo một tệp trong thư mục hiện tại có tên, nội dung và loại MIME đã cho. Gửi một trường hợp ngoại lệ nếu content lớn hơn 10 MB. 

// Create an HTML file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);

Các tham số

TênLoạiNội dung mô tả
nameStringTên của tệp mới.
contentStringNội dung của tệp mới.
mimeTypeStringLoại MIME của tệp mới.

Cầu thủ trả bóng

File – Tệp mới.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

createFolder(name)

Tạo một thư mục trong thư mục hiện tại bằng tên đã cho.

Các tham số

TênLoạiNội dung mô tả
nameStringTên của thư mục mới.

Cầu thủ trả bóng

Folder – Thư mục mới.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

createShortcut(targetId)

Tạo một lối tắt đến mã mục Drive được cung cấp rồi trả về mã đó.

Các tham số

TênLoạiNội dung mô tả
targetIdStringMã tệp của tệp hoặc thư mục đích.

Cầu thủ trả bóng

File – Lối tắt mới.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

Tạo một lối tắt đến mã mục Drive và khoá tài nguyên được cung cấp rồi trả về mã đó. Khoá tài nguyên là một thông số bổ sung cần được truyền để truy cập vào tệp mục tiêu hoặc thư mục đã được chia sẻ bằng một đường liên kết. 

// Creates shortcuts for all folders in the user's drive that have a specific name.
// TODO(developer): Replace 'Test-Folder' with a valid folder name in your drive.
const folders = DriveApp.getFoldersByName('Test-Folder');

// Iterates through all folders named 'Test-Folder'.
while (folders.hasNext()) {
  const folder = folders.next();

  // Creates a shortcut to the provided Drive item ID and resource key, and returns it.
  DriveApp.createShortcutForTargetIdAndResourceKey(folder.getId(), folder.getResourceKey());
}

Các tham số

TênLoạiNội dung mô tả
targetIdStringMã của tệp hoặc thư mục đích.
targetResourceKeyStringKhoá tài nguyên của tệp hoặc thư mục đích.

Cầu thủ trả bóng

File – Lối tắt mới.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

getAccess(email)

Nhận quyền được cấp cho người dùng cụ thể.

Các tham số

TênLoạiNội dung mô tả
emailStringđịa chỉ email của người dùng có quyền cần được kiểm tra

Cầu thủ trả bóng

Permission – quyền đã cấp cho người dùng

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getAccess(user)

Nhận quyền được cấp cho người dùng cụ thể.

Các tham số

TênLoạiNội dung mô tả
userUserhình ảnh đại diện cho người dùng có quyền cần được đánh dấu

Cầu thủ trả bóng

Permission – quyền đã cấp cho người dùng

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getDateCreated()

Lấy ngày tạo Folder.

Cầu thủ trả bóng

Date – ngày tạo Folder

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getDescription()

Lấy nội dung mô tả cho Folder.

Cầu thủ trả bóng

String – nội dung mô tả cho Folder

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getEditors()

Lấy danh sách người chỉnh sửa cho Folder này. Nếu người dùng thực thi tập lệnh không có quyền chỉnh sửa Folder, phương thức này sẽ trả về một mảng trống. 

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of editors and logs their names to the console.
const editors = folder.getEditors();
for (editor of editors) {
  console.log(editor.getName());
}

Cầu thủ trả bóng

User[] – Danh sách trình chỉnh sửa của Folder này nếu người dùng có quyền chỉnh sửa hoặc nếu không có một mảng trống.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFiles()

Lấy một tập hợp gồm tất cả các tệp là tệp con của thư mục hiện tại.

Cầu thủ trả bóng

FileIterator – Một tập hợp tất cả các tệp là con của thư mục hiện tại.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFilesByName(name)

Lấy một tập hợp gồm tất cả các tệp là tệp con của thư mục hiện tại và có tên cụ thể.

Các tham số

TênLoạiNội dung mô tả
nameStringTên của các tệp cần tìm.

Cầu thủ trả bóng

FileIterator – Tập hợp tất cả các tệp là con của thư mục hiện tại và có tên cụ thể.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFilesByType(mimeType)

Lấy một tập hợp tất cả các tệp là tệp con của thư mục hiện tại và có loại MIME đã cho.

Các tham số

TênLoạiNội dung mô tả
mimeTypeStringLoại MIME của tệp cần tìm.

Cầu thủ trả bóng

FileIterator – Tập hợp tất cả các tệp là con của thư mục hiện tại và có loại MIME đã cho.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFolders()

Lấy một tập hợp tất cả các thư mục là thư mục con của thư mục hiện tại.

Cầu thủ trả bóng

FolderIterator – Một tập hợp tất cả các thư mục là con của thư mục hiện tại.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFoldersByName(name)

Lấy một tập hợp tất cả các thư mục là thư mục con của thư mục hiện tại và có tên cụ thể.

Các tham số

TênLoạiNội dung mô tả
nameStringTên của các thư mục cần tìm.

Cầu thủ trả bóng

FolderIterator – Tập hợp tất cả các thư mục là con của thư mục hiện tại và có tên cụ thể.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getId()

Lấy mã nhận dạng của Folder.

Cầu thủ trả bóng

String – mã nhận dạng của Folder

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getLastUpdated()

Lấy ngày cập nhật Folder gần đây nhất.

Cầu thủ trả bóng

Date — ngày cập nhật Folder gần đây nhất

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getName()

Lấy tên của Folder.

Cầu thủ trả bóng

String – tên của Folder

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getOwner()

Tìm chủ sở hữu của Folder này. 

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the owner of the folder and logs the name to the console.
const folderOwner = folder.getOwner();
console.log(folderOwner.getName());

Cầu thủ trả bóng

User – Chủ sở hữu của Folder này.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getParents()

Lấy một tập hợp các thư mục là thành phần mẹ trực tiếp của Folder.

Cầu thủ trả bóng

FolderIterator – một tập hợp các thư mục là thành phần mẹ trực tiếp của Folder

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getResourceKey()

Lấy khoá tài nguyên của Folder cần thiết để truy cập vào các mục đã được chia sẻ bằng một đường liên kết.

Cầu thủ trả bóng

String – Khoá tài nguyên của Folder.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSecurityUpdateEligible()

Kiểm tra xem Folder này có đủ điều kiện áp dụng bản cập nhật bảo mật yêu cầu khoá tài nguyên để truy cập khi được chia sẻ bằng một đường liên kết hay không.

Drive yêu cầu có khoá tài nguyên để truy cập một số tệp hoặc thư mục đã được chia sẻ bằng đường liên kết. Thay đổi này là một phần của một bản cập nhật bảo mật. Bản cập nhật được bật theo mặc định đối với các tệp và thư mục đủ điều kiện. Để bật hoặc tắt yêu cầu về khoá tài nguyên cho các tệp đủ điều kiện, hãy sử dụng setSecurityUpdateEnabled.

Tìm hiểu thêm về Bản cập nhật bảo mật cho Google Drive.

Cầu thủ trả bóng

Boolean – Liệu có thể áp dụng yêu cầu về khoá tài nguyên cho Folder hay không.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSecurityUpdateEnabled()

Biết được Folder này có yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng một đường liên kết. Yêu cầu này được bật theo mặc định đối với các tệp và thư mục đủ điều kiện. Để bật hoặc tắt yêu cầu về khoá tài nguyên cho các tệp đủ điều kiện, hãy sử dụng setSecurityUpdateEnabled.

Tìm hiểu thêm về Bản cập nhật bảo mật cho Google Drive.

Cầu thủ trả bóng

Boolean – Liệu yêu cầu về khoá tài nguyên có được bật cho Folder này hay không.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSharingAccess()

Lấy thông tin về lớp người dùng có thể truy cập vào Folder, ngoài từng người dùng riêng lẻ đã được cấp quyền truy cập một cách rõ ràng.

Cầu thủ trả bóng

Access – lớp người dùng nào có thể truy cập vào Folder

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSharingPermission()

Nhận quyền được cấp cho những người dùng có thể truy cập vào Folder, ngoài người dùng cá nhân đã được cấp quyền truy cập một cách rõ ràng.

Cầu thủ trả bóng

Permission — quyền được cấp cho người dùng có thể truy cập vào Folder

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSize()

Lấy số byte dùng để lưu trữ Folder trong Drive. Xin lưu ý rằng các tệp ứng dụng trên Google Workspace không được tính vào hạn mức bộ nhớ Drive nên sẽ trả về 0 byte.

Cầu thủ trả bóng

Integer – số byte dùng để lưu trữ Folder trong Drive

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getUrl()

Lấy URL có thể dùng để mở Folder trong một ứng dụng Google như Drive hoặc Tài liệu.

Cầu thủ trả bóng

String – URL có thể dùng để xem Folder này trong một ứng dụng Google như Drive hoặc Tài liệu

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getViewers()

Xem danh sách người xem và người nhận xét cho Folder này. Nếu người dùng thực thi tập lệnh không có quyền chỉnh sửa Folder, thì phương thức này sẽ trả về một mảng trống. 

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of viewers and logs their names to the console.
const viewers = folder.getViewers();
for (viewer of viewers) {
  console.log(viewer.getName());
}

Cầu thủ trả bóng

User[] – Danh sách người xem và người nhận xét của Folder này nếu người dùng có quyền chỉnh sửa hoặc một mảng trống.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isShareableByEditors()

Xác định xem người dùng có quyền chỉnh sửa đối với Folder có được phép chia sẻ với người dùng khác hoặc thay đổi quyền hay không.

Cầu thủ trả bóng

Boolean – true nếu người dùng có quyền chỉnh sửa được phép chia sẻ với người dùng khác hoặc thay đổi quyền; false nếu không

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isStarred()

Xác định xem Folder đã được gắn dấu sao trong Drive của người dùng hay chưa.

Cầu thủ trả bóng

Boolean – true nếu Folder được gắn dấu sao trong Drive của người dùng; false nếu không

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isTrashed()

Xác định xem Folder có trong thùng rác trong Drive của người dùng hay không.

Cầu thủ trả bóng

Boolean – true nếu Folder nằm trong thùng rác trên Drive của người dùng; false nếu không

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

moveTo(destination)

Di chuyển mục này sang thư mục đích đã cung cấp.

Người dùng hiện tại phải là chủ sở hữu tệp hoặc có ít nhất quyền chỉnh sửa đối với thư mục mẹ hiện tại của mục thì mới có thể di chuyển mục này vào thư mục đích.

Các tham số

TênLoạiNội dung mô tả
destinationFolderThư mục trở thành thư mục mẹ mới.

Cầu thủ trả bóng

Folder – Folder này, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

removeEditor(emailAddress)

Xoá người dùng cụ thể khỏi danh sách người chỉnh sửa của Folder. Phương thức này không chặn người dùng truy cập vào Folder nếu họ thuộc một lớp người dùng có quyền truy cập chung, ví dụ: nếu Folder được chia sẻ với toàn bộ miền của người dùng hoặc nếu Folder nằm trong bộ nhớ dùng chung mà người dùng có thể truy cập.

Đối với các tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người xem.

Các tham số

TênLoạiNội dung mô tả
emailAddressStringĐịa chỉ email của người dùng cần xoá.

Cầu thủ trả bóng

Folder – Folder này, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

removeEditor(user)

Xoá người dùng cụ thể khỏi danh sách người chỉnh sửa của Folder. Phương thức này không chặn người dùng truy cập vào Folder nếu họ thuộc một lớp người dùng có quyền truy cập chung, ví dụ: nếu Folder được chia sẻ với toàn bộ miền của người dùng hoặc nếu Folder nằm trong bộ nhớ dùng chung mà người dùng có thể truy cập.

Đối với các tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người xem.

Các tham số

TênLoạiNội dung mô tả
userUserBiểu thị người dùng cần xoá.

Cầu thủ trả bóng

Folder – Folder này, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

removeViewer(emailAddress)

Xoá người dùng cụ thể khỏi danh sách người xem và người nhận xét của Folder. Phương thức này không có tác dụng nếu người dùng là người chỉnh sửa chứ không phải là người xem hoặc người nhận xét. Phương thức này cũng không chặn người dùng truy cập vào Folder nếu họ thuộc một lớp người dùng có quyền truy cập chung, ví dụ: nếu Folder được chia sẻ với toàn bộ miền của người dùng hoặc nếu Folder nằm trong bộ nhớ dùng chung mà người dùng có thể truy cập.

Đối với các tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người chỉnh sửa.

Các tham số

TênLoạiNội dung mô tả
emailAddressStringĐịa chỉ email của người dùng cần xoá.

Cầu thủ trả bóng

Folder – Folder này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

removeViewer(user)

Xoá người dùng cụ thể khỏi danh sách người xem và người nhận xét của Folder. Phương thức này không có hiệu lực nếu người dùng là người chỉnh sửa chứ không phải người xem. Phương thức này cũng không chặn người dùng truy cập vào Folder nếu họ thuộc một lớp người dùng có quyền truy cập chung, ví dụ: nếu Folder được chia sẻ với toàn bộ miền của người dùng hoặc nếu Folder nằm trong bộ nhớ dùng chung mà người dùng có thể truy cập.

Đối với các tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người chỉnh sửa.

Các tham số

TênLoạiNội dung mô tả
userUserBiểu thị người dùng cần xoá.

Cầu thủ trả bóng

Folder – Folder này để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

revokePermissions(emailAddress)

Thu hồi quyền truy cập Folder đã cấp cho người dùng đã cấp. Phương thức này không chặn người dùng truy cập vào Folder nếu họ thuộc một lớp người dùng có quyền truy cập chung, ví dụ: nếu Folder được chia sẻ với toàn bộ miền của người dùng.

Các tham số

TênLoạiNội dung mô tả
emailAddressStringĐịa chỉ email của người dùng có quyền truy cập bị thu hồi.

Cầu thủ trả bóng

Folder – Folder này, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

revokePermissions(user)

Thu hồi quyền truy cập Folder đã cấp cho người dùng đã cấp. Phương thức này không chặn người dùng truy cập vào Folder nếu họ thuộc một lớp người dùng có quyền truy cập chung, ví dụ: nếu Folder được chia sẻ với toàn bộ miền của người dùng.

Các tham số

TênLoạiNội dung mô tả
userUserBiểu thị người dùng cần thu hồi quyền truy cập.

Cầu thủ trả bóng

Folder – Folder này, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

searchFiles(params)

Lấy một tập hợp gồm tất cả các tệp là tệp con của thư mục hiện tại và khớp với các tiêu chí tìm kiếm nhất định. Tiêu chí tìm kiếm được nêu chi tiết trong tài liệu về SDK Google Drive. Xin lưu ý rằng dịch vụ Drive sử dụng phiên bản 2 của API Drive và một số trường truy vấn khác với phiên bản 3. Xem lại sự khác biệt về trường giữa v2 và v3.

Đối số params là một chuỗi truy vấn có thể chứa các giá trị chuỗi, vì vậy, hãy chú ý thoát dấu ngoặc kép chính xác (ví dụ: "title contains 'Gulliver\\'s Travels'" hoặc 'title contains "Gulliver\'s Travels"'). 

// Logs the name of every file that are children of the current folder and modified after February 28,
// 2022 whose name contains "untitled.""
var files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

Các tham số

TênLoạiNội dung mô tả
paramsStringTiêu chí tìm kiếm, như được nêu chi tiết trong tài liệu về SDK Google Drive.

Cầu thủ trả bóng

FileIterator – Một tập hợp tất cả các tệp là con của thư mục hiện tại và khớp với tiêu chí tìm kiếm.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

searchFolders(params)

Lấy một tập hợp tất cả các thư mục là thư mục con của thư mục hiện tại và khớp với các tiêu chí tìm kiếm nhất định. Tiêu chí tìm kiếm được nêu chi tiết trong tài liệu về SDK Google Drive. Xin lưu ý rằng dịch vụ Drive sử dụng phiên bản 2 của API Drive và một số trường truy vấn khác với phiên bản 3. Xem lại sự khác biệt về trường giữa v2 và v3.

Đối số params là một chuỗi truy vấn có thể chứa các giá trị chuỗi, vì vậy, hãy chú ý thoát dấu ngoặc kép chính xác (ví dụ: "title contains 'Gulliver\\'s Travels'" hoặc 'title contains "Gulliver\'s Travels"'). 

// Logs the name of every folder that are children of the current folder and you own and is starred.
var folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var folder = folders.next();
  console.log(folder.getName());
}

Các tham số

TênLoạiNội dung mô tả
paramsStringTiêu chí tìm kiếm, như được nêu chi tiết trong tài liệu về SDK Google Drive.

Cầu thủ trả bóng

FolderIterator – Một tập hợp tất cả các thư mục là con của thư mục hiện tại và khớp với tiêu chí tìm kiếm.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

setDescription(description)

Đặt nội dung mô tả cho Folder.

Các tham số

TênLoạiNội dung mô tả
descriptionStringnội dung mô tả mới cho Folder

Cầu thủ trả bóng

Folder — Folder này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

setName(name)

Đặt tên cho Folder.

Các tham số

TênLoạiNội dung mô tả
nameStringtên mới của Folder

Cầu thủ trả bóng

Folder — Folder này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

setOwner(emailAddress)

Thay đổi chủ sở hữu của Folder. Phương thức này cũng cấp cho chủ sở hữu trước quyền chỉnh sửa rõ ràng vào Folder.

Các tham số

TênLoạiNội dung mô tả
emailAddressStringđịa chỉ email của người dùng sẽ trở thành chủ sở hữu mới

Cầu thủ trả bóng

Folder — Folder này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

setOwner(user)

Thay đổi chủ sở hữu của Folder. Phương thức này cũng cấp cho chủ sở hữu trước quyền chỉnh sửa rõ ràng vào Folder.

Các tham số

TênLoạiNội dung mô tả
userUserđại diện cho người dùng sẽ trở thành chủ sở hữu mới

Cầu thủ trả bóng

Folder — Folder này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

setSecurityUpdateEnabled(enabled)

Thiết lập xem Folder có yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng một đường liên kết. Các tệp và thư mục đủ điều kiện được bật theo mặc định.

Tìm hiểu thêm về Bản cập nhật bảo mật cho Google Drive.

Các tham số

TênLoạiNội dung mô tả
enabledBooleanLiệu có bật yêu cầu về khoá tài nguyên cho Folder hay không.

Cầu thủ trả bóng

Folder – Folder này, để tạo chuỗi.

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

setShareableByEditors(shareable)

Thiết lập xem người dùng có quyền chỉnh sửa đối với Folder có được phép chia sẻ với người dùng khác hoặc thay đổi quyền hay không. Tuỳ chọn mặc định cho Folder mới là true.

Các tham số

TênLoạiNội dung mô tả
shareableBooleantrue nếu người dùng có quyền chỉnh sửa được phép chia sẻ với người dùng khác hoặc thay đổi quyền; false nếu không

Cầu thủ trả bóng

Folder — Folder này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

setSharing(accessType, permissionType)

Đặt lớp người dùng có thể truy cập vào Folder và những quyền mà người dùng đó được cấp, ngoài bất kỳ người dùng cá nhân nào đã được cấp quyền truy cập rõ ràng. 

// Creates a folder that anyone on the Internet can read from and write to. (Domain
// administrators can prohibit this setting for users of a Google Workspace domain.)
var folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Các tham số

TênLoạiNội dung mô tả
accessTypeAccesslớp người dùng nào có thể truy cập Folder
permissionTypePermissioncác quyền cần được cấp cho người dùng có thể truy cập Folder

Cầu thủ trả bóng

Folder — Folder này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

setStarred(starred)

Thiết lập xem Folder có được gắn dấu sao trong Drive của người dùng hay không. Tuỳ chọn mặc định cho các Folder mới là false.

Các tham số

TênLoạiNội dung mô tả
starredBooleantrue nếu Folder được gắn dấu sao trong Drive của người dùng; false nếu không phải

Cầu thủ trả bóng

Folder — Folder này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

setTrashed(trashed)

Thiết lập liệu Folder có trong thùng rác trong Drive của người dùng hay không. Chỉ chủ sở hữu mới có thể chuyển Folder vào thùng rác. Chế độ mặc định cho các Folder mới là false.

Các tham số

TênLoạiNội dung mô tả
trashedBooleantrue nếu chuyển Folder vào thùng rác trong Drive của người dùng; false nếu không

Cầu thủ trả bóng

Folder — Folder này, để tạo chuỗi

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

Các phương thức ngừng hoạt động