Trang này được dịch bởi Cloud Translation API.

Class Folder

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ức	Loại dữ liệu trả về	Mô tả ngắn
`addEditor(emailAddress)`	`Folder`	Thêm người dùng đã cho vào danh sách người chỉnh sửa cho `Folder`.
`addEditor(user)`	`Folder`	Thêm người dùng đã cho vào danh sách người chỉnh sửa cho `Folder`.
`addEditors(emailAddresses)`	`Folder`	Thêm mảng người dùng đã cho vào danh sách người chỉnh sửa cho `Folder`.
`addViewer(emailAddress)`	`Folder`	Thêm người dùng đã cho vào danh sách người xem của `Folder`.
`addViewer(user)`	`Folder`	Thêm người dùng đã cho vào danh sách người xem của `Folder`.
`addViewers(emailAddresses)`	`Folder`	Thêm mảng người dùng đã cho vào danh sách người xem cho `Folder`.
`createFile(blob)`	`File`	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ỳ ý.
`createFile(name, content)`	`File`	Tạo một tệp văn bản trong thư mục hiện tại có tên và nội dung đã cho.
`createFile(name, content, mimeType)`	`File`	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.
`createFolder(name)`	`Folder`	Tạo một thư mục trong thư mục hiện tại có tên đã cho.
`createShortcut(targetId)`	`File`	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 đó.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	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 đó.
`getAccess(email)`	`Permission`	Lấy quyền được cấp cho một người dùng cụ thể.
`getAccess(user)`	`Permission`	Lấy quyền được cấp cho một người dùng cụ thể.
`getDateCreated()`	`Date`	Lấy ngày tạo `Folder`.
`getDescription()`	`String`	Lấ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()`	`FileIterator`	Lấ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)`	`FileIterator`	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ó tên đã cho.
`getFilesByType(mimeType)`	`FileIterator`	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.
`getFolders()`	`FolderIterator`	Lấy tập hợp tất cả thư mục con của thư mục hiện tại.
`getFoldersByName(name)`	`FolderIterator`	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.
`getId()`	`String`	Lấy mã nhận dạng của `Folder`.
`getLastUpdated()`	`Date`	Lấy ngày gần đây nhất `Folder` được cập nhật.
`getName()`	`String`	Lấy tên của `Folder`.
`getOwner()`	`User`	Lấy chủ sở hữu của `Folder` này.
`getParents()`	`FolderIterator`	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`.
`getResourceKey()`	`String`	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.
`getSecurityUpdateEligible()`	`Boolean`	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.
`getSecurityUpdateEnabled()`	`Boolean`	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.
`getSharingAccess()`	`Access`	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.
`getSharingPermission()`	`Permission`	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.
`getSize()`	`Integer`	Lấy số byte dùng để lưu trữ `Folder` trong Drive.
`getUrl()`	`String`	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.
`getViewers()`	`User[]`	Lấy danh sách người xem và người nhận xét cho `Folder` này.
`isShareableByEditors()`	`Boolean`	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.
`isStarred()`	`Boolean`	Xác định xem `Folder` đã được gắn dấu sao trong Drive của người dùng hay chưa.
`isTrashed()`	`Boolean`	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.
`moveTo(destination)`	`Folder`	Di chuyển mục này đến thư mục đích đã cung cấp.
`removeEditor(emailAddress)`	`Folder`	Xoá người dùng đã cho khỏi danh sách trình chỉnh sửa cho `Folder`.
`removeEditor(user)`	`Folder`	Xoá người dùng đã cho khỏi danh sách trình chỉnh sửa cho `Folder`.
`removeViewer(emailAddress)`	`Folder`	Xoá người dùng đã cho khỏi danh sách người xem và người bình luận cho `Folder`.
`removeViewer(user)`	`Folder`	Xoá người dùng đã cho khỏi danh sách người xem và người bình luận cho `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Thu hồi quyền truy cập vào `Folder` đã cấp cho người dùng cụ thể.
`revokePermissions(user)`	`Folder`	Thu hồi quyền truy cập vào `Folder` đã cấp cho người dùng cụ thể.
`searchFiles(params)`	`FileIterator`	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.
`searchFolders(params)`	`FolderIterator`	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.
`setDescription(description)`	`Folder`	Đặt nội dung mô tả cho `Folder`.
`setName(name)`	`Folder`	Đặt tên cho `Folder`.
`setOwner(emailAddress)`	`Folder`	Thay đổi chủ sở hữu của `Folder`.
`setOwner(user)`	`Folder`	Thay đổ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 những người dùng riêng lẻ đã đượ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.

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

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`addFile(child)`	`Folder`	Thêm tệp đã cho vào thư mục hiện tại.
`addFolder(child)`	`Folder`	Thêm thư mục đã cho vào thư mục hiện tại.
`removeFile(child)`	`Folder`	Xoá tệp đã cho khỏi thư mục hiện tại.
`removeFolder(child)`	`Folder`	Xoá thư mục đã cho khỏi thư mục hiện tại.

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ên	Loại	Mô tả
`emailAddress`	`String`	Đị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)`

Tham số

Tên	Loại	Mô tả
`user`	`User`	Nộ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ên	Loại	Mô tả
`emailAddresses`	`String[]`	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ên	Loại	Mô tả
`emailAddress`	`String`	Đị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)`

Tham số

Tên	Loại	Mô tả
`user`	`User`	Nộ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 có hiệu lực đối với họ.

Tham số

Tên	Loại	Mô tả
`emailAddresses`	`String[]`	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ên	Loại	Mô tả
`blob`	`BlobSource`	Dữ 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 có 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ên	Loại	Mô tả
`name`	`String`	Tên của tệp mới.
`content`	`String`	Nộ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ên	Loại	Mô tả
`name`	`String`	Tên của tệp mới.
`content`	`String`	Nội dung của tệp mới.
`mimeType`	`String`	Loạ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ên	Loại	Mô tả
`name`	`String`	Tê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ên	Loại	Mô tả
`targetId`	`String`	Mã 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ên	Loại	Mô tả
`targetId`	`String`	Mã của tệp hoặc thư mục mục tiêu.
`targetResourceKey`	`String`	Khoá 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ên	Loại	Mô tả
`email`	`String`	Đị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)`

Tham số

Tên	Loại	Mô tả
`user`	`User`	Biể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ả tệp là tệp con của thư mục hiện tại và có tên đã cho.

Tham số

Tên	Loại	Mô tả
`name`	`String`	Tê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ên	Loại	Mô tả
`mimeType`	`String`	Loạ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ên	Loại	Mô tả
`name`	`String`	Tê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 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 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ên	Loại	Mô tả
`destination`	`Folder`	Thư 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ên	Loại	Mô tả
`emailAddress`	`String`	Đị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)`

Đố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ên	Loại	Mô tả
`user`	`User`	Thô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ên	Loại	Mô tả
`emailAddress`	`String`	Đị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ên	Loại	Mô tả
`user`	`User`	Thô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ên	Loại	Mô tả
`emailAddress`	`String`	Đị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)`

Tham số

Tên	Loại	Mô tả
`user`	`User`	Thô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ên	Loại	Mô tả
`params`	`String`	Tiê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.

// 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ên	Loại	Mô tả
`params`	`String`	Tiê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ên	Loại	Mô tả
`description`	`String`	nộ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ên	Loại	Mô tả
`name`	`String`	tê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ên	Loại	Mô tả
`emailAddress`	`String`	đị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ên	Loại	Mô tả
`user`	`User`	thô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ên	Loại	Mô tả
`enabled`	`Boolean`	Có 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ên	Loại	Mô tả
`shareable`	`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

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 những người dùng riêng lẻ đã đượ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ên	Loại	Mô tả
`accessType`	`Access`	lớp người dùng nào có thể truy cập vào `Folder`
`permissionType`	`Permission`	quyề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ên	Loại	Mô tả
`starred`	`Boolean`	`true` 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ên	Loại	Mô tả
`trashed`	`Boolean`	`true` 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

`addFile(child)`

Không dùng nữa. Thay vào đó, hãy sử dụng File.moveTo(destination) hoặc createShortcut(targetId).

Thêm tệp đã cho vào thư mục hiện tại. Phương thức này không di chuyển tệp ra khỏi thư mục mẹ hiện có; một tệp có thể có nhiều thư mục mẹ cùng một lúc.

Tham số

Tên	Loại	Mô tả
`child`	`File`	Tệp con cần thêm.

Cầu thủ trả bóng

Folder – Phần tử mẹ mới của tệp được thêm dưới dạng phần tử con.

Ủ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

`addFolder(child)`

Không dùng nữa. Thay vào đó, hãy sử dụng moveTo(destination) hoặc createShortcut(targetId).

Thêm thư mục đã cho vào thư mục hiện tại. Phương thức này không di chuyển thư mục ra khỏi thư mục mẹ hiện có; một thư mục có thể có nhiều thư mục mẹ cùng một lúc.

Tham số

Tên	Loại	Mô tả
`child`	`Folder`	Thư mục con cần thêm.

Cầu thủ trả bóng

Folder – Thư mục mẹ mới của thư mục được thêm dưới dạng thư mục con.

Ủ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

`removeFile(child)`

Không dùng nữa. Thay vào đó, hãy sử dụng File.moveTo(destination).

Xoá tệp đã cho khỏi thư mục hiện tại. Phương thức này không xoá tệp, nhưng nếu một tệp bị xoá khỏi tất cả thư mục mẹ, thì bạn sẽ không thể thấy tệp đó trong Drive, trừ phi tìm kiếm tệp đó hoặc sử dụng chế độ xem "Tất cả mục".

Tham số

Tên	Loại	Mô tả
`child`	`File`	Tệp con cần xoá.

Cầu thủ trả bóng

Folder – Phần tử mẹ trước đó của phần tử con.

Ủ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

`removeFolder(child)`

Không dùng nữa. Thay vào đó, hãy sử dụng moveTo(destination).

Xoá thư mục đã cho khỏi thư mục hiện tại. Phương thức này không xoá thư mục hoặc nội dung của thư mục, nhưng nếu một thư mục bị xoá khỏi tất cả thư mục mẹ, thì bạn sẽ không thấy thư mục đó trong Drive, trừ phi tìm kiếm thư mục đó hoặc sử dụng chế độ xem "Tất cả mục".

Tham số

Tên	Loại	Mô tả
`child`	`Folder`	Thư mục con cần xoá.

Cầu thủ trả bóng

Folder – Phần tử mẹ trước đó của phần tử con.

Ủ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