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.
const folders = DriveApp.getFolders();
while (folders.hasNext()) {
  const folder = folders.next();
  Logger.log(folder.getName());
}

Phương thức

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 người chỉnh sửa cho Folder.
addEditor(user)FolderThêm người dùng đã cho vào danh sách người chỉnh sửa cho Folder.
addEditors(emailAddresses)FolderThêm mảng người dùng đã cho vào danh sách người chỉnh sửa cho Folder.
addViewer(emailAddress)FolderThêm người dùng đã cho vào danh sách người xem của Folder.
addViewer(user)FolderThêm người dùng đã cho 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 cho Folder.
createFile(blob)FileTạo một tệp trong thư mục hiện tại từ một Blob nhất định của dữ liệu tuỳ ý.
createFile(name, content)FileTạo một tệp văn bản trong thư mục hiện tại với 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 đã cho.
createShortcut(targetId)FileTạo lối tắt đến mã nhận dạng mục trên Drive đã cung cấp và trả về lối tắt đó.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)FileTạo lối tắt đến mã mục và khoá tài nguyên trên Drive đã cung cấp rồi trả về lối tắt đó.
getAccess(email)PermissionLấy quyền được cấp cho một người dùng cụ thể.
getAccess(user)PermissionLấy quyền được cấp cho một 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 trình chỉnh sửa cho Folder này.
getFiles()FileIteratorLấy tập hợp tất cả các tệp là con của thư mục hiện tại.
getFilesByName(name)FileIteratorLấy tập hợp tất cả tệp là tệp con của thư mục hiện tại và có tên đã cho.
getFilesByType(mimeType)FileIteratorLấy tập hợp tất cả tệp là tệp con của thư mục hiện tại và có loại MIME nhất định.
getFolders()FolderIteratorLấy tập hợp tất cả thư mục con của thư mục hiện tại.
getFoldersByName(name)FolderIteratorLấy tập hợp tất cả thư mục con của thư mục hiện tại và có tên đã cho.
getId()StringLấy mã nhận dạng của Folder.
getLastUpdated()DateLấy ngày gần đây nhất Folder được cập nhật.
getName()StringLấy tên của Folder.
getOwner()UserLấy 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ư mục 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 đường liên kết.
getSecurityUpdateEligible()BooleanXác định 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 đường liên kết hay không.
getSecurityUpdateEnabled()BooleanXác định xem Folder này có yêu cầu khoá tài nguyên để truy cập khi được chia sẻ bằng đường liên kết hay không.
getSharingAccess()AccessXác định lớp người dùng nào có thể truy cập vào Folder, ngoài những người dùng cá nhân đã đượ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 vào Folder, ngoài những người dùng riêng lẻ đã đượ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 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 hay 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ó nằm trong thùng rác của Drive của người dùng hay không.
moveTo(destination)FolderDi chuyển mục này đến thư mục đích đã cung cấp.
removeEditor(emailAddress)FolderXoá người dùng đã cho khỏi danh sách trình chỉnh sửa cho Folder.
removeEditor(user)FolderXoá người dùng đã cho khỏi danh sách trình chỉnh sửa cho Folder.
removeViewer(emailAddress)FolderXoá người dùng đã cho khỏi danh sách người xem và người bình luận cho Folder.
removeViewer(user)FolderXoá người dùng đã cho khỏi danh sách người xem và người bình luận cho Folder.
revokePermissions(emailAddress)FolderThu hồi quyền truy cập vào Folder đã cấp cho người dùng cụ thể.
revokePermissions(user)FolderThu hồi quyền truy cập vào Folder đã cấp cho người dùng cụ thể.
searchFiles(params)FileIteratorLấy 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à khớp với tiêu chí tìm kiếm đã cho.
searchFolders(params)FolderIteratorLấy tập hợp 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 đã cho.
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)FolderĐặt xem Folder có yêu cầu khoá tài nguyên để truy cập khi được chia sẻ bằng đường liên kết hay không.
setShareableByEditors(shareable)FolderĐặt 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 hay thay đổi quyền hay không.
setSharing(accessType, permissionType)FolderĐặt loại người dùng nào có thể truy cập vào Folder và những quyền nào được cấp cho những người dùng đó, 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)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 xem 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 người chỉnh sửa cho Folder. Nếu người dùng đã có trong danh sách người xem, phương thức này sẽ loại người dùng đó khỏi danh sách người xem.

Tham số

TênLoạiMô 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 cho Folder. Nếu người dùng đã có trong danh sách người xem, phương thức này sẽ loại người dùng đó khỏi danh sách người xem.

Tham số

TênLoạiMô tả
userUserNội dung đại diện cho 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

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

Tham số

TênLoạiMô tả
emailAddressesString[]Một mảng gồm các đị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

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

Tham số

TênLoạiMô 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

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

Tham số

TênLoạiMô tả
userUserNội dung đại diện cho 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 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 ảnh hưởng đến họ.

Tham số

TênLoạiMô tả
emailAddressesString[]Một mảng gồm các đị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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ừ một Blob nhất định của dữ liệu tuỳ ý.

Tham số

TênLoạiMô tả
blobBlobSourceDữ liệu cho tệp mới.

Cầu thủ trả bóng

File – Tệp mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 với tên và nội dung đã cho. Gửi một 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!');

Tham số

TênLoạiMô 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 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);

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.

Cầu thủ trả bóng

File – Tệp mới.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 có tên đã cho.

Tham số

TênLoạiMô 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 lối tắt đến mã nhận dạng mục trên Drive đã cung cấp và trả về lối tắt đó.

Tham số

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

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 lối tắt đến mã mục và khoá tài nguyên trên Drive đã cung cấp rồi trả về lối tắt đó. 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 mục tiêu đã đượ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(),
  );
}

Tham số

TênLoạiMô tả
targetIdStringMã của tệp hoặc thư mục mục tiêu.
targetResourceKeyStringKhoá tài nguyên của tệp hoặc thư mục mục tiêu.

Cầu thủ trả bóng

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

Ủy quyền

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

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

getAccess(email)

Lấy quyền được cấp cho một người dùng cụ thể. Phương thức này không hỗ trợ việc trả về các quyền cho một Google Group hoặc các quyền được kế thừa thông qua Google Groups.

Tham số

TênLoạiMô tả
emailStringĐịa chỉ email của người dùng mà bạn cần kiểm tra quyền. Không hỗ trợ Google Groups.

Cầu thủ trả bóng

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 thức này yêu cầu đượ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)

Lấy quyền được cấp cho một người dùng cụ thể. Phương thức này không hỗ trợ việc trả về các quyền cho một Google Group hoặc các quyền được kế thừa thông qua Google Groups.

Tham số

TênLoạiMô tả
userUserBiểu thị người dùng cần kiểm tra quyền.

Cầu thủ trả bóng

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 thức này yêu cầu đượ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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 trình 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. 

//  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 (const editor of editors) {
  console.log(editor.getName());
}

Cầu thủ trả bóng

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

Ủy quyền

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

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.

Ủy quyền

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

Tham số

TênLoạiMô 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 đã cho.

Ủy quyền

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

Tham số

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

Cầu thủ trả bóng

FileIterator – 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 nhất định.

Ủy quyền

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

Cầu thủ trả bóng

FolderIterator – Tập hợp tất 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 thức này yêu cầu đượ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 tập hợp tất cả thư mục con của thư mục hiện tại và có tên đã cho.

Tham số

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

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 gần đây nhất Folder được cập nhật.

Cầu thủ trả bóng

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 thức này yêu cầu đượ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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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()

Lấy 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ư mục 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ư mục mẹ trực tiếp của Folder

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đường liên kết.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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()

Xác định 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 đường liên kết hay không.

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, tính năng cập nhật sẽ 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 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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()

Xác định xem Folder này có yêu cầu khoá tài nguyên để truy cập khi được chia sẻ bằng đường liên kết hay không. 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 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 khoá tài nguyên có được bật cho Folder này hay không.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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()

Xác định lớp người dùng nào có thể truy cập vào Folder, ngoài những người dùng cá nhân đã được cấp quyền truy cập rõ ràng.

Cầu thủ trả bóng

Access – loại 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 thức này yêu cầu đượ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 nhữ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

Permission – các quyền được cấp cho 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 thức này yêu cầu đượ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 Google Workspace không được tính vào hạn mức bộ nhớ trên Drive, do đó 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

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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()

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 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 (const viewer of viewers) {
  console.log(viewer.getName());
}

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 hay 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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ó nằm trong thùng rác của 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 của Drive của người dùng; false nếu không

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đến thư mục đích đã cung cấp.

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

Tham số

TênLoạiMô 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã cho khỏi danh sách trình chỉnh sửa cho 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 ổ đĩa dùng chung mà người dùng có thể truy cập.

Đối với 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.

Tham số

TênLoạiMô 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã cho khỏi danh sách trình chỉnh sửa cho 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 ổ đĩa dùng chung mà người dùng có thể truy cập.

Đối với 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.

Tham số

TênLoạiMô tả
userUserThông tin đại diện cho người dùng cần xoá.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã cho khỏi danh sách người xem và người bình luận 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, chứ không phải người xem hoặc người bình luận. 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 sẽ xoá người dùng khỏi danh sách người chỉnh sửa.

Tham số

TênLoạiMô 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã cho khỏi danh sách người xem và người bình luận 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, 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 một ổ đĩa 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.

Tham số

TênLoạiMô tả
userUserThông tin đại diện cho người dùng cần xoá.

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 vào Folder đã cấp cho người dùng cụ thể. 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.

Tham số

TênLoạiMô tả
emailAddressStringĐịa chỉ email của người dùng mà bạn muố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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 vào Folder đã cấp cho người dùng cụ thể. 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.

Tham số

TênLoạiMô tả
userUserThông tin đại diện cho 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 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à khớp với tiêu chí tìm kiếm đã cho. 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 phiên bản 2 và phiên bản 3.

Đố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 cẩn thận để thoát dấu ngoặc kép một cách 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.""
const files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getName());
}

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.

Cầu thủ trả bóng

FileIterator – 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à 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 thức này yêu cầu đượ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 tập hợp 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 đã cho. 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 phiên bản 2 và phiên bản 3.

Đố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 cẩn thận để thoát dấu ngoặc kép một cách 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.
const folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  const folder = folders.next();
  console.log(folder.getName());
}

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.

Cầu thủ trả bóng

FolderIterator – Tập hợp 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.

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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.

Tham số

TênLoạiMô 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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.

Tham số

TênLoạiMô 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đối với Folder.

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

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đối với Folder.

Tham số

TênLoạiMô tả
userUserthông tin đại diện 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

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với 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 khi được chia sẻ bằng đường liên kết hay không. Theo mặc định, các tệp và thư mục đủ điều kiện sẽ được bật.

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

Tham số

TênLoạiMô tả
enabledBooleanCó bật yêu cầu 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

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

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

setShareableByEditors(shareable)

Đặt 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 hay thay đổi quyền hay không. Giá trị mặc định cho Folder mới là true.

Tham số

TênLoạiMô 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

Các tập lệnh sử dụng phương thức này yêu cầu đượ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 loại người dùng nào có thể truy cập vào Folder và những quyền nào được cấp cho những người dùng đó, 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.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

Tham số

TênLoạiMô tả
accessTypeAccesslớp người dùng nào có thể truy cập vào Folder
permissionTypePermissionquyền cần cấp cho những người dùng có thể truy cập vào Folder

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với 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.

Tham số

TênLoạiMô tả
starredBooleantrue nếu Folder được gắn dấu sao 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

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

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

setTrashed(trashed)

Đặt xem 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.

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

Cầu thủ trả bóng

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

Ủy quyền

Các tập lệnh sử dụng phương thức này yêu cầu đượ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