Class File

Tệp

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.
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 pháp

Phương thứcLoại dữ liệu trả vềMô tả ngắn
addCommenter(emailAddress)FileThêm người dùng đã cho vào danh sách người nhận xét cho File.
addCommenter(user)FileThêm người dùng đã cho vào danh sách người nhận xét cho File.
addCommenters(emailAddresses)FileThêm một loạt người dùng vào danh sách người nhận xét cho File.
addEditor(emailAddress)FileThêm người dùng đã cho vào danh sách trình chỉnh sửa cho File.
addEditor(user)FileThêm người dùng đã cho vào danh sách trình chỉnh sửa cho File.
addEditors(emailAddresses)FileThêm mảng người dùng đã cho vào danh sách trình chỉnh sửa cho File.
addViewer(emailAddress)FileThêm người dùng đã cho vào danh sách người xem cho File.
addViewer(user)FileThêm người dùng đã cho vào danh sách người xem cho File.
addViewers(emailAddresses)FileThêm mảng người dùng nhất định vào danh sách người xem cho File.
getAccess(email)PermissionNhận quyền được cấp cho người dùng đã cho.
getAccess(user)PermissionNhận quyền được cấp cho người dùng đã cho.
getAs(contentType)BlobTrả về dữ liệu bên trong đối tượng này dưới dạng blob được chuyển đổi thành loại nội dung được chỉ định.
getBlob()BlobTrả về dữ liệu bên trong đối tượng này dưới dạng blob.
getDateCreated()DateLấy ngày tạo File.
getDescription()StringLấy thông tin mô tả cho File.
getDownloadUrl()StringLấ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()StringLấy mã nhận dạng của File.
getLastUpdated()DateLấy ngày cập nhật File gần đây nhất.
getMimeType()StringLấy loại MIME của tệp.
getName()StringLấy tên của File.
getOwner()UserLấy chủ sở hữu của File.
getParents()FolderIteratorNhận một tập hợp các thư mục là thực thể mẹ ngay trong File.
getResourceKey()StringLấy khoá tài nguyên của File cần thiết để truy cập các mục được chia sẻ bằng một đường liên kết.
getSecurityUpdateEligible()BooleanNhận được liệu File này có đủ điều kiện áp dụng bản cập nhật bảo mật yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng đường liên kết.
getSecurityUpdateEnabled()BooleanNhận được liệu 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 đường liên kết.
getSharingAccess()AccessLấy lớp người dùng nào có thể truy cập File, ngoài bất kỳ cá nhân người dùng nào đã được cấp quyền truy cập rõ ràng.
getSharingPermission()PermissionNhận quyền được cấp cho những người dùng có thể truy cập File, ngoài tất cả người dùng cá nhân đã được cấp quyền truy cập rõ ràng.
getSize()IntegerLấy số byte dùng để lưu trữ File trong Drive.
getTargetId()StringNếu đây là phím tắt, hãy trả về mã nhận dạng của mục mà nó trỏ đến.
getTargetMimeType()StringNếu đây là phím tắt, hãy trả về loại MIME của mục trỏ đến.
getTargetResourceKey()StringNế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()BlobLấy hình thu nhỏ của tệp hoặc null nếu không có hình thu nhỏ nào.
getUrl()StringLấ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()BooleanXá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()BooleanXác định xem File có được gắn dấu sao trong Drive của người dùng hay không.
isTrashed()BooleanXá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()FileTạo bản sao của tệp.
makeCopy(destination)FileTạo một bản sao của tệp trong thư mục đích.
makeCopy(name)FileTạo một bản sao của tệp và đặt tên cho tệp bằng tên đã cung cấp.
makeCopy(name, destination)FileTạ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 đã cung cấp.
moveTo(destination)FileChuyển mục này vào thư mục đích được cung cấp.
removeCommenter(emailAddress)FileXoá người dùng cụ thể khỏi danh sách người nhận xét cho File.
removeCommenter(user)FileXoá người dùng cụ thể khỏi danh sách người nhận xét cho File.
removeEditor(emailAddress)FileXoá người dùng đã chỉ định khỏi danh sách trình chỉnh sửa của File.
removeEditor(user)FileXoá người dùng đã chỉ định khỏi danh sách trình chỉnh sửa của File.
removeViewer(emailAddress)FileXóa người dùng cụ thể khỏi danh sách người xem và người nhận xét cho File.
removeViewer(user)FileXóa người dùng cụ thể khỏi danh sách người xem và người nhận xét cho File.
revokePermissions(user)FileThu hồi quyền truy cập vào File được cấp cho người dùng đã cho.
revokePermissions(user)FileThu hồi quyền truy cập vào File được cấp cho người dùng đã cho.
setContent(content)FileGhi đè nội dung của tệp bằng một đoạn thay thế.
setDescription(description)FileĐặt phần mô tả cho File.
setName(name)FileĐặt tên cho File.
setOwner(emailAddress)FileThay đổi chủ sở hữu của File.
setOwner(user)FileThay đổ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 hay không khi được chia sẻ bằng đường liên kết.
setShareableByEditors(shareable)FileThiết lập liệu người dùng có quyền chỉnh sửa đối với File được phép chia sẻ với người dùng khác hay thay đổi quyền đó.
setSharing(accessType, permissionType)FileĐặt lớp người dùng nào có thể truy cập vào File và những quyền mà người dùng đó được cấp, ngoài những người dùng cá nhân đã đượ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 liệu 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 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ẽ quảng bá người dùng ra khỏi danh sách người xem.

Các tham số

TênLoạiMô tả
emailAddressStringĐịa chỉ email của người dùng mà bạn muốn thêm.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 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ẽ quảng bá người dùng ra khỏi danh sách người xem.

Các tham số

TênLoạiMô tả
userUserHình ảnh đại diện cho người dùng cần thêm.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

addCommenters(emailAddresses)

Thêm một loạt người dùng 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, thì phương thức này sẽ đưa họ ra khỏi danh sách người xem.

Các tham số

TênLoạiMô tả
emailAddressesString[]Một mảng địa chỉ email của người dùng cần thêm.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 trình chỉnh sửa cho File. Nếu người dùng đã có trong danh sách người xem, thì phương thức này sẽ quảng bá người dùng ra khỏi danh sách người xem.

Các tham số

TênLoạiMô tả
emailAddressStringĐịa chỉ email của người dùng mà bạn muốn thêm.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 trình chỉnh sửa cho File. Nếu người dùng đã có trong danh sách người xem, thì phương thức này sẽ quảng bá người dùng ra khỏi danh sách người xem.

Các tham số

TênLoạiMô tả
userUserHình ảnh đại diện cho người dùng cần thêm.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 cho File. Nếu bất kỳ người dùng nào đã có trong danh sách người xem, thì phương thức này sẽ đưa họ ra khỏi danh sách người xem.

Các tham số

TênLoạiMô tả
emailAddressesString[]Một mảng địa chỉ email của người dùng cần thêm.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 cho 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ênLoạiMô tả
emailAddressStringĐịa chỉ email của người dùng mà bạn muốn thêm.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 cho 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ênLoạiMô tả
userUserHình ảnh đại diện cho người dùng cần thêm.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 nào đã có trong danh sách người chỉnh sửa, thì phương thức này sẽ không có tác dụng đối với họ.

Các tham số

TênLoạiMô tả
emailAddressesString[]Một mảng địa chỉ email của người dùng cần thêm.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 đã cho.

Các tham số

TênLoạiMô tả
emailStringđịa chỉ email của người dùng cần được kiểm tra quyền

Hai chiều

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 pháp này yêu cầu uỷ quyền bằng 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 đã cho.

Các tham số

TênLoạiMô tả
userUserđại diện của người dùng có quyền được kiểm tra

Hai chiều

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 pháp này yêu cầu uỷ quyền bằng 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 blob được chuyển đổi thành loại nội dung được chỉ định. Phương thức này thêm phần mở rộng thích hợp vào tên tệp—ví dụ: "myfile.pdf" Tuy nhiên, hệ thống giả định rằng phần tên tệp tuân theo dấu chấm cuối cùng (nếu có) là một phần mở rộng hiện có cần được thay thế. Do đó, "ShoppingList.12.25.2014" trở thành "ShoppingList.12.25.pdf"

Để xem định mức hằng ngày cho các lượt chuyển đổi, hãy xem bài viết Định 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 có hạn mức nghiêm ngặt hơn.

Các tham số

TênLoạiMô tả
contentTypeStringLoại MIME để chuyển đổi thành. Đố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, bất kỳ 'image/bmp', 'image/gif', 'image/jpeg' hoặc 'image/png' nào cũng đều hợp lệ.

Hai chiều

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.

Hai chiều

Blob – Dữ liệu dưới dạng blob.


getDateCreated()

Lấy ngày tạo File.

Hai chiều

Date – ngày tạo File

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getDescription()

Lấy thông tin mô tả cho File.

Hai chiều

String – thông tin mô tả cho File

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

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 một trình duyệt để tải tệp xuống, nhưng không thể 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().

Hai chiều

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 pháp này yêu cầu uỷ quyền bằng 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.

Hai chiều

User[] – Một mảng người dùng có quyền chỉnh sửa.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getId()

Lấy mã nhận dạng của File.

Hai chiều

String – Mã của File

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getLastUpdated()

Lấy ngày cập nhật File gần đây nhất.

Hai chiều

Date — ngày cập nhật gần đây nhất của File

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getMimeType()

Lấy loại MIME của tệp.

Hai chiều

String – Loại MIME của tệp.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getName()

Lấy tên của File.

Hai chiều

String – tên của File

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getOwner()

Lấy chủ sở hữu của File.

Hai chiều

User — đối tượng User đại diện cho chủ sở hữu

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getParents()

Nhận một tập hợp các thư mục là thực thể mẹ ngay trong File.

Hai chiều

FolderIterator – một tập hợp các thư mục mẹ ngay lập tức truy cập vào File

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 các mục được chia sẻ bằng một đường liên kết.

Hai chiều

String – Khoá tài nguyên của File.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSecurityUpdateEligible()

Nhận được liệu File này có đủ điều kiện áp dụng bản cập nhật bảo mật yêu cầu khoá tài nguyên để truy cập hay không khi được chia sẻ bằng đường liên kết.

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, bản cập nhật sẽ được bật cho các tệp và thư mục đủ điều kiện. Để bật hoặc tắt yêu cầu về khoá tài nguyên cho các tệp đủ điều kiện, hãy dùng setSecurityUpdateEnabled.

Hãy tìm hiểu thêm về Bản cập nhật bảo mật cho Google Drive.

Hai chiều

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 pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getSecurityUpdateEnabled()

Nhận được liệu 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 đườ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 dùng setSecurityUpdateEnabled.

Hãy tìm hiểu thêm về Bản cập nhật bảo mật cho Google Drive.

Hai chiều

Boolean – Liệu có bật yêu cầu khoá tài nguyên cho File này hay không.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 nào có thể truy cập File, ngoài bất kỳ cá nhân người dùng nào đã được cấp quyền truy cập rõ ràng.

Hai chiều

Access – lớp 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 pháp này yêu cầu uỷ quyền bằng 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 File, ngoài tất cả người dùng cá nhân đã được cấp quyền truy cập rõ ràng.

Hai chiều

Permission – các quyền được cấp cho những 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 pháp này yêu cầu uỷ quyền bằng 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 Google Workspace không được tính vào giới hạn bộ nhớ Drive và do đó, trả về 0 byte.

Hai chiều

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 pháp này yêu cầu uỷ quyền bằng 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à phím tắt, hãy trả về mã nhận dạng của mục mà nó trỏ đến.

Nếu không, hàm này sẽ trả về null.

Hai chiều

String – Mã mặt hàng mục tiêu.


getTargetMimeType()

Nếu đây là phím tắt, hãy trả về loại MIME của mục trỏ đến.

Nếu không, hàm này sẽ trả về null.

Hai chiều

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à thông số bổ sung cần được truyền cho các tệp truy cập được chia sẻ bằng đường liên kết.

Nếu không phải là lối tắt, tệp sẽ trả về null.

Hai chiều

String – Khoá tài nguyên của mục tiêu hoặc null nếu tệp không phải là lối tắt.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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ỏ nào.

Hai chiều

Blob — Hình thu nhỏ của tệp.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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.

Hai chiều

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

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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.

Hai chiều

User[] – Một mảng người dùng có quyền xem hoặc nhận xét.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

isShareableByEditors()

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.

Hai chiều

Booleantrue nếu người dùng có quyền chỉnh sửa được phép chia sẻ với người dùng khác hoặc thay đổi quyền; false nếu không được phép chia sẻ

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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ó được gắn dấu sao trong Drive của người dùng hay không.

Hai chiều

Booleantrue nếu File được gắn dấu sao trong Drive của người dùng; false nếu không được gắn dấu sao

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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.

Hai chiều

Booleantrue nếu File nằm trong thùng rác của Drive của người dùng; false nếu không có trong thùng rác

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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.

Hai chiều

File – Bản sao mới.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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.

Các tham số

TênLoạiMô tả
destinationFolderThư mục để sao chép tệp vào đó.

Hai chiều

File – Bản sao mới.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 và đặt tên cho tệp bằng tên đã cung cấp.

Các tham số

TênLoạiMô tả
nameStringTên tệp sẽ áp dụng cho bản sao mới.

Hai chiều

File – Bản sao mới.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 đã cung cấp.

Các tham số

TênLoạiMô tả
nameStringTên tệp sẽ áp dụng cho bản sao mới.
destinationFolderThư mục để sao chép tệp vào đó.

Hai chiều

File – Bản sao mới.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

moveTo(destination)

Chuyển mục này vào thư mục đích được cung cấp.

Người dùng hiện tại phải là chủ sở hữu tệp hoặc ít nhất có quyền chỉnh sửa thư mục mẹ hiện tại của mục đó để di chuyển mục đó vào thư mục đích.

Các tham số

TênLoạiMô tả
destinationFolderThư mục sẽ trở thành thư mục mẹ mới.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 của người dùng.

Các tham số

TênLoạiMô tả
emailAddressStringĐịa chỉ email của người dùng cần xóa.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 của người dùng.

Các tham số

TênLoạiMô tả
userUserHình ảnh minh họa người dùng cần xóa.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

removeEditor(emailAddress)

Xoá người dùng đã chỉ định khỏi danh sách trình 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 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ẽ xóa người dùng khỏi danh sách người xem.

Các tham số

TênLoạiMô tả
emailAddressStringĐịa chỉ email của người dùng cần xóa.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

removeEditor(user)

Xoá người dùng đã chỉ định khỏi danh sách trình 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 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ẽ xóa người dùng khỏi danh sách người xem.

Các tham số

TênLoạiMô tả
userUserHình ảnh minh họa người dùng cần xóa.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

removeViewer(emailAddress)

Xóa người dùng cụ thể khỏi danh sách người xem và người nhận xét 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, 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 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 xóa người dùng khỏi danh sách người chỉnh sửa.

Các tham số

TênLoạiMô tả
emailAddressStringĐịa chỉ email của người dùng cần xóa.

Hai chiều

FileFile này để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

removeViewer(user)

Xóa người dùng cụ thể khỏi danh sách người xem và người nhận xét 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, không phải là 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 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 xóa người dùng khỏi danh sách người chỉnh sửa.

Các tham số

TênLoạiMô tả
userUserHình ảnh minh họa người dùng cần xóa.

Hai chiều

FileFile này để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 đã cho. 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ênLoạiMô tả
userStringđịa chỉ email của người dùng có quyền truy cập bị thu hồi

Hai chiều

FileFile này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 đã cho. 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ênLoạiMô tả
userUserhình ảnh đại diện của người dùng bị thu hồi quyền truy cập

Hai chiều

FileFile này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 đoạn thay thế. Khai báo trường hợp ngoại lệ nếu content lớn hơn 10 MB.

Các tham số

TênLoạiMô tả
contentStringNội dung mới của tệp.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

setDescription(description)

Đặt phần mô tả cho File.

Các tham số

TênLoạiMô tả
descriptionStringnội dung mô tả mới cho File

Hai chiều

FileFile này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

setName(name)

Đặt tên cho File.

Các tham số

TênLoạiMô tả
nameStringtên mới của File

Hai chiều

FileFile này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

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ênLoạiMô tả
emailAddressStringđịa chỉ email của người dùng sẽ trở thành chủ sở hữu mới

Hai chiều

FileFile này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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ênLoạiMô tả
userUsermột đại diện của người dùng sẽ trở thành chủ sở hữu mới

Hai chiều

FileFile này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 hay không khi được chia sẻ bằng đường liên kết. Các tệp và thư mục đủ điều kiện được bật theo mặc định.

Hãy 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ênLoạiMô tả
enabledBooleanCó cần bật yêu cầu khoá tài nguyên cho File hay không.

Hai chiều

FileFile này, để xâu chuỗi.

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

setShareableByEditors(shareable)

Thiết lập liệu người dùng có quyền chỉnh sửa đối với File được phép chia sẻ với người dùng khác hay thay đổi quyền đó. Giá trị mặc định cho File mới là true.

Các tham số

TênLoạiMô tả
shareableBooleantrue nếu người dùng có quyền chỉnh sửa phải được phép chia sẻ với người dùng khác hoặc thay đổi quyền; false nếu không được phép chia sẻ

Hai chiều

FileFile này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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 nào có thể truy cập vào File và những quyền mà người dùng đó được cấp, ngoài những người dùng cá nhân đã đượ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ênLoạiMô tả
accessTypeAccesslớp người dùng nào có thể truy cập File
permissionTypePermissioncác quyền cần được cấp cho những người dùng truy cập vào File

Hai chiều

FileFile này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng 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.

Các tham số

TênLoạiMô tả
starredBooleantrue nếu File nên được gắn dấu sao trong Drive của người dùng; false nếu không được gắn dấu sao

Hai chiều

FileFile này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive

setTrashed(trashed)

Đặt liệu 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.

Các tham số

TênLoạiMô tả
trashedBooleantrue 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

Hai chiều

FileFile này để xâu chuỗi

Ủy quyền

Các tập lệnh sử dụng phương pháp này yêu cầu uỷ quyền bằng một hoặc nhiều phạm vi sau:

  • https://www.googleapis.com/auth/drive