Một tệp trong Google Drive. Bạn có thể truy cập hoặc tạo tệp từ Drive.
// 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 lập tức 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 | Nếu đây là một Lối tắt, hàm sẽ trả về mã nhận dạng của mục mà lối tắt đó trỏ đến. |
get | String | Nếu đây là một Lối tắt, hãy trả về loại MIME của mục mà lối tắt đó trỏ đến. |
get | String | 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
add Commenter(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'); }
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
File — File 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 Commenter(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()); }
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
File — File 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 Commenters(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)); }
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
File — File 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(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, 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
File — File 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 File. Nếu người dùng đã có trong danh sách người xem, phương thức này sẽ loại người dùng đó 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
File — File 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 Editors(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 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
File — File 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 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.
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
File — File 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(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.
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
File — File 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 Viewers(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ọ.
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
File — File 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
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 hoặc các quyền được kế thừa thông qua Nhóm trên Google.
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 hoặc các quyền được kế thừa thông qua Nhóm trên Google.
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 As(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.
Thông 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.
get Blob()
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.
get Date Created()
get Description()
get Download Url()
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 Url. Nếu bạn muốn nội dung của tệp trong tập lệnh, hãy sử dụng get.
// 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
get Editors()
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
get Id()
get Last Updated()
get Mime Type()
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
get Name()
get Owner()
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
get Parents()
Lấy một tập hợp các thư mục là thư mục mẹ ngay lập tức của File.
Cầu thủ trả bóng
Folder – một tập hợp các thư mục là thư mục mẹ ngay lập tức 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
get Resource Key()
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
get Security Update Eligible()
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 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 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
get Security Update Enabled()
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
get Sharing 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.
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
get Sharing 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.
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
get Size()
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
get Target Id()
Nếu đây là một Lối tắt, hàm sẽ 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 – Mã mặt hàng mục tiêu.
get Target Mime Type()
Nếu đây là một Lối tắt, hãy 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 – Loại mime của mục tiêu.
get Target Resource Key()
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 – 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
get Thumbnail()
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
get Url()
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
get Viewers()
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, 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
is Starred()
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
is Trashed()
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
make Copy()
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
make Copy(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()); }
Thông 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
make Copy(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()); }
Thông 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
make Copy(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()); }
Thông 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
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
File — File 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 Commenter(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'); }
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
File — File 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 Commenter(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())); }
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
File — File 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 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.
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
File — File 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 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.
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
File — File 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 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 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 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.
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
Ủ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 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.
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
Ủ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 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.
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
File — File 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 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.
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
File — File 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 Content(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());
Thông 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, để 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 Description(description)
set Name(name)
set Owner(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.
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
Ủ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 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.
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
Ủ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 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.
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 File hay không. |
Cầu thủ trả bóng
File — File 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 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);
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 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
set Starred(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.
Thông 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
set Trashed(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.
Thông 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