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 từ 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 pháp

Phương thứcLoại dữ liệu trả vềMô tả ngắn
addEditor(emailAddress)FolderThêm người dùng đã cho vào danh sách trình chỉnh sửa cho Folder.
addEditor(user)FolderThêm người dùng đã cho vào danh sách trình chỉnh sửa cho Folder.
addEditors(emailAddresses)FolderThêm mảng người dùng đã cho vào danh sách trình chỉnh sửa cho Folder.
addViewer(emailAddress)FolderThêm người dùng đã cho vào danh sách người xem cho Folder.
addViewer(user)FolderThêm người dùng đã cho vào danh sách người xem cho Folder.
addViewers(emailAddresses)FolderThêm mảng người dùng nhất định vào danh sách người xem cho Folder.
createFile(blob)FileTạo một tệp trong thư mục hiện tại từ một Blob dữ liệu tuỳ ý nhất định.
createFile(name, content)FileTạo 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 có tên được cung cấp.
createShortcut(targetId)FileTạo lối tắt đến mã mục trên Drive đã cung cấp và trả lại mã đó.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileTạo một lối tắt đến mã mục và tài nguyên Drive được cung cấp, sau đó trả về.
getAccess(email)PermissionNhận quyền được cấp cho người dùng đã cho.
getAccess(user)PermissionNhận quyền được cấp cho người dùng đã cho.
getDateCreated()DateLấy ngày tạo Folder.
getDescription()StringLấy thông tin mô tả cho Folder.
getEditors()User[]Lấy danh sách người chỉnh sửa cho Folder này.
getFiles()FileIteratorLấy tập hợp tất cả tệp là thư mục con của thư mục hiện tại.
getFilesByName(name)FileIteratorLấy tập hợp của tất cả tệp là thư mục con của thư mục hiện tại và có tên được cung cấp.
getFilesByType(mimeType)FileIteratorLấy tập hợp tất cả tệp là thư mục con của thư mục hiện tại và có loại MIME đã cho.
getFolders()FolderIteratorLấy tập hợp của tất cả thư mục là thư mục con của thư mục hiện tại.
getFoldersByName(name)FolderIteratorLấy tập hợp của tất cả thư mục là thư mục con của thư mục hiện tại và có tên được đặt.
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()UserLấy chủ sở hữu của Folder.
getParents()FolderIteratorNhận một tập hợp các thư mục là thực thể mẹ ngay trong Folder.
getResourceKey()StringLấy khoá tài nguyên của Folder cần thiết để truy cập các mục được chia sẻ bằng một đường liên kết.
getSecurityUpdateEligible()BooleanNhận được liệu 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 hay không khi được chia sẻ bằng đường liên kết.
getSecurityUpdateEnabled()BooleanNhận được liệu 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 đường liên kết.
getSharingAccess()AccessLấy lớp người dùng nào có thể truy cập Folder, ngoài bất kỳ cá nhân người dùng nào đã được cấp quyền truy cập rõ ràng.
getSharingPermission()PermissionNhận quyền được cấp cho những người dùng có thể truy cập Folder, ngoài tất cả người dùng cá nhân đã được cấp quyền truy cập 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 của Google như Drive hoặc Tài liệu.
getViewers()User[]Lấy 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ó được gắn dấu sao trong Drive của người dùng hay không.
isTrashed()BooleanXác định xem Folder có nằm trong thùng rác của Drive của người dùng hay không.
moveTo(destination)FolderChuyển mục này vào thư mục đích được cung cấp.
removeEditor(emailAddress)FolderXoá người dùng đã chỉ định khỏi danh sách trình chỉnh sửa của Folder.
removeEditor(user)FolderXoá người dùng đã chỉ định khỏi danh sách trình chỉnh sửa của Folder.
removeViewer(emailAddress)FolderXóa người dùng cụ thể khỏi danh sách người xem và người nhận xét cho Folder.
removeViewer(user)FolderXóa người dùng cụ thể khỏi danh sách người xem và người nhận xét cho Folder.
revokePermissions(user)FolderThu hồi quyền truy cập vào Folder được cấp cho người dùng đã cho.
revokePermissions(user)FolderThu hồi quyền truy cập vào Folder được cấp cho người dùng đã cho.
searchFiles(params)FileIteratorLấy tập hợp của tất cả tệp là phần tử con của thư mục hiện tại và khớp với tiêu chí tìm kiếm cụ thể.
searchFolders(params)FolderIteratorLấy tập hợp của tất cả thư mục là thư mục con của thư mục hiện tại và khớp với tiêu chí tìm kiếm nhất định.
setDescription(description)FolderĐặt phần 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)FolderĐặt xem Folder có yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng đường liên kết.
setShareableByEditors(shareable)FolderThiết lập liệu người dùng có quyền chỉnh sửa đối với Folder được phép chia sẻ với người dùng khác hay thay đổi quyền đó.
setSharing(accessType, permissionType)FolderĐặt lớp người dùng nào có thể truy cập vào Folder và những quyền mà người dùng đó được cấp, ngoài những người dùng cá nhân đã được cấp quyền truy cập rõ ràng.
setStarred(starred)FolderĐặt xem Folder có được gắn dấu sao trong Drive của người dùng hay không.
setTrashed(trashed)FolderĐặt liệu Folder có nằm trong thùng rác của 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 trình chỉnh sửa cho Folder. Nếu người dùng đã có trong danh sách người xem, thì phương thức này sẽ quảng bá người dùng ra khỏi danh sách người xem.

Các tham số

TênLoạiMô tả
emailAddressStringĐịa chỉ email của người dùng mà bạn muốn thêm.

Hai chiều

FolderFolder này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 trình chỉnh sửa cho Folder. Nếu người dùng đã có trong danh sách người xem, thì phương thức này sẽ quảng bá người dùng ra khỏi danh sách người xem.

Các tham số

TênLoạiMô tả
userUserHình ảnh đại diện cho người dùng cần thêm.

Hai chiều

FolderFolder này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 cho Folder. Nếu bất kỳ người dùng nào đã có trong danh sách người xem, thì phương thức này sẽ đưa họ ra khỏi danh sách người xem.

Các tham số

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

Hai chiều

FolderFolder này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

addViewer(emailAddress)

Thêm người dùng đã cho vào danh sách người xem cho 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ạiMô tả
emailAddressStringĐịa chỉ email của người dùng mà bạn muốn thêm.

Hai chiều

FolderFolder này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

addViewer(user)

Thêm người dùng đã cho vào danh sách người xem cho 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ạiMô tả
userUserHình ảnh đại diện cho người dùng cần thêm.

Hai chiều

FolderFolder này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 nhất định vào danh sách người xem cho 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ó tác dụng đối với họ.

Các tham số

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

Hai chiều

FolderFolder này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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ừ mộ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ạiMô tả
blobBlobSourceDữ liệu cho tệp mới.

Hai chiều

File – Tệp mới.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

createFile(name, content)

Tạo tệp văn bản trong thư mục hiện tại có tên và nội dung đã cho. Khai báo 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ạiMô tả
nameStringTên của tệp mới.
contentStringNội dung của tệp mới.

Hai chiều

File – Tệp mới.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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. Khai báo 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ạiMô 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.

Hai chiều

File – Tệp mới.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 có tên được cung cấp.

Các tham số

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

Hai chiều

Folder – Thư mục mới.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

createShortcut(targetId)

Tạo lối tắt đến mã mục trên Drive đã cung cấp và trả lại mã đó.

Các tham số

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

Hai chiều

File — Phím tắt mới.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 và tài nguyên Drive được cung cấp, sau đó trả về. Khoá tài nguyên là một tham số bổ sung cần được truyền để truy cập vào tệp hoặc thư mục đã được chia sẻ bằng đường liên kết.

Các tham số

TênLoạiMô tả
targetIdStringMã của tệp đích hoặc thư mục.
targetResourceKeyStringKhóa tài nguyên của tệp hoặc thư mục đích.

Hai chiều

File — Phím tắt mới.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 đã cho.

Các tham số

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

Hai chiều

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

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 đã cho.

Các tham số

TênLoạiMô tả
userUserđại diện của người dùng có quyền được kiểm tra

Hai chiều

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

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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.

Hai chiều

Date – ngày tạo Folder

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 thông tin mô tả cho Folder.

Hai chiều

String – thông tin mô tả cho Folder

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 đối với Folder, thì phương thức này sẽ trả về một mảng trống.

Hai chiều

User[] – Một mảng người dùng có quyền chỉnh sửa.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 tập hợp tất cả tệp là thư mục con của thư mục hiện tại.

Hai chiều

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

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 tập hợp của tất cả tệp là thư mục con của thư mục hiện tại và có tên được cung cấp.

Các tham số

TênLoạiMô tả
nameStringTên của tệp cần tìm.

Hai chiều

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

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 tập hợp tất cả tệp là thư mục con của thư mục hiện tại và có loại MIME đã cho.

Các tham số

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

Hai chiều

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

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 tập hợp của tất cả thư mục là thư mục con của thư mục hiện tại.

Hai chiều

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

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 tập hợp của tất cả thư mục là thư mục con của thư mục hiện tại và có tên được đặt.

Các tham số

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

Hai chiều

FolderIterator – 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 đặt.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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.

Hai chiều

String – Mã của Folder

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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.

Hai chiều

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

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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.

Hai chiều

String – tên của Folder

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

getOwner()

Lấy chủ sở hữu của Folder.

Hai chiều

User — đối tượng User đại diện cho chủ sở hữu

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

getParents()

Nhận một tập hợp các thư mục là thực thể mẹ ngay trong Folder.

Hai chiều

FolderIterator – một tập hợp các thư mục mẹ ngay lập tức truy cập vào Folder

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 các mục được chia sẻ bằng một đường liên kết.

Hai chiều

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

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

getSecurityUpdateEligible()

Nhận được liệu 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 hay không khi được chia sẻ bằng đường liên kết.

Drive yêu cầu khoá tài nguyên để truy cập vào 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 bản cập nhật bảo mật. Theo mặc định, bản cập nhật sẽ được bật cho 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 dùng setSecurityUpdateEnabled.

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

Hai chiều

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

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

getSecurityUpdateEnabled()

Nhận được liệu 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 đườ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 dùng setSecurityUpdateEnabled.

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

Hai chiều

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

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 lớp người dùng nào có thể truy cập Folder, ngoài bất kỳ cá nhân người dùng nào đã được cấp quyền truy cập rõ ràng.

Hai chiều

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

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 Folder, ngoài tất cả người dùng cá nhân đã được cấp quyền truy cập rõ ràng.

Hai chiều

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

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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. Lưu ý rằng các tệp ứng dụng Google Workspace không được tính vào giới hạn bộ nhớ Drive và do đó, trả về 0 byte.

Hai chiều

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

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 của Google như Drive hoặc Tài liệu.

Hai chiều

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

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

getViewers()

Lấy 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 đối với Folder, thì phương thức này sẽ trả về một mảng trống.

Hai chiều

User[] – Một mảng người dùng có quyền xem hoặc nhận xét.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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.

Hai chiều

Booleantrue 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 phép chia sẻ

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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ó được gắn dấu sao trong Drive của người dùng hay không.

Hai chiều

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

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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ó nằm trong thùng rác của Drive của người dùng hay không.

Hai chiều

Booleantrue nếu Folder nằm trong thùng rác của Drive của người dùng; false nếu không có trong thùng rác

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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)

Chuyển mục này vào thư mục đích được cung cấp.

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

Các tham số

TênLoạiMô tả
destinationFolderThư mục sẽ trở thành thư mục mẹ mới.

Hai chiều

FolderFolder này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

removeEditor(emailAddress)

Xoá người dùng đã chỉ định khỏi danh sách trình 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 một 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ẽ xóa người dùng khỏi danh sách người xem.

Các tham số

TênLoạiMô tả
emailAddressStringĐịa chỉ email của người dùng cần xóa.

Hai chiều

FolderFolder này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

removeEditor(user)

Xoá người dùng đã chỉ định khỏi danh sách trình 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 một 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ẽ xóa người dùng khỏi danh sách người xem.

Các tham số

TênLoạiMô tả
userUserHình ảnh minh họa người dùng cần xóa.

Hai chiều

FolderFolder này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

removeViewer(emailAddress)

Xóa người dùng cụ thể khỏi danh sách người xem và người nhận xét cho 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, 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 một 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 xóa người dùng khỏi danh sách người chỉnh sửa.

Các tham số

TênLoạiMô tả
emailAddressStringĐịa chỉ email của người dùng cần xóa.

Hai chiều

FolderFolder này để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

removeViewer(user)

Xóa người dùng cụ thể khỏi danh sách người xem và người nhận xét cho 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, không phải là 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 một 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 xóa người dùng khỏi danh sách người chỉnh sửa.

Các tham số

TênLoạiMô tả
userUserHình ảnh minh họa người dùng cần xóa.

Hai chiều

FolderFolder này để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 vào Folder được cấp cho người dùng đã cho. 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ạiMô tả
userStringđịa chỉ email của người dùng có quyền truy cập bị thu hồi

Hai chiều

FolderFolder này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 vào Folder được cấp cho người dùng đã cho. 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ạiMô tả
userUserhình ảnh đại diện của người dùng bị thu hồi quyền truy cập

Hai chiều

FolderFolder này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

searchFiles(params)

Lấy tập hợp của tất cả tệp là phần tử con của thư mục hiện tại và khớp với tiêu chí tìm kiếm cụ thể. 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 đố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 khỏi các dấu ngoặc kép đúng (ví dụ: "title contains 'Gulliver\\'s Travels'" hoặc 'title contains "Gulliver\'s Travels"').

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

Các tham số

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

Hai chiều

FileIterator – Tập hợp tất cả các tệp là thư mục 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

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 tập hợp của tất cả thư mục là thư mục con của thư mục hiện tại và khớp với 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 đố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 khỏi các dấu ngoặc kép đúng (ví dụ: "title contains 'Gulliver\\'s Travels'" hoặc 'title contains "Gulliver\'s Travels"').

// Log 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();
  Logger.log(folder.getName());
}

Các tham số

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

Hai chiều

FolderIterator – 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 tiêu chí tìm kiếm.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 phần mô tả cho Folder.

Các tham số

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

Hai chiều

FolderFolder này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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ạiMô tả
nameStringtên mới của Folder

Hai chiều

FolderFolder này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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ạiMô tả
emailAddressStringđịa chỉ email của người dùng sẽ trở thành chủ sở hữu mới

Hai chiều

FolderFolder này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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ạiMô tả
userUsermột đại diện của người dùng sẽ trở thành chủ sở hữu mới

Hai chiều

FolderFolder này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

setSecurityUpdateEnabled(enabled)

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

Hãy 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ạiMô tả
enabledBooleanCó cần bật yêu cầu khoá tài nguyên cho Folder hay không.

Hai chiều

FolderFolder này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

setShareableByEditors(shareable)

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

Các tham số

TênLoạiMô tả
shareableBooleantrue nếu người dùng có quyền chỉnh sửa phải đượ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 phép chia sẻ

Hai chiều

FolderFolder này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 nào có thể truy cập vào Folder và những quyền mà người dùng đó được cấp, ngoài những người dùng cá nhân đã đượ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ạiMô 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 những người dùng truy cập vào Folder

Hai chiều

FolderFolder này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

setStarred(starred)

Đặt xem Folder có được gắn dấu sao trong Drive của người dùng hay không. Giá trị mặc định cho Folder mới là false.

Các tham số

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

Hai chiều

FolderFolder này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

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

setTrashed(trashed)

Đặt liệu Folder có nằm trong thùng rác của 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. Giá trị mặc định cho Folder mới là false.

Các tham số

TênLoạiMô tả
trashedBooleantrue nếu Folder cần được chuyển vào thùng rác của Drive của người dùng; false nếu không

Hai chiều

FolderFolder này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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