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 | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
addCommenter(emailAddress) | File | Thêm người dùng đã cho vào danh sách người bình luận cho File . |
addCommenter(user) | File | Thêm người dùng đã cho vào danh sách người bình luận cho File . |
addCommenters(emailAddresses) | File | Thêm mảng người dùng đã cho vào danh sách người bình luận cho File . |
addEditor(emailAddress) | File | Thêm người dùng đã cho vào danh sách người chỉnh sửa cho File . |
addEditor(user) | File | Thêm người dùng đã cho vào danh sách người chỉnh sửa cho File . |
addEditors(emailAddresses) | File | Thêm mảng người dùng đã cho vào danh sách người chỉnh sửa cho File . |
addViewer(emailAddress) | File | Thêm người dùng đã cho vào danh sách người xem của File . |
addViewer(user) | File | Thêm người dùng đã cho vào danh sách người xem của File . |
addViewers(emailAddresses) | File | Thêm mảng người dùng đã cho vào danh sách người xem cho File . |
getAccess(email) | Permission | Lấy quyền được cấp cho một người dùng cụ thể. |
getAccess(user) | Permission | Lấy quyền được cấp cho một người dùng cụ thể. |
getAs(contentType) | 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 thành loại nội dung đã chỉ định. |
getBlob() | Blob | Trả về dữ liệu bên trong đối tượng này dưới dạng blob. |
getDateCreated() | Date | Lấy ngày tạo File . |
getDescription() | String | Lấy nội dung mô tả cho File . |
getDownloadUrl() | String | Lấy URL có thể dùng để tải tệp xuống. |
getEditors() | User[] | Lấy danh sách trình chỉnh sửa cho File này. |
getId() | String | Lấy mã nhận dạng của File . |
getLastUpdated() | Date | Lấy ngày gần đây nhất File được cập nhật. |
getMimeType() | String | Lấy loại MIME của tệp. |
getName() | String | Lấy tên của File . |
getOwner() | User | Lấy chủ sở hữu tệp. |
getParents() | FolderIterator | Lấy một tập hợp các thư mục là thư mục mẹ trực tiếp của File . |
getResourceKey() | 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. |
getSecurityUpdateEligible() | Boolean | Xác định xem 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. |
getSecurityUpdateEnabled() | Boolean | Xác định xem 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. |
getSharingAccess() | Access | Xác định lớp người dùng nào có thể truy cập vào File , ngoài những người dùng cá nhân đã được cấp quyền truy cập 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 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. |
getSize() | Integer | Lấy số byte dùng để lưu trữ File trong Drive. |
getTargetId() | String | 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. |
getTargetMimeType() | 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. |
getTargetResourceKey() | String | Nếu tệp là lối tắt, hãy trả về khoá tài nguyên của mục mà tệp đó trỏ đến. |
getThumbnail() | Blob | Lấy hình thu nhỏ của tệp hoặc null nếu không có hình thu nhỏ. |
getUrl() | 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. |
getViewers() | User[] | Lấy danh sách người xem và người nhận xét cho File này. |
isShareableByEditors() | 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 hay thay đổi quyền hay không. |
isStarred() | Boolean | Xác định xem File đã được gắn dấu sao trong Drive của người dùng hay chưa. |
isTrashed() | 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. |
makeCopy() | File | Tạo bản sao của tệp. |
makeCopy(destination) | File | Tạo một bản sao của tệp trong thư mục đích. |
makeCopy(name) | File | Tạo bản sao của tệp và đặt tên cho bản sao đó bằng tên đã cung cấp. |
makeCopy(name, destination) | File | Tạo một bản sao của tệp trong thư mục đích và đặt tên cho bản sao đó bằng tên được cung cấp. |
moveTo(destination) | File | Di chuyển mục này đến thư mục đích đã cung cấp. |
removeCommenter(emailAddress) | File | Xoá người dùng đã cho khỏi danh sách người bình luận cho File . |
removeCommenter(user) | File | Xoá người dùng đã cho khỏi danh sách người bình luận cho File . |
removeEditor(emailAddress) | File | Xoá người dùng đã cho khỏi danh sách trình chỉnh sửa cho File . |
removeEditor(user) | File | Xoá người dùng đã cho khỏi danh sách trình chỉnh sửa cho File . |
removeViewer(emailAddress) | File | Xoá người dùng đã cho khỏi danh sách người xem và người bình luận cho File . |
removeViewer(user) | File | Xoá người dùng đã cho khỏi danh sách người xem và người bình luận cho File . |
revokePermissions(emailAddress) | File | Thu hồi quyền truy cập vào File đã cấp cho người dùng cụ thể. |
revokePermissions(user) | File | Thu hồi quyền truy cập vào File đã cấp cho người dùng cụ thể. |
setContent(content) | File | Ghi đè nội dung của tệp bằng một nội dung thay thế nhất định. |
setDescription(description) | File | Đặt nội dung mô tả cho File . |
setName(name) | File | Đặt tên cho File . |
setOwner(emailAddress) | File | Thay đổi chủ sở hữu của File . |
setOwner(user) | File | Thay đổi chủ sở hữu của File . |
setSecurityUpdateEnabled(enabled) | 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. |
setShareableByEditors(shareable) | 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 hay thay đổi quyền hay không. |
setSharing(accessType, permissionType) | File | Đặt loại người dùng nào có thể truy cập vào File và những quyền nào được cấp cho những người dùng đó, ngoài những người dùng riêng lẻ đã được cấp quyền truy cập rõ ràng. |
setStarred(starred) | File | Đặt xem File có được gắn dấu sao trong Drive của người dùng hay không. |
setTrashed(trashed) | 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, phương thức này sẽ loại người dùng đó 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ả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
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 đó 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 | Nội dung đại diện cho người dùng cần thêm. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
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, phương thức này sẽ loại 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ả |
---|---|---|
emailAddresses | String[] | Một mảng gồm các địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
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, phương thức này sẽ loại người dùng đó khỏi danh sách người xem.
Tham số
Tên | Loại | Mô tả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 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 đó khỏi danh sách người xem.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | Nội dung đại diện cho người dùng cần thêm. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 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ọ khỏi danh sách người xem.
Tham số
Tên | Loại | Mô tả |
---|---|---|
emailAddresses | String[] | Một mảng gồm các địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã 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ả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã 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 | Nội dung đại diện cho người dùng cần thêm. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 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ả |
---|---|---|
emailAddresses | String[] | Một mảng gồm các địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
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 Google Group hoặc các quyền được kế thừa thông qua Google Groups.
Tham số
Tên | Loại | Mô tả |
---|---|---|
email | String | Địa chỉ email của người dùng mà bạn cần kiểm tra quyền. Không hỗ trợ Google Groups. |
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 yêu cầu đượ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)
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 Google Group hoặc các quyền được kế thừa thông qua Google Groups.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | Biểu thị 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 yêu cầu đượ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
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 thành loại nội dung đã chỉ định. Phương thức này thêm đuôi tệp thích hợp vào tên tệp, ví dụ: "myfile.pdf". Tuy nhiên, hàm 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 đuôi tệp 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 bài viết Hạn mức cho 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 theo hạn mức nghiêm ngặt hơn.
Tham số
Tên | Loại | Mô tả |
---|---|---|
contentType | String | Loại MIME cần chuyển đổi sang. Đối với hầu hết các blob, 'application/pdf' là tuỳ chọn hợp lệ duy nhất. Đối với hình ảnh ở định dạng BMP, GIF, JPEG hoặc PNG, bất kỳ 'image/bmp' , 'image/gif' , 'image/jpeg' hoặc 'image/png' nào 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 blob.
getBlob()
Trả về dữ liệu bên trong đối tượng này dưới dạng blob.
Cầu thủ trả bóng
Blob
– Dữ liệu dưới dạng 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ể sử dụng URL này trong trình duyệt để tải tệp xuống, nhưng không thể sử 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 yêu cầu đượ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
getEditors()
Lấy danh sách trình 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 File
này, hãy trả về danh sách trình chỉnh sửa. Nếu người dùng không có quyền chỉnh sửa, hãy 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 yêu cầu đượ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()
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 yêu cầu đượ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
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 yêu cầu đượ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ư mục mẹ trực tiếp của File
.
Cầu thủ trả bóng
FolderIterator
– một tập hợp các thư mục là thư mục mẹ trực tiếp của File
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 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 yêu cầu đượ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()
Xác định xem 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, tính năng cập nhật sẽ 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 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 File
hay không.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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()
Xác định xem 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. Yêu cầu này được bật theo mặc định cho các tệp và thư mục đủ điều kiện.
Để bật hoặc tắt yêu cầu 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 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 yêu cầu đượ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()
Xác định lớp người dùng nào có thể truy cập vào File
, ngoài những người dùng cá nhân đã được cấp quyền truy cập rõ ràng.
Cầu thủ trả bóng
Access
– loại 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 yêu cầu đượ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 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 yêu cầu đượ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ữ 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, 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 yêu cầu đượ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
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
– Mã mặt hàng mục tiêu.
getTargetMimeType()
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.
getTargetResourceKey()
Nếu tệp là lối tắt, hãy trả về khoá tài nguyên của mục mà tệp đó 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, thì 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 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 yêu cầu đượ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
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
– 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 yêu cầu đượ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ở 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 yêu cầu đượ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()
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, hãy trả về danh sách người xem và người bình luận. Nếu người dùng không có quyền chỉnh sửa, hãy 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 yêu cầu đượ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 File
đã đượ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 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 yêu cầu đượ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 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 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 yêu cầu đượ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
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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
makeCopy(name)
Tạo bản sao của tệp và đặt tên cho bản sao đó 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 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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
makeCopy(name, destination)
Tạo một bản sao của tệp trong thư mục đích và đặt tên cho bản sao đó bằng tên được 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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
moveTo(destination)
Di chuyển mục này đến thư mục đích đã cung cấp.
Người dùng hiện tại phải là chủ sở hữu của tệp hoặc ít nhất phải có 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 đó sang thư mục đích.
Tham số
Tên | Loại | Mô tả |
---|---|---|
destination | Folder | Thư mục trở thành thư mục mẹ mới. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
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 cho 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 lớp 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ả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng cần xoá. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
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 cho 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 lớp 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 đại diện cho người dùng cần xoá. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã cho khỏi danh sách trình chỉnh sửa cho 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 lớp 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 ổ đĩa 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ả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng cần xoá. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã cho khỏi danh sách trình chỉnh sửa cho 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 lớp 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 ổ đĩa 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 đại diện cho người dùng cần xoá. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã cho khỏi danh sách người xem và người bình luận cho 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 lớp 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 các tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người chỉnh sửa.
Tham số
Tên | Loại | Mô tả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng cần xoá. |
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 đã cho khỏi danh sách người xem và người bình luận cho 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 lớp 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 ổ đĩa dùng chung mà người dùng có thể truy cập.
Đối với các tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người chỉnh sửa.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | Thông tin đại diện cho 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 yêu cầu đượ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 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 lớp 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ả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng mà bạn muốn thu hồi quyền truy cập. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 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 lớp 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 đại diện cho người dùng cần thu hồi quyền truy cập. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
setContent(content)
Ghi đè nội dung của tệp bằng nội dung thay thế nhất định. Gửi một 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, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
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
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
emailAddress | String | địa chỉ email của người dùng sẽ trở thành chủ sở hữu mới |
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 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
.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | thông tin đại diện của người dùng sẽ trở thành chủ sở hữu mới |
Cầu thủ trả bóng
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
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 khoá tài nguyên cho File hay không. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Các tập lệnh sử dụng phương thức này yêu cầu đượ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 loại người dùng nào có thể truy cập vào File
và những quyền nào được cấp cho những người dùng đó, ngoài những người dùng riêng lẻ đã đượ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.) const folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Tham số
Tên | Loại | Mô tả |
---|---|---|
accessType | Access | lớp người dùng nào có thể truy cập vào File |
permissionType | Permission | quyền cần cấp cho những 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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
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 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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
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 của 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 yêu cầu được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive