Một thư mục trong Google Drive. Bạn có thể truy cập hoặc tạo thư mục từ Drive.
// 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 | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
add | Folder | Thêm người dùng đã cho vào danh sách người chỉnh sửa cho Folder. |
add | Folder | Thêm người dùng đã cho vào danh sách người chỉnh sửa cho Folder. |
add | Folder | Thêm mảng người dùng đã cho vào danh sách người chỉnh sửa cho Folder. |
add | Folder | Thêm người dùng đã cho vào danh sách người xem của Folder. |
add | Folder | Thêm người dùng đã cho vào danh sách người xem của Folder. |
add | Folder | Thêm mảng người dùng đã cho vào danh sách người xem cho Folder. |
create | File | Tạo một tệp trong thư mục hiện tại từ một Blob dữ liệu tuỳ ý đã cho. |
create | File | 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. |
create | 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. |
create | Folder | Tạo một thư mục trong thư mục hiện tại bằng tên đã cho. |
create | 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 đó. |
create | File | 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 đó. |
get | Permission | Lấy quyền được cấp cho một người dùng cụ thể. |
get | Permission | Lấy quyền được cấp cho một người dùng cụ thể. |
get | Date | Lấy ngày tạo Folder. |
get | String | Lấy nội dung mô tả cho Folder. |
get | User[] | Lấy danh sách người chỉnh sửa cho Folder này. |
get | File | 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. |
get | File | 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. |
get | File | 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. |
get | Folder | 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. |
get | Folder | 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. |
get | String | Lấy mã nhận dạng của Folder. |
get | Date | Lấy ngày Folder được cập nhật gần đây nhất. |
get | String | Lấy tên của Folder. |
get | User | Lấy chủ sở hữu của Folder này. |
get | Folder | 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. |
get | 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. |
get | Boolean | 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. |
get | Boolean | 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. |
get | Access | 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. |
get | Permission | 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. |
get | Integer | Lấy số byte được dùng để lưu trữ Folder trong Drive. |
get | 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. |
get | User[] | Lấy danh sách người xem và người nhận xét cho Folder này. |
is | 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 hoặc thay đổi quyền hay không. |
is | Boolean | Xác định xem Folder có được gắn dấu sao trong Drive của người dùng hay không. |
is | 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. |
move | Folder | Di chuyển mục này đến thư mục đích được cung cấp. |
remove | Folder | Xoá người dùng đã cho khỏi danh sách người chỉnh sửa của Folder. |
remove | Folder | Xoá người dùng đã cho khỏi danh sách người chỉnh sửa của Folder. |
remove | Folder | Xoá người dùng đã cho khỏi danh sách người xem và người bình luận của Folder. |
remove | Folder | Xoá người dùng đã cho khỏi danh sách người xem và người bình luận của Folder. |
revoke | Folder | Thu hồi quyền truy cập vào Folder đã cấp cho người dùng cụ thể. |
revoke | Folder | Thu hồi quyền truy cập vào Folder đã cấp cho người dùng cụ thể. |
search | File | 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. |
search | Folder | 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. |
set | Folder | Đặt nội dung mô tả cho Folder. |
set | Folder | Đặt tên cho Folder. |
set | Folder | Thay đổi chủ sở hữu của Folder. |
set | Folder | Thay đổi chủ sở hữu của Folder. |
set | 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. |
set | 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. |
set | 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. |
set | Folder | Đặt xem Folder có được gắn dấu sao trong Drive của người dùng hay không. |
set | 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
add Editor(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ên | Loại | Mô tả |
|---|---|---|
email | String | Địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
Folder — Folder 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
add Editor(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ên | Loại | Mô tả |
|---|---|---|
user | User | Thông tin về người dùng cần thêm. |
Cầu thủ trả bóng
Folder – Folder 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
add Editors(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ên | Loại | Mô tả |
|---|---|---|
email | String[] | 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
Folder — Folder 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
add Viewer(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ên | Loại | Mô tả |
|---|---|---|
email | String | Địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
Folder – Folder 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
add Viewer(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ên | Loại | Mô tả |
|---|---|---|
user | User | Thông tin về người dùng cần thêm. |
Cầu thủ trả bóng
Folder – Folder 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
add Viewers(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ên | Loại | Mô tả |
|---|---|---|
email | String[] | 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
Folder — Folder 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
create File(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ên | Loại | Mô tả |
|---|---|---|
blob | Blob | 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 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
create File(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ê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 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
create File(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ê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. |
mime | 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 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
create Folder(name)
create Shortcut(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ên | Loại | Mô tả |
|---|---|---|
target | 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 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
create Shortcut For Target Id And Resource Key(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ên | Loại | Mô tả |
|---|---|---|
target | String | Mã của tệp hoặc thư mục mục tiêu. |
target | 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
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
get Access(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ên | Loại | Mô tả |
|---|---|---|
email | String | Đị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
get Access(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ên | Loại | Mô tả |
|---|---|---|
user | User | Thô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
get Date Created()
get Description()
get Editors()
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
get Files()
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
File – 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
get Files By Name(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ê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
File – 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
get Files By Type(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ên | Loại | Mô tả |
|---|---|---|
mime | String | Loại MIME của các tệp cần tìm. |
Cầu thủ trả bóng
File – 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
get Folders()
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
Folder – 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
get Folders By Name(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ê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
Folder – 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
get Id()
get Last Updated()
get Name()
get Owner()
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
get Parents()
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
Folder – 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
get Resource Key()
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
get Security Update Eligible()
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 set.
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
get Security Update Enabled()
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
get Sharing Access()
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
get Sharing Permission()
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
get Size()
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
get Url()
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
get Viewers()
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
is Starred()
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
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 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
is Trashed()
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 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
move To(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ê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, để 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
remove Editor(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ên | Loại | Mô tả |
|---|---|---|
email | String | Địa chỉ email của người dùng cần xoá. |
Cầu thủ trả bóng
Folder — Folder 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
remove Editor(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ên | Loại | Mô tả |
|---|---|---|
user | User | Thông tin về người dùng cần xoá. |
Cầu thủ trả bóng
Folder – Folder 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
remove Viewer(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ên | Loại | Mô tả |
|---|---|---|
email | String | Địa chỉ email của người dùng cần xoá. |
Cầu thủ trả bóng
Folder – Folder 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
remove Viewer(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ên | Loại | Mô tả |
|---|---|---|
user | User | Thông tin về người dùng cần xoá. |
Cầu thủ trả bóng
Folder – Folder 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
revoke Permissions(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ên | Loại | Mô tả |
|---|---|---|
email | String | Đị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
Folder — Folder 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
revoke Permissions(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ên | Loại | Mô tả |
|---|---|---|
user | User | Thông tin về người dùng cần thu hồi quyền truy cập. |
Cầu thủ trả bóng
Folder — Folder 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
search Files(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ê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ề Google Drive SDK. |
Cầu thủ trả bóng
File – 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
search Folders(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ê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ề Google Drive SDK. |
Cầu thủ trả bóng
Folder – 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
set Description(description)
set Name(name)
set Owner(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ên | Loại | Mô tả |
|---|---|---|
email | 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, để 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
set Owner(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ên | Loại | Mô tả |
|---|---|---|
user | User | Thông tin về người dùng sẽ trở thành chủ sở hữu mới. |
Cầu thủ trả bóng
Folder — Folder 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
set Security Update Enabled(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ên | Loại | Mô tả |
|---|---|---|
enabled | Boolean | Có bật yêu cầu về khoá tài nguyên cho Folder hay không. |
Cầu thủ trả bóng
Folder — Folder 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
set Sharing(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ên | Loại | Mô tả |
|---|---|---|
access | Access | những nhóm người dùng nào có thể truy cập vào Folder |
permission | Permission | cá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
Folder – Folder 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
set Starred(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ên | Loại | Mô tả |
|---|---|---|
starred | Boolean | true 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
Folder – Folder 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
set Trashed(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ên | Loại | Mô tả |
|---|---|---|
trashed | Boolean | true 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
Folder – Folder 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