Một tệp trong Google Drive. Bạn có thể truy cập hoặc tạo tệp bằng DriveApp
.
// Trash every untitled spreadsheet that hasn't been updated in a week. var files = DriveApp.getFilesByName('Untitled spreadsheet'); while (files.hasNext()) { var 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 |
---|---|---|
addCommenter(emailAddress) | File | Thêm người dùng cụ thể vào danh sách người nhận xét cho File . |
addCommenter(user) | File | Thêm người dùng cụ thể vào danh sách người nhận xét cho File . |
addCommenters(emailAddresses) | File | Thêm mảng người dùng đã cho vào danh sách người nhận xét cho File . |
addEditor(emailAddress) | File | Thêm người dùng đã cho vào danh sách người chỉnh sửa của File . |
addEditor(user) | File | Thêm người dùng đã cho vào danh sách người chỉnh sửa của File . |
addEditors(emailAddresses) | File | Thêm mảng người dùng đã cho vào danh sách trình chỉnh sửa của File . |
addViewer(emailAddress) | File | Thêm người dùng cụ thể vào danh sách người xem của File . |
addViewer(user) | File | Thêm người dùng cụ thể 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 của File . |
getAccess(email) | Permission | Nhận quyền được cấp cho người dùng cụ thể. |
getAccess(user) | Permission | Nhận quyền được cấp cho người dùng cụ thể. |
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 được chỉ định. |
getBlob() | Blob | Trả về dữ liệu bên trong đối tượng này dưới dạng một 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 người 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 cập nhật File gần đây 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ành phần 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 một đường liên kết. |
getSecurityUpdateEligible() | Boolean | Kiểm tra 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 một đường liên kết hay không. |
getSecurityUpdateEnabled() | Boolean | Biết được File này có yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng một đường liên kết. |
getSharingAccess() | Access | Lấy thông tin về lớp người dùng có thể truy cập vào File , ngoài từng người dùng riêng lẻ đã được cấp quyền truy cập một cách rõ ràng. |
getSharingPermission() | Permission | Nhận quyền được cấp cho những người dùng có thể truy cập vào File ,
ngoài người dùng cá nhân đã được cấp quyền truy cập một cách rõ ràng. |
getSize() | Integer | Lấy số byte dùng để lưu trữ File trong Drive. |
getTargetId() | String | Nếu đây là một Phím tắt, hãy trả về mã nhận dạng của mục mà phím tắt đó trỏ đến. |
getTargetMimeType() | String | Nếu đây là phím tắt, hãy trả về loại MIME của mục mà mã trỏ đến. |
getTargetResourceKey() | String | Nếu tệp là một lối tắt, hàm sẽ trả về khoá tài nguyên của mục mà tệp trỏ tới. |
getThumbnail() | Blob | Lấy hình thu nhỏ cho tệp hoặc null nếu không có hình thu nhỏ nào. |
getUrl() | String | Lấy URL có thể dùng để mở File trong một ứng dụng Google như Drive hoặc Tài liệu. |
getViewers() | User[] | Xem danh sách người xem và người nhận xét cho 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 hoặc 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ó trong thùng rác trong 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 bản sao của tệp trong thư mục đích. |
makeCopy(name) | File | Tạo một bản sao của tệp rồi đặt tên cho tệp đó bằng tên đã cho. |
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 tệp đó bằng tên đã cho. |
moveTo(destination) | File | Di chuyển mục này sang thư mục đích đã cung cấp. |
removeCommenter(emailAddress) | File | Xoá người dùng đã chọn khỏi danh sách người nhận xét của File . |
removeCommenter(user) | File | Xoá người dùng đã chọn khỏi danh sách người nhận xét của File . |
removeEditor(emailAddress) | File | Xoá người dùng cụ thể khỏi danh sách người chỉnh sửa của File . |
removeEditor(user) | File | Xoá người dùng cụ thể khỏi danh sách người chỉnh sửa của File . |
removeViewer(emailAddress) | File | Xoá người dùng cụ thể khỏi danh sách người xem và người nhận xét của File . |
removeViewer(user) | File | Xoá người dùng cụ thể khỏi danh sách người xem và người nhận xét của File . |
revokePermissions(emailAddress) | File | Thu hồi quyền truy cập File đã cấp cho người dùng đã cấp. |
revokePermissions(user) | File | Thu hồi quyền truy cập File đã cấp cho người dùng đã cấp. |
setContent(content) | File | Ghi đè nội dung của tệp bằng một thay thế cho trước. |
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 | Thiết lập xem File có yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng một đường liên kết. |
setShareableByEditors(shareable) | File | Thiết lập 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. |
setSharing(accessType, permissionType) | File | Đặt lớp người dùng có thể truy cập vào File và những quyền mà người dùng đó được cấp, ngoài bất kỳ người dùng cá nhân nào đã được cấp quyền truy cập rõ ràng. |
setStarred(starred) | File | Thiết lập xem File có được gắn dấu sao trong Drive của người dùng hay không. |
setTrashed(trashed) | File | Thiết lập liệu File có trong thùng rác trong 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 cụ thể vào danh sách người nhận xét cho File
. Nếu người dùng đã có trong danh sách người xem, thì phương thức này sẽ hiển thị 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 'cloudysanfrancisco@gmail.com' with the email address that you // want to add as a commenter. while (files.hasNext()) { const file = files.next(); email = 'cloudysanfrancisco@gmail.com'; console.log(file.addCommenter(email)); }
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
addCommenter(user)
Thêm người dùng cụ thể vào danh sách người nhận xét cho File
. Nếu người dùng đã có trong danh sách người xem, thì phương thức này sẽ hiển thị 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()); }
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | Đại diện cho người dùng mà bạn cần thêm. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
addCommenters(emailAddresses)
Thêm mảng người dùng đã cho vào danh sách người nhận xét 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ẽ thăng hạng họ 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'); 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)); }
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddresses | String[] | Một mảng địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
addEditor(emailAddress)
Thêm người dùng đã cho vào danh sách người chỉnh sửa của File
. Nếu người dùng đã có trong danh sách người xem, phương thức này sẽ đẩy người dùng ra khỏi danh sách người xem.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
addEditor(user)
Thêm người dùng đã cho vào danh sách người chỉnh sửa của File
. Nếu người dùng đã có trong danh sách người xem, phương thức này sẽ đẩy người dùng ra khỏi danh sách người xem.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | Đại diện cho người dùng mà bạn cần thêm. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
addEditors(emailAddresses)
Thêm mảng người dùng đã cho vào danh sách trình chỉnh sửa của 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ẽ thăng hạng họ ra khỏi danh sách người xem.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddresses | String[] | Một mảng địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
addViewer(emailAddress)
Thêm người dùng cụ thể vào danh sách người xem của 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
addViewer(user)
Thêm người dùng cụ thể vào danh sách người xem của 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | Đại diện cho người dùng mà bạn cần thêm. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
addViewers(emailAddresses)
Thêm mảng người dùng đã cho vào danh sách người xem của 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ọ.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddresses | String[] | Một mảng địa chỉ email của người dùng cần thêm. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
getAccess(email)
Nhận quyền được cấp cho người dùng cụ thể.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
email | String | địa chỉ email của người dùng có quyền cần được kiểm tra |
Cầu thủ trả bóng
Permission
– quyền đã cấp cho người dùng
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getAccess(user)
Nhận quyền được cấp cho người dùng cụ thể.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | hình ảnh đại diện cho người dùng có quyền cần được đánh dấu |
Cầu thủ trả bóng
Permission
– quyền đã cấp cho người dùng
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
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 được chỉ định. Phương thức này sẽ thêm phần mở rộng thích hợp vào tên tệp – ví dụ: "myfile.pdf". Tuy nhiên, giả định rằng phần tên tệp đứng sau dấu chấm gần nhất (nếu có) là một đuôi tệp hiện có cần được thay thế. Do đó, "ShoppingList.12.25.2014" 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 các Dịch vụ của Google. Các miền Google Workspace mới tạo có thể tạm thời tuân theo định mức nghiêm ngặt hơn.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
contentType | String | Loại MIME cần chuyển đổi. Đố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 có định dạng BMP, GIF, JPEG hoặc PNG, mọi giá trị 'image/bmp' , 'image/gif' , 'image/jpeg' hay 'image/png' 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 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
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 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(); // 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àm sẽ 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 sẽ trả về một mảng trống.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getParents()
Lấy một tập hợp các thư mục là thành phần mẹ trực tiếp của File
.
Cầu thủ trả bóng
FolderIterator
– một tập hợp các thư mục là thành phần mẹ trực tiếp của File
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getResourceKey()
Lấy khoá tài nguyên của File
cần thiết để truy cập vào các mục đã được chia sẻ bằng một đường liên kết.
Cầu thủ trả bóng
String
– Khoá tài nguyên của File
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEligible()
Kiểm tra xem 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 một đường liên kết hay không.
Drive yêu cầu có khoá tài nguyên để truy cập một số tệp hoặc thư mục đã được chia sẻ bằng đường liên kết. Thay đổi này là một phần của một bản cập nhật bảo mật. Bản cập nhật được bật theo mặc định đối với các tệp và thư mục đủ điều kiện. Để bật hoặc tắt yêu cầu về khoá tài nguyên cho các tệp đủ điều kiện, hãy sử dụng setSecurityUpdateEnabled
.
Tìm hiểu thêm về Bản cập nhật bảo mật cho Google Drive.
Cầu thủ trả bóng
Boolean
– Liệu có thể áp dụng yêu cầu về khoá tài nguyên cho File
hay không.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEnabled()
Biết được File
này có yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng một đường liên kết. Yêu cầu này được bật theo mặc định đối với các tệp và thư mục đủ điều kiện.
Để bật hoặc tắt yêu cầu về khoá tài nguyên cho các tệp đủ điều kiện, hãy sử dụng
setSecurityUpdateEnabled
.
Tìm hiểu thêm về Bản cập nhật bảo mật cho Google Drive.
Cầu thủ trả bóng
Boolean
– Liệu yêu cầu về khoá tài nguyên có được bật cho File
này hay không.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingAccess()
Lấy thông tin về lớp người dùng có thể truy cập vào File
, ngoài từng người dùng riêng lẻ đã được cấp quyền truy cập một cách rõ ràng.
Cầu thủ trả bóng
Access
– lớp người dùng nào có thể truy cập vào File
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingPermission()
Nhận quyền được cấp cho những người dùng có thể truy cập vào File
,
ngoài người dùng cá nhân đã được cấp quyền truy cập một cách rõ ràng.
Cầu thủ trả bóng
Permission
— quyền được cấp cho người dùng có thể truy cập vào File
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSize()
Lấy số byte dùng để lưu trữ File
trong Drive. Xin lưu ý rằng các tệp ứng dụng trên Google Workspace không được tính vào hạn mức bộ nhớ Drive nên sẽ trả về 0
byte.
Cầu thủ trả bóng
Integer
– số byte dùng để lưu trữ File
trong Drive
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getTargetId()
Nếu đây là một Phím tắt, hãy trả về mã nhận dạng của mục mà phím 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ục tiêu.
getTargetMimeType()
Nếu đây là phím tắt, hãy trả về loại MIME của mục mà mã 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 mục tiêu.
getTargetResourceKey()
Nếu tệp là một lối tắt, hàm sẽ trả về khoá tài nguyên của mục mà tệp trỏ tới. 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 đường liên kết.
Nếu tệp không phải là lối tắt, tệp 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 đích hoặc null
nếu tệp không phải là lối tắt.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getThumbnail()
Lấy hình thu nhỏ cho tệp hoặc null
nếu không có hình thu nhỏ nào.
// 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getUrl()
Lấy URL có thể dùng để mở File
trong một ứng dụng Google như Drive hoặc Tài liệu.
Cầu thủ trả bóng
String
– URL có thể dùng để xem File
này trong một ứng dụng Google như Drive hoặc Tài liệu
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getViewers()
Xem danh sách người xem và người nhận xét cho 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 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 (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 File
này, hàm 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 sẽ trả về một mảng trống.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isStarred()
Xác định xem 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isTrashed()
Xác định xem File
có trong thùng rác trong Drive của người dùng hay không.
Cầu thủ trả bóng
Boolean
– true
nếu File
nằm trong thùng rác trên Drive của người dùng;
false
nếu không
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
makeCopy(destination)
Tạo 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()); }
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
destination | Folder | Thư mục cần sao chép tệp vào. |
Cầu thủ trả bóng
File
– Bản sao mới.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
makeCopy(name)
Tạo một bản sao của tệp rồi đặt tên cho tệp đó bằng tên đã cho.
// 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()); }
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | Tên tệp cần áp dụng cho bản sao mới. |
Cầu thủ trả bóng
File
– Bản sao mới.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
makeCopy(name, destination)
Tạo một bản sao của tệp trong thư mục đích và đặt tên cho tệp đó bằng tên đã cho.
// 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()); }
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
name | String | Tên tệp cần áp dụng cho bản sao mới. |
destination | Folder | Thư mục cần sao chép tệp vào. |
Cầu thủ trả bóng
File
– Bản sao mới.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
moveTo(destination)
Di chuyển mục này sang thư mục đích đã cung cấp.
Người dùng hiện tại phải là chủ sở hữu tệp hoặc có ít nhất quyền chỉnh sửa đối với thư mục mẹ hiện tại của mục thì mới có thể di chuyển mục này vào thư mục đích.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
destination | Folder | Thư mục trở thành thư mục mẹ mới. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
removeCommenter(emailAddress)
Xoá người dùng đã chọn khỏi danh sách người nhận xét 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 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'); }
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng cần xoá. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
removeCommenter(user)
Xoá người dùng đã chọn khỏi danh sách người nhận xét 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 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())); }
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | Biểu thị người dùng cần xoá. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
removeEditor(emailAddress)
Xoá người dùng cụ thể khỏi danh sách người chỉnh sửa của 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 bộ nhớ dùng chung mà người dùng có thể truy cập.
Đối với các tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người xem.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng cần xoá. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
removeEditor(user)
Xoá người dùng cụ thể khỏi danh sách người chỉnh sửa của 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 bộ nhớ dùng chung mà người dùng có thể truy cập.
Đối với các tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người xem.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | Biểu thị người dùng cần xoá. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
removeViewer(emailAddress)
Xoá người dùng cụ thể khỏi danh sách người xem và người nhận xét của File
. Phương thức này không có tác dụng nếu người dùng là người chỉnh sửa chứ không phải là người xem hoặc người nhận xét. Phương thức này cũng không chặn người dùng truy cập vào 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 bộ nhớ dùng chung mà người dùng có thể truy cập.
Đối với các tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người chỉnh sửa.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng cần xoá. |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
removeViewer(user)
Xoá người dùng cụ thể khỏi danh sách người xem và người nhận xét của 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 bộ nhớ dùng chung mà người dùng có thể truy cập.
Đối với các tệp trên Drive, thao tác này cũng sẽ xoá người dùng khỏi danh sách người chỉnh sửa.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | Biểu thị người dùng cần xoá. |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
revokePermissions(emailAddress)
Thu hồi quyền truy cập File
đã cấp cho người dùng đã cấp. Phương thức này không chặn người dùng truy cập vào 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng có quyền truy cập bị thu hồi. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
revokePermissions(user)
Thu hồi quyền truy cập File
đã cấp cho người dùng đã cấp. Phương thức này không chặn người dùng truy cập vào 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.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | Biểu thị người dùng cần thu hồi quyền truy cập. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
setContent(content)
Ghi đè nội dung của tệp bằng một thay thế cho trước. 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!' 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());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
content | String | Nội dung mới của tệp. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
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 vào File
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
emailAddress | String | địa chỉ email của người dùng sẽ trở thành chủ sở hữu mới |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
setOwner(user)
Thay đổi chủ sở hữu của 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 vào File
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
user | User | đại diện cho người dùng sẽ trở thành chủ sở hữu mới |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
setSecurityUpdateEnabled(enabled)
Thiết lập xem File
có yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng một đường liên kết. Các tệp và thư mục đủ điều kiện được bật theo mặc định.
Tìm hiểu thêm về Bản cập nhật bảo mật cho Google Drive.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
enabled | Boolean | Liệu có bật yêu cầu về khoá tài nguyên cho File hay không. |
Cầu thủ trả bóng
File
– File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
setSharing(accessType, permissionType)
Đặt lớp người dùng có thể truy cập vào File
và những quyền mà người dùng đó được cấp, ngoài bất kỳ người dùng cá nhân nào đã được cấp quyền truy cập rõ ràng.
// Creates a folder that anyone on the Internet can read from and write to. (Domain // administrators can prohibit this setting for users of a Google Workspace domain.) var folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
accessType | Access | lớp người dùng nào có thể truy cập File |
permissionType | Permission | các quyền cần được cấp cho người dùng có thể truy cập File |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
setStarred(starred)
Thiết lập xem File
có được gắn dấu sao trong Drive của người dùng hay không. Tuỳ chọn mặc định cho các File
mới là false
.
Các tham số
Tên | Loại | Nội dung 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 phải |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
setTrashed(trashed)
Thiết lập liệu File
có trong thùng rác trong Drive của người dùng hay không. Chỉ chủ sở hữu mới có thể chuyển File
vào thùng rác. Chế độ mặc định cho các File
mới là false
.
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
trashed | Boolean | true nếu chuyển File 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
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive