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ứ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 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 dữ liệu tuỳ ý đã cho.
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 bằng 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ã nhận dạng mục và khoá tài nguyên được cung cấp trên Drive, 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 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à thành phần 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à thành phần con của thư mục hiện tại và có tên đã cho.
getFilesByType(mimeType)FileIteratorLấy một tập hợp gồm tất cả các tệp là thành phần 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 gồm 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 gồm 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 đã cho.
getId()StringLấy mã nhận dạng của Folder.
getLastUpdated()DateLấy ngày Folder được cập nhật gần đây 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()BooleanCho biết 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 khi được chia sẻ bằng đường liên kết hay không.
getSecurityUpdateEnabled()BooleanCho biết liệu 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()AccessLấy lớp 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.
getSharingPermission()PermissionLấy 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 được 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)FolderDi chuyển mục này đến thư mục đích được cung cấp.
removeEditor(emailAddress)FolderXoá người dùng đã cho khỏi danh sách người chỉnh sửa của Folder.
removeEditor(user)FolderXoá người dùng đã cho khỏi danh sách người chỉnh sửa của Folder.
removeViewer(emailAddress)FolderXoá người dùng đã cho khỏi danh sách người xem và người bình luận của Folder.
removeViewer(user)FolderXoá người dùng đã cho khỏi danh sách người xem và người bình luận của 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 một tập hợp gồm 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 đã cho.
searchFolders(params)FolderIteratorLấy một tập hợp gồm 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 đã 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 hoặc thay đổi quyền hay không.
setSharing(accessType, permissionType)FolderĐặt nhóm người dùng có thể truy cập vào Folder và những quyền mà những người dùng đó được cấp, 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.
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, thì phương thức này sẽ loại người dùng đó ra khỏi danh sách người xem.

Thông 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

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

Ủy quyền

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

  • 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, thì phương thức này sẽ loại người dùng đó ra khỏi danh sách người xem.

Thông số

TênLoạiMô tả
userUserThông tin về người dùng cần thêm.

Cầu thủ trả bóng

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

Ủy quyền

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

  • 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 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.

Thông số

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

Cầu thủ trả bóng

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

Ủy quyền

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

  • 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.

Thông 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

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

Ủy quyền

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

  • 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.

Thông số

TênLoạiMô tả
userUserThông tin về người dùng cần thêm.

Cầu thủ trả bóng

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

Ủy quyền

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

  • 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 có hiệu lực đối với họ.

Thông số

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

Cầu thủ trả bóng

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

Ủy quyền

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

  • 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ỳ ý đã cho.

Thông 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ây ra 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!');

Thông 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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ây ra một 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);

Thông 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

Thông 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 đó.

Thông 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

Tạo lối tắt đến mã nhận dạng mục và khoá tài nguyên được cung cấp trên Drive, 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 đườ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(),
  );
}

Thông 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 đích.

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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 nhóm trên Google Groups hoặc các quyền được kế thừa thông qua Google Groups.

Thông số

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

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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 nhóm trên Google Groups hoặc các quyền được kế thừa thông qua Google Groups.

Thông số

TênLoạiMô tả
userUserThông tin về 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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.

//  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 người 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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à thành phần 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à 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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à thành phần con của thư mục hiện tại và có tên đã cho.

Thông số

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

Cầu thủ trả bóng

FileIterator – 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 đã cho.

Ủy quyền

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

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

getFilesByType(mimeType)

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

Thông 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 gồm tất cả các tệp là mục con của thư mục hiện tại và có loại MIME đã cho.

Ủy quyền

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

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

getFolders()

Lấy một tập hợp gồm 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 – 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.

Ủy quyền

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

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

getFoldersByName(name)

Lấy một tập hợp gồm 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 đã cho.

Thông số

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

Cầu thủ trả bóng

FolderIterator – Một tập hợp gồm 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 đã cho.

Ủy quyền

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

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getLastUpdated()

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

Cầu thủ trả bóng

Date – ngày Folder được cập nhật lần gần đây nhất

Ủy quyền

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

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getSecurityUpdateEligible()

Cho biết 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 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, chế độ 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 đối với 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ó thể được áp dụng cho Folder hay không.

Ủy quyền

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

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

getSecurityUpdateEnabled()

Cho biết liệu 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. Theo mặc định, yêu cầu này đượ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 đối với 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

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

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

getSharingAccess()

Lấy lớp 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

Access – nhóm 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getSharingPermission()

Lấy 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

getSize()

Lấy số byte được 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 và 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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, 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 trong trường hợp khác.

Ủy quyền

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

  • 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

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

Ủy quyền

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

  • 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.

Cầu thủ trả bóng

Booleantrue 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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

Booleantrue nếu Folder nằm trong thùng rác của Drive 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 cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • 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 được cung cấp.

Người dùng hiện tại phải là chủ sở hữu của 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 để di chuyển mục đó đến thư mục đích.

Thông số

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

Cầu thủ trả bóng

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

Ủy quyền

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

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

removeEditor(emailAddress)

Xoá người dùng đã cho 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 nhóm 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 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.

Thông số

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

Cầu thủ trả bóng

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

Ủy quyền

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

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

removeEditor(user)

Xoá người dùng đã cho 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 nhóm 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 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.

Thông số

TênLoạiMô tả
userUserThông tin về người dùng cần xoá.

Cầu thủ trả bóng

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

Ủy quyền

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

  • 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 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 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 nhóm 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 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.

Thông số

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

Cầu thủ trả bóng

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

Ủy quyền

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

  • 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 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 nhóm 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 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.

Thông số

TênLoạiMô tả
userUserThông tin về người dùng cần xoá.

Cầu thủ trả bóng

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

Ủy quyền

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

  • 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 nhóm 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.

Thông số

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

Cầu thủ trả bóng

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

Ủy quyền

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

  • 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 nhóm 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.

Thông số

TênLoạiMô tả
userUserThông tin về người dùng cần thu hồi quyền truy cập.

Cầu thủ trả bóng

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

Ủy quyền

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

  • 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à 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 trình bày chi tiết trong tài liệu về Google Drive SDK. Xin lưu ý rằng dịch vụ Drive sử dụng API Drive phiên bản 2 và một số trường truy vấn khác với phiên bản 3. Xem 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());
}

Thông 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ề Google Drive SDK.

Cầu thủ trả bóng

FileIterator – Tập hợp tất cả cá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.

Ủy quyền

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

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

searchFolders(params)

Lấy một tập hợp gồm 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 đã cho. Tiêu chí tìm kiếm được trình bày chi tiết trong tài liệu về Google Drive SDK. Xin lưu ý rằng dịch vụ Drive sử dụng API Drive phiên bản 2 và một số trường truy vấn khác với phiên bản 3. Xem 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());
}

Thông 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ề Google Drive SDK.

Cầu thủ trả bóng

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 thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

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

setDescription(description)

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

Thông số

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

Cầu thủ trả bóng

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

Ủy quyền

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

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

setName(name)

Đặt tên cho Folder.

Thông số

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

Cầu thủ trả bóng

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

Ủy quyền

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

  • 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.

Drive không hỗ trợ việc thay đổi quyền sở hữu đối với các mục thuộc sở hữu của tài khoản gmail.com; tính năng này được hỗ trợ cho tài khoản Workspace.

Thông 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

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

Ủy quyền

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

  • 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.

Drive không hỗ trợ việc thay đổi quyền sở hữu đối với các mục thuộc sở hữu của tài khoản gmail.com; tính năng này được hỗ trợ cho tài khoản Workspace.

Thông số

TênLoạiMô tả
userUserThông tin về người dùng sẽ trở thành chủ sở hữu mới.

Cầu thủ trả bóng

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

Ủy quyền

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

  • 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.

Thông số

TênLoạiMô tả
enabledBooleanCó bật yêu cầu về khoá tài nguyên cho Folder hay không.

Cầu thủ trả bóng

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

Ủy quyền

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

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

Thông số

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

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

Ủy quyền

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

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

setSharing(accessType, permissionType)

Đặt nhóm người dùng có thể truy cập vào Folder và những quyền mà những người dùng đó được cấp, 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.

// 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);

Thông số

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

Cầu thủ trả bóng

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

Ủy quyền

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

  • 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.

Thông số

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

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

Ủy quyền

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

  • 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.

Thông số

TênLoạiMô tả
trashedBooleantrue nếu Folder cần được chuyển 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

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

Ủy quyền

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

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

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