Một thư mục trong Google Drive. Bạn có thể truy cập hoặc tạo thư mục bằng 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 | Kiểu 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 của Folder . |
addEditor(user) | Folder | Thêm người dùng đã cho vào danh sách người chỉnh sửa của Folder . |
addEditors(emailAddresses) | Folder | Thêm mảng người dùng đã cho vào danh sách trình chỉnh sửa của Folder . |
addViewer(emailAddress) | Folder | Thêm người dùng cụ thể vào danh sách người xem của Folder . |
addViewer(user) | Folder | Thêm người dùng cụ thể 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 của Folder . |
createFile(blob) | File | Tạo một tệp trong thư mục hiện tại từ Blob dữ liệu tuỳ ý nhất định. |
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 bằng tên đã cho. |
createShortcut(targetId) | File | Tạo một lối tắt đến mã mục Drive được cung cấp rồi trả về mã đó. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | Tạo một lối tắt đến mã mục Drive và khoá tài nguyên được cung cấp rồi trả về mã đó. |
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 | 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 người chỉnh sửa cho Folder này. |
getFiles() | FileIterator | Lấy 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. |
getFilesByName(name) | FileIterator | Lấy 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 cụ thể. |
getFilesByType(mimeType) | FileIterator | Lấy 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 đã cho. |
getFolders() | FolderIterator | Lấy một 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. |
getFoldersByName(name) | FolderIterator | Lấy một 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à có tên cụ thể. |
getId() | String | Lấy mã nhận dạng của Folder . |
getLastUpdated() | Date | Lấy ngày cập nhật Folder gần đây nhất. |
getName() | String | Lấy tên của Folder . |
getOwner() | User | Tìm 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ành phần 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 đường liên kết. |
getSecurityUpdateEligible() | Boolean | Kiểm tra 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 một đường liên kết hay không. |
getSecurityUpdateEnabled() | Boolean | Biết được 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 đường liên kết. |
getSharingAccess() | Access | Lấy thông tin về lớp người dùng có thể truy cập vào Folder , ngoài từng người dùng riêng lẻ đã được cấp quyền truy cập một cách 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 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[] | Xem 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 hoặc 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ó trong thùng rác trong Drive của người dùng hay không. |
moveTo(destination) | Folder | Di chuyển mục này sang thư mục đích đã 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 của 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 của Folder . |
revokePermissions(emailAddress) | Folder | Thu hồi quyền truy cập Folder đã cấp cho người dùng đã cấp. |
revokePermissions(user) | Folder | Thu hồi quyền truy cập Folder đã cấp cho người dùng đã cấp. |
searchFiles(params) | FileIterator | Lấy 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à khớp với các tiêu chí tìm kiếm nhất định. |
searchFolders(params) | FolderIterator | Lấy một 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 các tiêu chí tìm kiếm nhất định. |
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 đường liên kết. |
setShareableByEditors(shareable) | Folder | Thiết lập xem người dùng có quyền chỉnh sửa đối với Folder có được phép chia sẻ với người dùng khác hoặc thay đổi quyền hay không. |
setSharing(accessType, permissionType) | Folder | Đặt lớp người dùng có thể truy cập vào Folder và những quyền mà người dùng đó được cấp, ngoài bất kỳ người dùng cá nhân nào đã được cấp quyền truy cập rõ ràng. |
setStarred(starred) | Folder | 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 | Thiết lập liệu Folder có trong thùng rác trong Drive của người dùng hay không. |
Tài liệu chi tiết
addEditor(emailAddress)
Thêm người dùng đã cho vào danh sách người chỉnh sửa của Folder
. Nếu người dùng đã có trong danh sách người xem, phương thức này sẽ đẩy người dùng ra khỏi danh sách người xem.
Các tham số
Tên | Loại | Nội dung 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 cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
addEditor(user)
Thêm người dùng đã cho vào danh sách người chỉnh sửa của Folder
. Nếu người dùng đã có trong danh sách người xem, phương thức này sẽ đẩy người dùng ra khỏi danh sách người xem.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | Đại diện cho người dùng mà bạn 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 cần đượ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 trình chỉnh sửa của Folder
. Nếu bất kỳ người dùng nào đã có trong danh sách người xem, phương thức này sẽ thăng hạng họ ra khỏi danh sách người xem.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddresses | String[] | Một mảng đị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 cần đượ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 cụ thể 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.
Các tham số
Tên | Loại | Nội dung 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 cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
addViewer(user)
Thêm người dùng cụ thể 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | Đại diện cho người dùng mà bạn 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 cần đượ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 của 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ọ.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddresses | String[] | Một mảng đị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 cần đượ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ừ Blob
dữ liệu tuỳ ý nhất định.
// 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);
Các tham số
Tên | Loại | Nội dung 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 cần đượ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 trường hợp 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!');
Các tham số
Tên | Loại | Nội dung 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 cần đượ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 một trường hợp 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);
Các tham số
Tên | Loại | Nội dung 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 cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
createFolder(name)
createShortcut(targetId)
Tạo một lối tắt đến mã mục Drive được cung cấp rồi trả về mã đó.
Các tham số
Tên | Loại | Nội dung 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 cần đượ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 một lối tắt đến mã mục Drive và khoá tài nguyên được cung cấp rồi trả về mã đó. Khoá tài nguyên là một thông số bổ sung cần được truyền để truy cập vào tệp mục tiêu hoặc thư mục đã đượ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()); }
Các tham số
Tên | Loại | Nội dung 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 cần được uỷ 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ể.
Các tham số
Tên | Loại | Nội dung 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
– quyền đã cấp cho người dùng
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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)
Nhận quyền được cấp cho người dùng cụ thể.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | hình ảnh đại diện cho người dùng có quyền cần được đánh dấu |
Cầu thủ trả bóng
Permission
– quyền đã cấp cho người dùng
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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()
getDescription()
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 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 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 trình chỉnh sửa của Folder
này nếu người dùng có quyền chỉnh sửa hoặc nếu không có một mảng trống.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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 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.
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 cần đượ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 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 cụ thể.
Các tham số
Tên | Loại | Nội dung 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 cụ thể.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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 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 đã cho.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
mimeType | String | Loại MIME của 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ó loại MIME đã cho.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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 một 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.
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 cần đượ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 một 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à có tên cụ thể.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | Tên của các thư mục cần tìm. |
Cầu thủ trả bóng
FolderIterator
– 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ụ thể.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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()
getLastUpdated()
getName()
getOwner()
Tìm 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 cần đượ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ành phần 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ành phần mẹ trực tiếp của Folder
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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 một đường 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 cần đượ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()
Kiểm tra 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 một đường liên kết hay không.
Drive yêu cầu có khoá tài nguyên để truy cập 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 một bản cập nhật bảo mật. Bản cập nhật được bật theo mặc định đối với các tệp và thư mục đủ điều kiện. Để bật hoặc tắt yêu cầu 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 cần đượ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()
Biết được 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 đường liên kết. Yêu cầu này được bật theo mặc định đối với các tệp và thư mục đủ điều kiện.
Để bật hoặc tắt yêu cầu 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 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 cần đượ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()
Lấy thông tin về lớp người dùng có thể truy cập vào Folder
, ngoài từ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
– 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 cần đượ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 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
— 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 cần đượ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 trên Google Workspace không được tính vào hạn mức bộ nhớ Drive nên 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
Tập lệnh sử dụng phương thức này cần đượ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 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 cần đượ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()
Xem 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 (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 của 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 cần đượ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
Tập lệnh sử dụng phương thức này cần đượ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ó trong thùng rác trong 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 cần đượ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 sang thư mục đích đã cung cấp.
Người dùng hiện tại phải là chủ sở hữu 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 thì mới có thể di chuyển mục này vào thư mục đích.
Các tham số
Tên | Loại | Nội dung 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
Tập lệnh sử dụng phương thức này cần đượ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 cụ thể 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 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 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.
Các tham số
Tên | Loại | Nội dung 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 cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
removeEditor(user)
Xoá người dùng cụ thể 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 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 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | Biểu thị 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 cần đượ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 cụ thể khỏi danh sách người xem và người nhận xét của Folder
. Phương thức này không có tác dụng nếu người dùng là người chỉnh sửa chứ không phải là người xem hoặc người nhận xét. 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 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.
Các tham số
Tên | Loại | Nội dung 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 cần đượ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 cụ thể khỏi danh sách người xem và người nhận xét 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 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 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | Biểu thị 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 cần đượ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 Folder
đã cấp cho người dùng đã cấp. 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng có quyền truy cập 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 cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
revokePermissions(user)
Thu hồi quyền truy cập Folder
đã cấp cho người dùng đã cấp. 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | Biểu thị 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
Tập lệnh sử dụng phương thức này cần đượ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 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à khớp với các tiêu chí tìm kiếm nhất định. 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 v2 và v3.
Đố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 chú ý thoát dấu ngoặc kép 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()); }
Các tham số
Tên | Loại | Nội dung 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
– 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 tiêu chí tìm kiếm.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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 một 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 các tiêu chí tìm kiếm nhất định. 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 v2 và v3.
Đố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 chú ý thoát dấu ngoặc kép 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. var folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners'); while (folders.hasNext()) { var folder = folders.next(); console.log(folder.getName()); }
Các tham số
Tên | Loại | Nội dung 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
– 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 tiêu chí tìm kiếm.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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)
setName(name)
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 vào Folder
.
Các tham số
Tên | Loại | Nội dung 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 cần đượ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 vào Folder
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | đại diện cho 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 cần được uỷ 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 đường 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
enabled | Boolean | Liệu 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, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần đượ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 lớp người dùng có thể truy cập vào Folder
và những quyền mà người dùng đó được cấp, ngoài bất kỳ người dùng cá nhân nào đã được cấp quyền truy cập rõ ràng.
// Creates a folder that anyone on the Internet can read from and write to. (Domain // administrators can prohibit this setting for users of a Google Workspace domain.) var folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
accessType | Access | lớp người dùng nào có thể truy cập Folder |
permissionType | Permission | các quyền cần được cấp cho người dùng có thể truy cập 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 cần được uỷ 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. Tuỳ chọn mặc định cho các Folder
mới là false
.
Các tham số
Tên | Loại | Nội dung 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 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 cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
setTrashed(trashed)
Thiết lập liệu Folder
có trong thùng rác trong 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. Chế độ mặc định cho các Folder
mới là false
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
trashed | Boolean | true nếu chuyển Folder 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, để tạo chuỗi
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive