Một tệp trong Google Drive. Bạn có thể truy cập hoặc tạo tệp qua 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 | Loại 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 cụ thể vào danh sách người chỉnh sửa cho File . |
addEditor(user) | File | Thêm người dùng cụ thể vào danh sách người chỉnh sửa cho File . |
addEditors(emailAddresses) | File | Thêm mảng người dùng nhất định vào danh sách người chỉnh sửa cho File . |
addViewer(emailAddress) | File | Thêm người dùng cụ thể vào danh sách người xem cho File . |
addViewer(user) | File | Thêm người dùng cụ thể vào danh sách người xem cho File . |
addViewers(emailAddresses) | File | Thêm mảng người dùng nhất định vào danh sách người xem cho 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 sang 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 | Xem 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 | Xem ngày gần đây nhất mà 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 | Xem 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 một liên kết. |
getSecurityUpdateEligible() | Boolean | Xem liệu File này có đủ điều kiện áp dụng bản cập nhật bảo mật hay không
cần có một khoá tài nguyên để truy cập khi khoá này được chia sẻ bằng đường liên kết. |
getSecurityUpdateEnabled() | Boolean | Tìm hiểu xem 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 liên kết. |
getSharingAccess() | Access | Lấy lớp người dùng có thể truy cập vào File , ngoài từng cá nhân
những người dùng được cấp quyền truy cập một cách rõ ràng. |
getSharingPermission() | Permission | Được cấp quyền cho những người dùng 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 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à 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. |
getTargetMimeType() | String | Nếu đây là lối tắt, hàm sẽ 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à nó 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 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 File có được phép
chia sẻ với người dùng khác hoặc thay đổi quyền truy cập. |
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 trên 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 bản sao của tệp và đặt tên cho tệp bằng tên đã cung cấp. |
makeCopy(name, destination) | 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. |
moveTo(destination) | File | Chuyển mục này đến thư mục đích được cung cấp. |
removeCommenter(emailAddress) | File | Xoá người dùng cụ thể khỏi danh sách người nhận xét cho File . |
removeCommenter(user) | File | Xoá người dùng cụ thể khỏi danh sách người nhận xét cho 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 đối với 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 đối với File . |
revokePermissions(emailAddress) | File | Thu hồi quyền truy cập vào File được cấp cho người dùng cụ thể. |
revokePermissions(user) | File | Thu hồi quyền truy cập vào File được cấp cho người dùng cụ thể. |
setContent(content) | File | Ghi đè nội dung của tệp bằng một đường liên kết thay thế cụ thể. |
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 liên kết. |
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ẻ hay không
với người dùng khác hoặc thay đổi quyền truy cập. |
setSharing(accessType, permissionType) | File | Thiết lập lớp người dùng có thể truy cập vào File và những quyền
những người dùng đó, bên cạnh 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 | Đặt File có nằm trong thùng rác trên 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 pháp này sẽ đưa 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)); }
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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 pháp này sẽ đưa người dùng ra khỏi danh sách người xem.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Adds the active user as a commenter. while (files.hasNext()) { const file = files.next(); file.addCommenter(Session.getActiveUser()); }
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | Đạ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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 có
người dùng đã có trong danh sách người xem, phương pháp này sẽ đẩy 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)); }
Tham số
Tên | Loại | Mô tả |
---|---|---|
emailAddresses | String[] | Một mảng đị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, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 cụ thể vào danh sách người chỉnh sửa cho File
. Nếu người dùng đã
trên danh sách người xem, thì phương pháp này sẽ đưa người dùng ra 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 cụ thể vào danh sách người chỉnh sửa cho File
. Nếu người dùng đã
trên danh sách người xem, thì phương pháp này sẽ đưa người dùng ra khỏi danh sách người xem.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | Đạ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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 nhất định vào danh sách người chỉnh sửa cho File
. Nếu bất kỳ
người dùng đã có trong danh sách người xem, thì phương pháp này sẽ đẩy họ ra khỏi danh sách
người xem.
Tham số
Tên | Loại | Mô tả |
---|---|---|
emailAddresses | String[] | Một mảng đị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, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 cho File
. Nếu người dùng đã
trên danh sách người chỉnh sửa, thì phương thức này 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 cho File
. Nếu người dùng đã
trên danh sách người chỉnh sửa, thì phương thức này không có hiệu lực.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | Đạ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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 nhất định vào danh sách người xem cho File
. Nếu bất kỳ
người dùng đã có trong danh sách người chỉnh sửa, nên phương pháp này không có ảnh hưởng gì đối với họ.
Tham số
Tên | Loại | Mô tả |
---|---|---|
emailAddresses | String[] | Một mảng đị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, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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ể.
Tham số
Tên | Loại | 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
— các quyền được cấp cho người dùng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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ể.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | hình ảnh đại diện cho người dùng có quyền cần được kiểm tra |
Cầu thủ trả bóng
Permission
— các quyền được cấp cho người dùng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 sang loại nội dung được chỉ định. Chiến dịch này sẽ thêm đuôi tệp thích hợp vào tên tệp (ví dụ: "myfile.pdf"). Tuy nhiên, việc này giả định rằng phần tên tệp tiếp sau dấu chấm cuối cùng (nếu có) là phần tên tệp hiện có tiện ích mở rộng 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 Google Dịch vụ. Các miền Google Workspace mới tạo có thể tạm thời bị áp dụng quy định nghiêm ngặt hơn hạn mức.
Tham số
Tên | Loại | 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à
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, bất kỳ hình ảnh nào có định dạng 'image/bmp' , 'image/gif' , 'image/jpeg' hoặc 'image/png' cũng
hợp lệ. Đối với tài liệu trên Google Tài liệu, 'text/markdown' cũng hợp lệ. |
Cầu thủ trả bóng
Blob
– Dữ liệu dưới dạng một blob.
getBlob()
Trả về dữ liệu bên trong đối tượng này dưới dạng một blob.
Cầu thủ trả bóng
Blob
– Dữ liệu dưới dạng một blob.
getDateCreated()
getDescription()
getDownloadUrl()
Lấy URL có thể dùng để tải tệp xuống. Chỉ những người dùng có quyền mở tệp
trong Google Drive 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
bạn 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
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 yêu cầu ủy 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 đố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à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 yêu cầu ủy 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 yêu cầu ủy 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()
Xem 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 yêu cầu ủy 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 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 yêu cầu ủy 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()
Xem liệu File
này có đủ điều kiện áp dụng bản cập nhật bảo mật hay không
cần có một khoá tài nguyên để truy cập khi khoá này được chia sẻ bằng đường liên kết.
Drive yêu cầu khóa tài nguyên để truy cập vào một số tệp hoặc thư mục đã được chia sẻ bằng
. Thay đổi này là một phần của một bản cập nhật bảo mật. Theo mặc định, bản cập nhật này được bật cho những người dùng đủ điều kiện
tệp và thư mục. Để 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 yêu cầu ủy 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()
Tìm hiểu xem 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 liên kết. 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 về khoá tài nguyên cho các tệp đủ điều kiện, hãy 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 yêu cầu ủy 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 lớp người dùng có thể truy cập vào File
, ngoài từng cá nhân
những người dùng đã đượ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 yêu cầu ủy 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()
Được cấp quyền cho những người dùng 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 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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. 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ẽ được 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 yêu cầu ủy 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à 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.
getTargetMimeType()
Nếu đây là lối tắt, hàm sẽ trả về loại MIME của mục mà lối tắt trỏ đến.
Nếu không, hàm này sẽ trả về null
.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the MIME type of the file that the shortcut points to. console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);
Cầu thủ trả bóng
String
– Loại mime của mục 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à nó trỏ đến. Khoá tài nguyên là một thông số bổ sung mà bạn cần truyền để truy cập các tệp đã được chia sẻ bằng .
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 yêu cầu ủy 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ỏ cho tệp.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 yêu cầu ủy 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
, 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 yêu cầu ủy 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 yêu cầu ủy 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 trên 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 yêu cầu ủy 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 yêu cầu ủy 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()); }
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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 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 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 bản sao của tệp trong thư mục đích và đặt tên cho tệp bằng tên đã cung cấp.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file, sets the file name, and adds the copied file // to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy('Test-Copy', destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
Tham số
Tên | Loại | Mô tả |
---|---|---|
name | String | Tên tệp sẽ được áp dụng cho bản sao mới. |
destination | Folder | Thư mục để sao chép tệp vào. |
Cầu thủ trả bóng
File
— Bản sao mới.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
moveTo(destination)
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 để di chuyển mục này vào thư mục đích.
Tham số
Tên | Loại | Mô tả |
---|---|---|
destination | Folder | Thư mục sẽ trở thành thư mục mẹ mới. |
Cầu thủ trả bóng
File
— File
này, để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 cụ thể khỏi danh sách người nhận xét 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.
// 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 cụ thể khỏi danh sách người nhận xét 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.
// 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 | Hình ảnh đạ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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
sẽ 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 đã
quyền truy cập chung. Ví dụ: nếu File
được chia sẻ với toàn bộ
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.
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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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
sẽ 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 đã
quyền truy cập chung. Ví dụ: nếu File
được chia sẻ với toàn bộ
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.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | Hình ảnh đạ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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 đối với File
. Chiến dịch này
sẽ không có hiệu lực nếu người dùng là người chỉnh sửa, không phải là người xem hoặc người nhận xét. Phương pháp 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 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.
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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 đối với File
. Chiến dịch này
sẽ 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 File
nếu họ thuộc một nhóm người dùng có quyền truy cập chung
quyền truy cập – 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.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | Hình ảnh đại diện cho 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 yêu cầu ủy 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 cấp cho người dùng cụ thể. Phương thức này không
sẽ 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.
Tham số
Tên | Loại | Mô tả |
---|---|---|
emailAddress | String | Địa chỉ email của người dùng có quyền truy cập cần 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 yêu cầu ủy 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 cấp cho người dùng cụ thể. Phương thức này không
sẽ 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.
Tham số
Tên | Loại | Mô tả |
---|---|---|
user | User | Đại diện cho người dùng có quyền truy cập cần 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 yêu cầu ủy 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 đường liên kết thay thế cụ thể. Gửi 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!' 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 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 yêu cầu ủy 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 cung 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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 cung 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 | hình đạ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
Tập lệnh sử dụng phương thức này yêu cầu ủy 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 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.
Tham số
Tên | Loại | Mô tả |
---|---|---|
enabled | Boolean | Liệu 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
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
setSharing(accessType, permissionType)
Thiết lập lớp người dùng có thể truy cập vào File
và những quyền
những người dùng đó, bên cạnh 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);
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 | các quyền sẽ được cấp cho người dùng có thể truy cập vào File |
Cầu thủ trả bóng
Ủy quyền
Tập lệnh sử dụng phương thức này yêu cầu ủy 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. 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 phần cài đặt của người dùng
Lái xe; 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 yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive
setTrashed(trashed)
Đặt File
có nằm trong thùng rác trên Drive của người dùng hay không. Chỉ
chủ sở hữu 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 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
Tập lệnh sử dụng phương thức này yêu cầu ủy quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/drive