Một tệp trong Google Drive. Bạn có thể truy cập hoặc tạo tệp từ DriveApp.
// Trash every untitled spreadsheet that hasn't been updated in a week. const files = DriveApp.getFilesByName('Untitled spreadsheet'); while (files.hasNext()) { const file = files.next(); if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) { file.setTrashed(true); } }
Phương thức
| Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
add | File | Thêm người dùng đã cho vào danh sách người bình luận cho File. |
add | File | Thêm người dùng đã cho vào danh sách người bình luận cho File. |
add | File | Thêm mảng người dùng đã cho vào danh sách người bình luận cho File. |
add | File | Thêm người dùng đã cho vào danh sách người chỉnh sửa cho File. |
add | File | Thêm người dùng đã cho vào danh sách người chỉnh sửa cho File. |
add | File | Thêm mảng người dùng đã cho vào danh sách người chỉnh sửa cho File. |
add | File | Thêm người dùng đã cho vào danh sách người xem của File. |
add | File | Thêm người dùng đã cho vào danh sách người xem của File. |
add | File | Thêm mảng người dùng đã cho vào danh sách người xem cho File. |
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 | Blob | Trả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi sang loại nội dung đã chỉ định. |
get | Blob | Trả về dữ liệu bên trong đối tượng này dưới dạng một blob. |
get | Date | Lấy ngày tạo File. |
get | String | Lấy nội dung mô tả cho File. |
get | String | Lấy URL có thể dùng để tải tệp xuống. |
get | User[] | Lấy danh sách người chỉnh sửa cho File này. |
get | String | Lấy mã nhận dạng của File. |
get | Date | Lấy ngày File được cập nhật gần đây nhất. |
get | String | Lấy loại MIME của tệp. |
get | String | Lấy tên của File. |
get | User | Lấy chủ sở hữu tệp. |
get | Folder | Lấy một tập hợp các thư mục là thư mục mẹ ngay phía trên của File. |
get | String | Lấy khoá tài nguyên của File 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 File 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 File 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 File, 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 File, 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ữ File trong Drive. |
get | String|null | Nếu đây là một Lối tắt, hãy trả về mã nhận dạng của mục mà lối tắt đó trỏ đến. |
get | String|null | Nếu đây là một Lối tắt, thì phương thức này sẽ trả về loại MIME của mục mà lối tắt đó trỏ đến. |
get | String|null | Nếu tệp là một lối tắt, hàm này sẽ trả về khoá tài nguyên của mục mà lối tắt đó trỏ đến. |
get | Blob|null | Lấy hình thu nhỏ của tệp hoặc null nếu không có hình thu nhỏ. |
get | String | Lấy URL có thể dùng để mở File 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 File này. |
is | Boolean | Xác định xem người dùng có quyền chỉnh sửa đối với File 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 File có được gắn dấu sao trong Drive của người dùng hay không. |
is | Boolean | Xác định xem File có nằm trong thùng rác của Drive của người dùng hay không. |
make | File | Tạo bản sao của tệp. |
make | File | Tạo một bản sao của tệp trong thư mục đích. |
make | File | Tạo bản sao của tệp và đặt tên cho tệp đó bằng tên bạn cung cấp. |
make | File | Tạo bản sao của tệp trong thư mục đích và đặt tên cho tệp đó bằng tên đã cung cấp. |
move | File | Di chuyển mục này đến thư mục đích được cung cấp. |
remove | File | Xoá người dùng đã cho khỏi danh sách người bình luận của File. |
remove | File | Xoá người dùng đã cho khỏi danh sách người bình luận của File. |
remove | File | Xoá người dùng đã cho khỏi danh sách người chỉnh sửa của File. |
remove | File | Xoá người dùng đã cho khỏi danh sách người chỉnh sửa của File. |
remove | File | Xoá người dùng đã cho khỏi danh sách người xem và người bình luận của File. |
remove | File | Xoá người dùng đã cho khỏi danh sách người xem và người bình luận của File. |
revoke | File | Thu hồi quyền truy cập vào File đã cấp cho người dùng cụ thể. |
revoke | File | Thu hồi quyền truy cập vào File đã cấp cho người dùng cụ thể. |
set | File | Ghi đè nội dung của tệp bằng một nội dung thay thế nhất định. |
set | File | Đặt nội dung mô tả cho File. |
set | File | Đặt tên cho File. |
set | File | Thay đổi chủ sở hữu của File. |
set | File | Thay đổi chủ sở hữu của File. |
set | File | Đặt xem File 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 | File | Đặt xem người dùng có quyền chỉnh sửa đối với File có được phép chia sẻ với người dùng khác hoặc thay đổi quyền hay không. |
set | File | Đặt nhóm người dùng có thể truy cập vào File 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 | File | Đặt xem File có được gắn dấu sao trong Drive của người dùng hay không. |
set | File | Đặt xem File 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
addCommenter(emailAddress)
Thêm người dùng đã cho vào danh sách người bình luận cho File. 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.
const files = DriveApp.getFilesByName('Test'); // Loops through the files while (files.hasNext()) { const file = files.next(); file.addCommenter('hello@example.com'); }
Tham 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
File – File 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
addCommenter(user)
Thêm người dùng đã cho vào danh sách người bình luận cho File. 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.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Adds the active user as a commenter. while (files.hasNext()) { const file = files.next(); file.addCommenter(Session.getActiveUser()); }
Tham 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
File – File 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
addCommenters(emailAddresses)
Thêm mảng người dùng đã cho vào danh sách người bình luận cho File. Nếu bất kỳ người dùng nào đã có trong danh sách người xem, thì phương thức này sẽ loại bỏ họ khỏi danh sách người xem.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); while (files.hasNext()) { const file = files.next(); // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and // 'baklavainthebalkans@gmail.com' with the email addresses to add as // commenters. const emails = [ 'cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com', ]; console.log(file.addCommenters(emails)); }
Tham 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
File – File 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
addEditor(emailAddress)
Thêm người dùng đã cho vào danh sách người chỉnh sửa cho File. 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.
Tham 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
File – File 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
addEditor(user)
Thêm người dùng đã cho vào danh sách người chỉnh sửa cho File. 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.
Tham 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
File – File này dùng để xâu chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive
addEditors(emailAddresses)
Thêm mảng người dùng đã cho vào danh sách người chỉnh sửa cho File. Nếu có người dùng nào đó đã có trong danh sách người xem, thì phương thức này sẽ loại họ ra khỏi danh sách người xem.
Tham 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
File – File này dùng để xâu chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive
addViewer(emailAddress)
Thêm người dùng đã cho vào danh sách người xem của File. Nếu người dùng đã có trong danh sách người chỉnh sửa, thì phương thức này sẽ không có hiệu lực.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
email | String | Địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
File – File này dùng để xâu chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive
addViewer(user)
Thêm người dùng đã cho vào danh sách người xem của File. Nếu người dùng đã có trong danh sách người chỉnh sửa, thì phương thức này sẽ không có hiệu lực.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
user | User | Thông tin về người dùng cần thêm. |
Cầu thủ trả bóng
File – File này dùng để xâu chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive
addViewers(emailAddresses)
Thêm mảng người dùng đã cho vào danh sách người xem cho File. Nếu bất kỳ người dùng nào đã có trong danh sách người chỉnh sửa, thì phương thức này sẽ không có hiệu lực đối với họ.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
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
File – File 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
getAccess(email)
Lấy quyền được cấp cho một người dùng cụ thể. Phương thức này không hỗ trợ việc trả về các quyền cho một Nhóm trên Google hoặc các quyền được kế thừa thông qua Nhóm trên Google.
Tham 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
getAccess(user)
Lấy quyền được cấp cho một người dùng cụ thể. Phương thức này không hỗ trợ việc trả về các quyền cho một Nhóm trên Google hoặc các quyền được kế thừa thông qua Nhóm trên Google.
Tham 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
getAs(contentType)
Trả về dữ liệu bên trong đối tượng này dưới dạng một blob được chuyển đổi sang loại nội dung đã chỉ định. Phương thức này sẽ thêm đuôi thích hợp vào tên tệp, chẳng hạn như "myfile.pdf". Tuy nhiên, phương thức này giả định rằng phần tên tệp theo sau dấu chấm cuối cùng (nếu có) là một tiện ích hiện có cần được thay thế. Do đó, "ShoppingList.12.25.2014" sẽ trở thành "ShoppingList.12.25.pdf".
Để xem hạn mức hằng ngày cho lượt chuyển đổi, hãy xem Hạn mức cho các dịch vụ của Google. Các miền Google Workspace mới tạo có thể tạm thời phải tuân thủ hạn mức nghiêm ngặt hơn.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
content | String | Loại MIME cần chuyển đổi. Đối với hầu hết các blob, 'application/pdf' là lựa chọn hợp lệ duy nhất. Đối với hình ảnh ở định dạng BMP, GIF, JPEG hoặc PNG, mọi định dạng 'image/bmp', 'image/gif', 'image/jpeg' hoặc 'image/png' cũng đều hợp lệ. Đối với tài liệu Google Tài liệu, 'text/markdown' cũng hợp lệ. |
Cầu thủ trả bóng
Blob – Dữ liệu dưới dạng một blob.
getBlob()
Trả về dữ liệu bên trong đối tượng này dưới dạng một blob.
Cầu thủ trả bóng
Blob – Dữ liệu dưới dạng một blob.
getDateCreated()
getDescription()
getDownloadUrl()
Lấy URL có thể dùng để tải tệp xuống. Chỉ những người dùng có quyền mở tệp trong Google Drive mới có thể truy cập vào URL. Bạn có thể dùng URL này trong trình duyệt để tải tệp xuống, nhưng không thể dùng để tìm nạp tệp bằng UrlFetchApp. Nếu bạn muốn nội dung của tệp trong tập lệnh, hãy sử dụng getBlob().
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the download URLs to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getDownloadUrl()); }
Cầu thủ trả bóng
String – URL có thể dùng để tải tệp xuố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
getEditors()
Lấy danh sách người chỉnh sửa cho File 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 File, thì phương thức này sẽ trả về một mảng trống.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Adds the email addresses in the array as editors of each file. // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' // and 'baklavainthebalkans@gmail.com' with valid email addresses. file.addEditors([ 'cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com', ]); // Gets a list of the file editors. const editors = file.getEditors(); // For each file, logs the editors' email addresses to the console. for (const editor of editors) { console.log(editor.getEmail()); } }
Cầu thủ trả bóng
User[] – Nếu người dùng có quyền chỉnh sửa đối với File này, hãy trả về danh sách người chỉnh sửa. Nếu người dùng không có quyền chỉnh sửa, hàm này sẽ trả về một mảng trố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
getId()
getLastUpdated()
getMimeType()
Lấy loại MIME của tệp.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the MIME type to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getMimeType()); }
Cầu thủ trả bóng
String – Loại MIME của tệp.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
getName()
getOwner()
Lấy chủ sở hữu tệp.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the names of the file owners to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getOwner().getName()); }
Cầu thủ trả bóng
User – Chủ sở hữu tệp.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
getParents()
Lấy một tập hợp các thư mục là thư mục mẹ ngay phía trên của File.
Cầu thủ trả bóng
FolderIterator – một tập hợp các thư mục mẹ trực tiếp của File
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
getResourceKey()
Lấy khoá tài nguyên của File 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 File.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
getSecurityUpdateEligible()
Cho biết liệu File này có đủ điều kiện áp dụng bản cập nhật bảo mật yêu cầu khoá tài nguyên để truy cập khi được chia sẻ bằng đường liên kết hay không.
Drive yêu cầu khoá tài nguyên để truy cập vào một số tệp hoặc thư mục được chia sẻ bằng đường liên kết. Thay đổi này là một phần của bản cập nhật bảo mật. Theo mặc định, chế độ cập nhật sẽ được bật cho các tệp và thư mục đủ điều kiện. Để bật hoặc tắt yêu cầu về khoá tài nguyên đối với các tệp đủ điều kiện, hãy sử dụng setSecurityUpdateEnabled.
Tìm hiểu thêm về Bản cập nhật bảo mật cho Google Drive.
Cầu thủ trả bóng
Boolean – Liệu yêu cầu về khoá tài nguyên có thể được áp dụng cho File hay không.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
getSecurityUpdateEnabled()
Cho biết liệu File 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 File này hay không.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
getSharingAccess()
Lấy lớp người dùng có thể truy cập vào File, 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 File
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
getSharingPermission()
Lấy quyền được cấp cho những người dùng có thể truy cập vào File, 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 File
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
getSize()
Lấy số byte được dùng để lưu trữ File 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ữ File 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
getTargetId()
Nếu đây là một Lối tắt, hãy trả về mã nhận dạng của mục mà lối tắt đó trỏ đến.
Nếu không, hàm này sẽ trả về null.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the target ID of the shortcut. console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);
Cầu thủ trả bóng
String|null – Mã mặt hàng mục tiêu hoặc null nếu tệp không phải là lối tắt.
getTargetMimeType()
Nếu đây là một Lối tắt, thì phương thức này sẽ trả về loại MIME của mục mà lối tắt đó trỏ đến.
Nếu không, hàm này sẽ trả về null.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the MIME type of the file that the shortcut points to. console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);
Cầu thủ trả bóng
String|null – Loại MIME của mục tiêu hoặc null nếu tệp không phải là lối tắt.
getTargetResourceKey()
Nếu tệp là một lối tắt, hàm này sẽ trả về khoá tài nguyên của mục mà lối tắt đó trỏ đến. Khoá tài nguyên là một tham số bổ sung mà bạn cần truyền để truy cập vào các tệp đã được chia sẻ bằng một đường liên kết.
Nếu tệp không phải là lối tắt, hàm này sẽ trả về null.
// Gets a file by its ID. // TODO(developer): Replace 'abc123456' with your file ID. const file = DriveApp.getFileById('abc123456'); // If the file is a shortcut, returns the resource key of the file that it // points to. console.log(file.getTargetResourceKey());
Cầu thủ trả bóng
String|null – Khoá tài nguyên của mục tiêu hoặc null nếu tệp không phải là lối tắt.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
getThumbnail()
Lấy hình thu nhỏ của tệp hoặc null nếu không có hình thu nhỏ.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Logs the thumbnail image for each file to the console as a blob, // or null if no thumbnail exists. console.log(file.getThumbnail()); }
Cầu thủ trả bóng
Blob|null – Hình thu nhỏ của tệp.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
getUrl()
Lấy URL có thể dùng để mở File 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 File này trong một ứng dụng của Google như Drive hoặc Tài liệu
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
getViewers()
Lấy danh sách người xem và người nhận xét cho File 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 File, thì phương thức này sẽ trả về một mảng trống.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // For each file, logs the viewers' email addresses to the console. const viewers = file.getViewers(); for (const viewer of viewers) { console.log(viewer.getEmail()); } }
Cầu thủ trả bóng
User[] – Nếu người dùng có quyền chỉnh sửa đối với File này, thì sẽ trả về danh sách người xem và người nhận xét. Nếu người dùng không có quyền chỉnh sửa, hàm này sẽ trả về một mảng trống.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
isStarred()
Xác định xem File 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 File được gắn dấu sao trong Drive của người dùng; false nếu không
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive.readonly -
https://www.googleapis.com/auth/drive
isTrashed()
Xác định xem File 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 File 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
makeCopy()
Tạo bản sao của tệp.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and logs the file name to the console. console.log(file.makeCopy().getName()); }
Cầu thủ trả bóng
File – Bản sao 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
makeCopy(destination)
Tạo một bản sao của tệp trong thư mục đích.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and adds it to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy(destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
destination | Folder | Thư mục để sao chép tệp vào. |
Cầu thủ trả bóng
File – Bản sao 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
makeCopy(name)
Tạo bản sao của tệp và đặt tên cho tệp đó bằng tên bạn cung cấp.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and sets the name to 'Test-Copy.' const filename = file.makeCopy('Test-Copy'); // Logs the copied file's name to the console. console.log(filename.getName()); }
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
name | String | Tên tệp sẽ được áp dụng cho bản sao mới. |
Cầu thủ trả bóng
File – Bản sao 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
makeCopy(name, destination)
Tạo bản sao của tệp trong thư mục đích và đặt tên cho tệp đó bằng tên đã cung cấp.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file, sets the file name, and adds the copied file // to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy('Test-Copy', destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
name | String | Tên tệp sẽ được áp dụng cho bản sao mới. |
destination | Folder | Thư mục để sao chép tệp vào. |
Cầu thủ trả bóng
File – Bản sao 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
moveTo(destination)
Di chuyển mục này đến thư mục đích được cung cấp.
Người dùng hiện tại phải là chủ sở hữu của tệp hoặc có ít nhất quyền chỉnh sửa đối với thư mục mẹ hiện tại của mục để di chuyển mục đó đến thư mục đích.
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
File – File 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
removeCommenter(emailAddress)
Xoá người dùng đã cho khỏi danh sách người bình luận của File. Phương thức này không chặn người dùng truy cập vào File nếu họ thuộc một nhóm người dùng có quyền truy cập chung – ví dụ: nếu File được chia sẻ với toàn bộ miền của người dùng.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. // TODO(developer): Replace the email with the email of the user you want to // remove. file.removeCommenter('cloudysanfrancisco@gmail.com'); }
Tham 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
File – File 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
removeCommenter(user)
Xoá người dùng đã cho khỏi danh sách người bình luận của File. Phương thức này không chặn người dùng truy cập vào File nếu họ thuộc một nhóm người dùng có quyền truy cập chung – ví dụ: nếu File được chia sẻ với toàn bộ miền của người dùng.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. console.log(file.removeCommenter(Session.getActiveUser())); }
Tham 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
File – File 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
removeEditor(emailAddress)
Xoá người dùng đã cho khỏi danh sách người chỉnh sửa của File. Phương thức này không chặn người dùng truy cập vào File nếu họ thuộc một nhóm người dùng có quyền truy cập chung – ví dụ: nếu File được chia sẻ với toàn bộ miền của người dùng hoặc nếu File 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.
Tham 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
File – File 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
removeEditor(user)
Xoá người dùng đã cho khỏi danh sách người chỉnh sửa của File. Phương thức này không chặn người dùng truy cập vào File nếu họ thuộc một nhóm người dùng có quyền truy cập chung – ví dụ: nếu File được chia sẻ với toàn bộ miền của người dùng hoặc nếu File 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.
Tham 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
File – File này dùng để xâu chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive
removeViewer(emailAddress)
Xoá người dùng đã cho khỏi danh sách người xem và người bình luận của File. 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 ngăn người dùng truy cập vào File nếu họ thuộc một nhóm người dùng có quyền truy cập chung – ví dụ: nếu File được chia sẻ với toàn bộ miền của người dùng hoặc nếu File 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.
Tham 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
File – File này dùng để xâu chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive
removeViewer(user)
Xoá người dùng đã cho khỏi danh sách người xem và người bình luận của File. 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 File nếu họ thuộc một nhóm người dùng có quyền truy cập chung – ví dụ: nếu File được chia sẻ với toàn bộ miền của người dùng hoặc nếu File 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.
Tham 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
File – File này dùng để xâu chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive
revokePermissions(emailAddress)
Thu hồi quyền truy cập vào File đã 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 File nếu họ thuộc một nhóm người dùng có quyền truy cập chung – ví dụ: nếu File được chia sẻ với toàn bộ miền của người dùng.
Tham 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
File – File này dùng để xâu chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive
revokePermissions(user)
Thu hồi quyền truy cập vào File đã 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 File nếu họ thuộc một nhóm người dùng có quyền truy cập chung – ví dụ: nếu File được chia sẻ với toàn bộ miền của người dùng.
Tham 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
File – File 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
setContent(content)
Ghi đè nội dung của tệp bằng một nội dung thay thế nhất định. Tạo ra một trường hợp ngoại lệ nếu content lớn hơn 10 MB.
// Creates a text file with the content 'Hello, world!' const file = DriveApp.createFile('New Text File', 'Hello, world!'); // Logs the content of the text file to the console. console.log(file.getBlob().getDataAsString()); // Updates the content of the text file to 'Updated text!' file.setContent('Updated text!'); // Logs content of the text file to the console. console.log(file.getBlob().getDataAsString());
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
content | String | Nội dung mới cho tệp. |
Cầu thủ trả bóng
File – File 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
setDescription(description)
setName(name)
setOwner(emailAddress)
Thay đổi chủ sở hữu của File. 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 File.
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.
Tham 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
File – File 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
setOwner(user)
Thay đổi chủ sở hữu của File. 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 File.
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.
Tham 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
File – File 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
setSecurityUpdateEnabled(enabled)
Đặt xem File có yêu cầu khoá tài nguyên để truy cập khi được chia sẻ bằng đường liên kết hay không. Theo mặc định, các tệp và thư mục đủ điều kiện sẽ được bật.
Tìm hiểu thêm về Bản cập nhật bảo mật cho Google Drive.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
enabled | Boolean | Có bật yêu cầu về khoá tài nguyên cho File hay không. |
Cầu thủ trả bóng
File – File 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
setSharing(accessType, permissionType)
Đặt nhóm người dùng có thể truy cập vào File 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);
Tham 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 File |
permission | Permission | các quyền cần cấp cho người dùng có thể truy cập vào File |
Cầu thủ trả bó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
setStarred(starred)
Đặt xem File có được gắn dấu sao trong Drive của người dùng hay không. Giá trị mặc định cho File mới là false.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
starred | Boolean | true nếu File 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
Ủy quyền
Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:
-
https://www.googleapis.com/auth/drive
setTrashed(trashed)
Đặt xem File 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 File vào thùng rác. Giá trị mặc định cho File mới là false.
Tham số
| Tên | Loại | Mô tả |
|---|---|---|
trashed | Boolean | true nếu File 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
Ủ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