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 trong DriveApp.

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

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`addEditor(emailAddress)`	`Folder`	Thêm người dùng cụ thể vào danh sách người chỉnh sửa cho `Folder`.
`addEditor(user)`	`Folder`	Thêm người dùng cụ thể vào danh sách người chỉnh sửa cho `Folder`.
`addEditors(emailAddresses)`	`Folder`	Thêm mảng người dùng nhất định vào danh sách người chỉnh sửa cho `Folder`.
`addViewer(emailAddress)`	`Folder`	Thêm người dùng cụ thể vào danh sách người xem cho `Folder`.
`addViewer(user)`	`Folder`	Thêm người dùng cụ thể vào danh sách người xem cho `Folder`.
`addViewers(emailAddresses)`	`Folder`	Thêm mảng người dùng nhất định 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 gồm dữ liệu tuỳ ý.
`createFile(name, content)`	`File`	Tạo tệp văn bản trong thư mục hiện tại có tên và nội dung đã cho.
`createFile(name, content, mimeType)`	`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ã mục được cung cấp trên Drive rồi trả về mã đó.
`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`	`File`	Tạo lối tắt đến mã mục và khoá tài nguyên được cung cấp trên Drive rồi trả về.
`getAccess(email)`	`Permission`	Nhận quyền được cấp cho người dùng cụ thể.
`getAccess(user)`	`Permission`	Nhận quyền được cấp cho người dùng cụ thể.
`getDateCreated()`	`Date`	Xem ngày tạo `Folder`.
`getDescription()`	`String`	Lấ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()`	`FileIterator`	Lấy một 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 một tập hợp tất cả các tệp là con của thư mục hiện tại và có tên đã cho.
`getFilesByType(mimeType)`	`FileIterator`	Lấy một tập hợp gồm tất cả các tệp là con của thư mục hiện tại và có loại MIME cho sẵn.
`getFolders()`	`FolderIterator`	Lấy một tập hợp tất cả các thư mục là con của thư mục hiện tại.
`getFoldersByName(name)`	`FolderIterator`	Lấy một tập hợp tất cả các thư mục là con của thư mục hiện tại và có tên đã cho.
`getId()`	`String`	Lấy mã nhận dạng của `Folder`.
`getLastUpdated()`	`Date`	Xem ngày gần đây nhất mà `Folder` được cập nhật.
`getName()`	`String`	Lấy tên của `Folder`.
`getOwner()`	`User`	Chọn 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 một liên kết.
`getSecurityUpdateEligible()`	`Boolean`	Xem liệu `Folder` này có đủ điều kiện áp dụng bản cập nhật bảo mật hay không cần có một khoá tài nguyên để truy cập khi khoá này được chia sẻ bằng đường liên kết.
`getSecurityUpdateEnabled()`	`Boolean`	Tìm hiểu xem `Folder` này có yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng một liên kết.
`getSharingAccess()`	`Access`	Lấy lớp người dùng có thể truy cập vào `Folder`, ngoài từng cá nhân những người dùng đã được cấp quyền truy cập một cách rõ ràng.
`getSharingPermission()`	`Permission`	Được cấp quyền cho những người dùng 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 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 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 `Folder` có được phép chia sẻ với người dùng khác hoặc thay đổi quyền truy cập.
`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 trên Drive của người dùng hay không.
`moveTo(destination)`	`Folder`	Chuyển mục này đến thư mục đích được cung cấp.
`removeEditor(emailAddress)`	`Folder`	Xoá người dùng cụ thể khỏi danh sách người chỉnh sửa của `Folder`.
`removeEditor(user)`	`Folder`	Xoá người dùng cụ thể khỏi danh sách người chỉnh sửa của `Folder`.
`removeViewer(emailAddress)`	`Folder`	Xoá người dùng cụ thể khỏi danh sách người xem và người nhận xét đối với `Folder`.
`removeViewer(user)`	`Folder`	Xoá người dùng cụ thể khỏi danh sách người xem và người nhận xét đối với `Folder`.
`revokePermissions(emailAddress)`	`Folder`	Thu hồi quyền truy cập vào `Folder` được cấp cho người dùng cụ thể.
`revokePermissions(user)`	`Folder`	Thu hồi quyền truy cập vào `Folder` được cấp cho người dùng cụ thể.
`searchFiles(params)`	`FileIterator`	Lấy một tập hợp tất cả các tệp là con của thư mục hiện tại và khớp với nội dung tìm kiếm đã cho tiêu chí.
`searchFolders(params)`	`FolderIterator`	Lấy một tập hợp tất cả các thư mục là con của thư mục hiện tại và khớp với nội dung tìm kiếm đã cho tiêu chí.
`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`	Thiết lập xem `Folder` có yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng một liên kết.
`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ẻ hay không với người dùng khác hoặc thay đổi quyền truy cập.
`setSharing(accessType, permissionType)`	`Folder`	Thiết lập lớp người dùng có thể truy cập vào `Folder` và những quyền những người dùng đó, bên cạnh 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`	Thiết lập xem `Folder` có được gắn dấu sao trong Drive của người dùng hay không.
`setTrashed(trashed)`	`Folder`	Đặt `Folder` có nằm trong thùng rác trên 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 cụ thể vào danh sách người chỉnh sửa cho Folder. Nếu người dùng đã trên danh sách người xem, thì phương pháp này sẽ đưa người dùng ra 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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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`	Đạ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

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

Tham số

Tên	Loại	Mô tả
`emailAddresses`	`String[]`	Một mảng địa chỉ email của những người dùng cần thêm.

Cầu thủ trả bóng

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

Ủy quyền

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

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

`addViewer(emailAddress)`

Thêm người dùng cụ thể vào danh sách người xem cho Folder. Nếu người dùng đã trên danh sách người chỉnh sửa, thì phương thức này 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

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

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

`addViewer(user)`

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

Tham số

Tên	Loại	Mô tả
`user`	`User`	Đạ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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 nhất định vào danh sách người xem cho Folder. Nếu bất kỳ người dùng đã có trong danh sách người chỉnh sửa, nên phương pháp này không có ảnh hưởng gì đối với họ.

Tham số

Tên	Loại	Mô tả
`emailAddresses`	`String[]`	Một mảng địa chỉ email của những người dùng cần thêm.

Cầu thủ trả bóng

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

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 chứa dữ liệu tuỳ ý.

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

Tham số

Tên	Loại	Mô tả
`blob`	`BlobSource`	Dữ liệu của tệp mới.

Cầu thủ trả bóng

File — Tệp mới.

Ủy quyền

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

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

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

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

Tham số

Tên	Loại	Mô tả
`targetId`	`String`	Mã tệp của tệp hoặc thư mục đích.

Cầu thủ trả bóng

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

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 được cung cấp trên Drive rồi trả về. Tài nguyên khoá là thông số bổ sung cần được truyền để truy cập vào tệp hoặc thư mục đích đã được chia sẻ bằng một 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 đích.
`targetResourceKey`	`String`	Khoá tài nguyên của tệp hoặc thư mục đích.

Cầu thủ trả bóng

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

Ủy quyền

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

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

`getAccess(email)`

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

Tham số

Tên	Loại	Mô tả
`email`	`String`	địa chỉ email của người dùng có quyền cần được kiểm tra

Cầu thủ trả bóng

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

Ủy quyền

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

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

`getAccess(user)`

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

Tham số

Tên	Loại	Mô tả
`user`	`User`	hình ảnh đại diện cho người dùng có quyền cần được kiểm tra

Cầu thủ trả bóng

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

Ủy quyền

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

Xem ngày tạo Folder.

Cầu thủ trả bóng

Date – ngày tạo Folder

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 — mô tả cho Folder

Ủy quyền

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

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

`getEditors()`

Lấy danh sách người chỉnh sửa cho Folder này. Nếu người dùng thực thi tập lệnh không có quyền chỉnh sửa đố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 (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ảng trống.

Ủy quyền

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

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

`getFiles()`

Lấy một tập hợp 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 – Một tập hợp tất cả các tệp là con của thư mục hiện tại.

Ủy quyền

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

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

`getFilesByName(name)`

Lấy một tập hợp 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ê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 – Một tập hợp tất cả các tệp là con của thư mục hiện tại và có tên đã được đặt.

Ủy quyền

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

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

`getFilesByType(mimeType)`

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

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

Ủy quyền

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

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

`getFolders()`

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

Cầu thủ trả bóng

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

Ủy quyền

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

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

`getFoldersByName(name)`

Lấy một tập hợp tất cả các thư mục là 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 thư mục cần tìm.

Cầu thủ trả bóng

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

Ủy quyền

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

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

`getId()`

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

Cầu thủ trả bóng

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

Ủy quyền

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

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

Cầu thủ trả bóng

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

Ủy quyền

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

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

`getName()`

Lấy tên của Folder.

Cầu thủ trả bóng

String – tên của Folder

Ủy quyền

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

Chọn chủ sở hữu của Folder này.

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

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

Cầu thủ trả bóng

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

Ủy quyền

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

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

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

`getResourceKey()`

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

Cầu thủ trả bóng

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

Ủy quyền

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

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

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

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

Cầu thủ trả bóng

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

Ủy quyền

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

Tìm hiểu xem Folder này có yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng một liên kết. 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 về khoá tài nguyên cho các tệp đủ điều kiện, hãy dùng setSecurityUpdateEnabled.

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

Cầu thủ trả bóng

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

Ủy quyền

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

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

`getSharingAccess()`

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

Cầu thủ trả bóng

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

Ủy quyền

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

Được cấp quyền cho những người dùng 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 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

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

Cầu thủ trả bóng

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

Ủy quyền

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

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

`getUrl()`

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

Cầu thủ trả bóng

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

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 đố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 (viewer of viewers) {
  console.log(viewer.getName());
}

Cầu thủ trả bóng

User[] — Danh sách người xem và người nhận xét 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.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 Folder có được phép chia sẻ với người dùng khác hoặc thay đổi quyền truy cập.

Cầu thủ trả bóng

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

Ủy quyền

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

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

`isStarred()`

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

Cầu thủ trả bóng

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

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 trên Drive của người dùng hay không.

Cầu thủ trả bóng

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

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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)`

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 để di chuyển mục này vào thư mục đích.

Tham số

Tên	Loại	Mô tả
`destination`	`Folder`	Thư mục sẽ trở thành thư mục mẹ mới.

Cầu thủ trả bóng

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

Ủy quyền

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

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

`removeEditor(emailAddress)`

Xoá người dùng cụ thể khỏi danh sách người chỉnh sửa của Folder. Phương thức này không sẽ 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 đã quyền truy cập chung. Ví dụ: nếu Folder được chia sẻ với toàn bộ hoặc nếu Folder nằm trong bộ nhớ dùng chung mà người dùng có thể truy cập.

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

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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 các tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người xem.

Tham số

Tên	Loại	Mô tả
`user`	`User`	Hình ảnh đạ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

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

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

`removeViewer(emailAddress)`

Xoá người dùng cụ thể khỏi danh sách người xem và người nhận xét đối với Folder. Chiến dịch này sẽ không có hiệu lực nếu người dùng là người chỉnh sửa, không phải là người xem hoặc người nhận xét. Phương pháp 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 hoặc nếu Folder nằm trong bộ nhớ dùng chung mà người dùng có thể truy cập.

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

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

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

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

`removeViewer(user)`

Xoá người dùng cụ thể khỏi danh sách người xem và người nhận xét đối với Folder. Chiến dịch này sẽ 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 Folder nếu họ thuộc một nhóm người dùng có quyền truy cập chung quyền truy cập – ví dụ: nếu Folder được chia sẻ với toàn bộ miền của người dùng, hoặc nếu Folder nằm trong bộ nhớ dùng chung mà người dùng có thể truy cập.

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

Tham số

Tên	Loại	Mô tả
`user`	`User`	Hình ảnh đạ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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 cấp cho người dùng cụ thể. Phương thức này không sẽ 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.

Tham số

Tên	Loại	Mô tả
`emailAddress`	`String`	Địa chỉ email của người dùng có quyền truy cập cần bị thu hồi.

Cầu thủ trả bóng

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

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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`	Đại diện cho người dùng có quyền truy cập cần bị thu hồi.

Cầu thủ trả bóng

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

Ủy quyền

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

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

`searchFiles(params)`

Lấy một tập hợp tất cả các tệp là con của thư mục hiện tại và khớp với nội dung tìm kiếm đã cho tiêu chí. Tiêu chí tìm kiếm được nêu chi tiết trong tài liệu về SDK của Google Drive. Lưu ý rằng Drive dịch vụ 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 xét trường sự khác biệt 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 thận trọng để thoát khỏi 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.""
var files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var 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ư đã nêu chi tiết trong tài liệu về SDK của Google Drive.

Cầu thủ trả bóng

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

Ủy quyền

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

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

`searchFolders(params)`

Lấy một tập hợp tất cả các thư mục là con của thư mục hiện tại và khớp với nội dung tìm kiếm đã cho tiêu chí. Tiêu chí tìm kiếm được nêu chi tiết trong tài liệu về SDK của Google Drive. Lưu ý rằng Drive dịch vụ 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 xét trường sự khác biệt 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.
var folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var 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ư đã nêu chi tiết trong tài liệu về SDK của Google Drive.

Cầu thủ trả bóng

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

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 về `Folder`

Cầu thủ trả bóng

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

Ủy quyền

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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 cung 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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 cung 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`	hình đạ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

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

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

`setSecurityUpdateEnabled(enabled)`

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

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

Tham số

Tên	Loại	Mô tả
`enabled`	`Boolean`	Liệu 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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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ẻ hay không với người dùng khác hoặc thay đổi quyền truy cập. 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 phải được phép chia sẻ với người dùng khác hoặc thay đổi quyền; `false` nếu không phải

Cầu thủ trả bóng

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

Ủy quyền

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

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

`setSharing(accessType, permissionType)`

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

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

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`	các quyền sẽ được cấp cho 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

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

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

`setStarred(starred)`

Thiết lập xem Folder có được gắn dấu sao trong Drive của người dùng hay không. 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 phần cài đặt của người dùng Lái xe; `false` nếu không

Cầu thủ trả bóng

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

Ủy quyền

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

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

`setTrashed(trashed)`

Đặt Folder có nằm trong thùng rác trên Drive của người dùng hay không. Chỉ chủ sở hữu 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 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

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 phần tử mẹ đồng thời.

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 vào làm phần tử con.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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ó của tệp này; một thư mục có thể có nhiều thư mục mẹ cùng 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 vào làm cấp độ con.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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ả các tệp gốc, thì tệp đó sẽ không thể nhìn thấy trong Drive trừ phi bằng cách tìm kiếm cho đơn vị quảng cáo đó hoặc sử dụng nút "Tất cả các mục" chế độ xem.

Tham số

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

Cầu thủ trả bóng

Folder — Nhà xuất bản mẹ trước của phần tử con.

Ủy quyền

Tập lệnh sử dụng phương thức này yêu cầu ủy 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 gốc thì không thể nhìn thấy thư mục đó trong Drive ngoại trừ bằng cách tìm kiếm nội dung đó hoặc sử dụng "Tất cả các mục" chế độ xem.

Tham số

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

Cầu thủ trả bóng

Folder — Nhà xuất bản mẹ trước của phần tử con.

Ủy quyền

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

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