Class File

ไฟล์

ไฟล์ใน Google ไดรฟ์ คุณสามารถเข้าถึงหรือสร้างไฟล์ได้จาก 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);
  }
}

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addCommenter(emailAddress)Fileเพิ่มผู้ใช้ที่กำหนดไปยังรายชื่อผู้แสดงความคิดเห็นสำหรับ File
addCommenter(user)Fileเพิ่มผู้ใช้ที่กำหนดไปยังรายชื่อผู้แสดงความคิดเห็นสำหรับ File
addCommenters(emailAddresses)Fileเพิ่มอาร์เรย์ของผู้ใช้ลงในรายการผู้แสดงความคิดเห็นสำหรับ File
addEditor(emailAddress)Fileเพิ่มผู้ใช้ที่กำหนดไปยังรายชื่อเอดิเตอร์ของ File
addEditor(user)Fileเพิ่มผู้ใช้ที่กำหนดไปยังรายชื่อเอดิเตอร์ของ File
addEditors(emailAddresses)Fileเพิ่มอาร์เรย์ของผู้ใช้ที่ระบุลงในรายการเครื่องมือแก้ไขสำหรับ File
addViewer(emailAddress)Fileเพิ่มผู้ใช้ที่กำหนดลงในรายการผู้ดูสำหรับ File
addViewer(user)Fileเพิ่มผู้ใช้ที่กำหนดลงในรายการผู้ดูสำหรับ File
addViewers(emailAddresses)Fileเพิ่มอาร์เรย์ของผู้ใช้ที่ระบุลงในรายการผู้มีสิทธิ์อ่านสำหรับ File
getAccess(email)Permissionได้รับสิทธิ์ที่ให้แก่ผู้ใช้ที่กำหนด
getAccess(user)Permissionได้รับสิทธิ์ที่ให้แก่ผู้ใช้ที่กำหนด
getAs(contentType)Blobแสดงข้อมูลภายในออบเจ็กต์นี้เป็น BLOB ที่แปลงเป็นประเภทเนื้อหาที่ระบุ
getBlob()Blobแสดงข้อมูลภายในออบเจ็กต์นี้เป็น BLOB
getDateCreated()Dateรับวันที่สร้าง File
getDescription()Stringรับคำอธิบายสำหรับ File
getDownloadUrl()Stringรับ URL ที่ใช้เพื่อดาวน์โหลดไฟล์ได้
getEditors()User[]รับรายชื่อเอดิเตอร์ของ File นี้
getId()Stringรับรหัสของ File
getLastUpdated()Dateรับข้อมูลวันที่อัปเดต File ครั้งล่าสุด
getMimeType()Stringรับประเภท MIME ของไฟล์
getName()Stringรับชื่อของ File
getOwner()Userรับเจ้าของไฟล์
getParents()FolderIteratorรับคอลเล็กชันของโฟลเดอร์ที่เป็นระดับบนสุดของ File โดยตรง
getResourceKey()Stringรับคีย์ทรัพยากรของ File ซึ่งจำเป็นในการเข้าถึงรายการที่ ได้รับการแชร์โดยใช้ลิงก์
getSecurityUpdateEligible()Booleanรับข้อมูลว่า File นี้มีสิทธิ์ใช้การอัปเดตความปลอดภัยที่ โดยต้องใช้คีย์แหล่งข้อมูลเพื่อเข้าถึงเมื่อมีการแชร์โดยใช้ลิงก์
getSecurityUpdateEnabled()Booleanรับข้อมูลว่า File นี้ต้องใช้คีย์ทรัพยากรสำหรับการเข้าถึงหรือไม่ แชร์โดยใช้ลิงก์
getSharingAccess()Accessรับข้อมูลว่าผู้ใช้กลุ่มใดเข้าถึง File ได้ ยกเว้นบุคคลใดก็ได้ ผู้ใช้ที่ได้รับสิทธิ์เข้าถึงอย่างชัดเจน
getSharingPermission()Permissionได้รับสิทธิ์ที่ให้แก่ผู้ใช้ที่เข้าถึง File ได้ นอกเหนือจากผู้ใช้รายบุคคลที่ได้รับสิทธิ์เข้าถึงอย่างชัดเจน
getSize()Integerรับจำนวนไบต์ที่ใช้เก็บ File ในไดรฟ์
getTargetId()Stringหากเป็นทางลัด ระบบจะแสดงรหัสของรายการที่ชี้ไป
getTargetMimeType()Stringหากเป็นแป้นพิมพ์ลัด จะแสดงผลประเภท MIME ของรายการปลายทาง
getTargetResourceKey()Stringหากไฟล์เป็นทางลัด ระบบจะแสดงคีย์แหล่งข้อมูลของรายการที่ไฟล์ชี้ไป
getThumbnail()Blobรับภาพขนาดย่อสำหรับไฟล์ หรือ null หากไม่มีภาพขนาดย่อ
getUrl()Stringรับ URL ที่ใช้เปิด File ในแอป Google ได้ เช่น ไดรฟ์หรือเอกสาร
getViewers()User[]ดูรายชื่อผู้มีสิทธิ์อ่านและผู้แสดงความคิดเห็นสำหรับ File นี้
isShareableByEditors()Booleanกำหนดว่าผู้ใช้ที่มีสิทธิ์แก้ไข File ได้รับอนุญาตให้ แชร์กับผู้ใช้คนอื่นหรือเปลี่ยนสิทธิ์
isStarred()Booleanระบุว่า File ติดดาวในไดรฟ์ของผู้ใช้หรือไม่
isTrashed()Booleanกำหนดว่า File อยู่ในถังขยะของไดรฟ์ของผู้ใช้หรือไม่
makeCopy()Fileสร้างสำเนาของไฟล์
makeCopy(destination)Fileสร้างสำเนาของไฟล์ในไดเรกทอรีปลายทาง
makeCopy(name)Fileสร้างสำเนาของไฟล์และตั้งชื่อตามชื่อที่ระบุ
makeCopy(name, destination)Fileสร้างสำเนาของไฟล์ในไดเรกทอรีปลายทางและตั้งชื่อไฟล์ด้วยชื่อที่ระบุ
moveTo(destination)Fileย้ายรายการนี้ไปยังโฟลเดอร์ปลายทางที่ระบุ
removeCommenter(emailAddress)Fileนำผู้ใช้ที่ระบุออกจากรายการผู้แสดงความคิดเห็นสำหรับ File
removeCommenter(user)Fileนำผู้ใช้ที่ระบุออกจากรายการผู้แสดงความคิดเห็นสำหรับ File
removeEditor(emailAddress)Fileนำผู้ใช้ที่ระบุออกจากรายชื่อเอดิเตอร์ของ File
removeEditor(user)Fileนำผู้ใช้ที่ระบุออกจากรายชื่อเอดิเตอร์ของ File
removeViewer(emailAddress)Fileนำผู้ใช้ที่ระบุออกจากรายการผู้มีสิทธิ์อ่านและผู้แสดงความคิดเห็นสำหรับ File
removeViewer(user)Fileนำผู้ใช้ที่ระบุออกจากรายการผู้มีสิทธิ์อ่านและผู้แสดงความคิดเห็นสำหรับ File
revokePermissions(emailAddress)Fileเพิกถอนสิทธิ์เข้าถึง File ที่มอบให้ผู้ใช้ที่กำหนด
revokePermissions(user)Fileเพิกถอนสิทธิ์เข้าถึง File ที่มอบให้ผู้ใช้ที่กำหนด
setContent(content)Fileเขียนทับเนื้อหาของไฟล์ด้วยการแทนที่ที่กำหนด
setDescription(description)Fileตั้งค่าคำอธิบายสำหรับ File
setName(name)Fileตั้งชื่อของ File
setOwner(emailAddress)Fileเปลี่ยนเจ้าของ File
setOwner(user)Fileเปลี่ยนเจ้าของ File
setSecurityUpdateEnabled(enabled)Fileตั้งค่าว่า File ต้องใช้คีย์ทรัพยากรสำหรับการเข้าถึงหรือไม่ แชร์โดยใช้ลิงก์
setShareableByEditors(shareable)Fileตั้งค่าว่าจะอนุญาตให้ผู้ใช้ที่มีสิทธิ์แก้ไข File แชร์หรือไม่ กับผู้ใช้คนอื่นๆ หรือเปลี่ยนสิทธิ์
setSharing(accessType, permissionType)Fileกำหนดประเภทผู้ใช้ที่เข้าถึง File ได้และสิทธิ์ ยกเว้นผู้ใช้รายบุคคลที่ได้รับสิทธิ์เข้าถึงอย่างชัดเจน
setStarred(starred)Fileตั้งค่าว่าจะติดดาว File ในไดรฟ์ของผู้ใช้ไหม
setTrashed(trashed)Fileตั้งค่าว่า File อยู่ในถังขยะของไดรฟ์ของผู้ใช้หรือไม่

เอกสารโดยละเอียด

addCommenter(emailAddress)

เพิ่มผู้ใช้ที่กำหนดไปยังรายชื่อผู้แสดงความคิดเห็นสำหรับ File หากผู้ใช้คือ อยู่ในรายการผู้ดูแล้ว วิธีนี้จะโปรโมตผู้ใช้ที่ไม่ได้อยู่ในรายการผู้ดู

// 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));
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่ต้องการเพิ่ม

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

addCommenter(user)

เพิ่มผู้ใช้ที่กำหนดไปยังรายชื่อผู้แสดงความคิดเห็นสำหรับ File หากผู้ใช้คือ อยู่ในรายการผู้ดูแล้ว วิธีนี้จะโปรโมตผู้ใช้ที่ไม่ได้อยู่ในรายการผู้ดู

// 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());
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
userUserการนำเสนอของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

addCommenters(emailAddresses)

เพิ่มอาร์เรย์ของผู้ใช้ลงในรายการผู้แสดงความคิดเห็นสำหรับ File หากมี ของผู้ใช้ 1 รายอยู่ในรายการผู้ดูอยู่แล้ว วิธีนี้จะช่วยโปรโมตพวกเขาออกจากรายการ ผู้ดู

// 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));
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressesString[]อาร์เรย์อีเมลของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

addEditor(emailAddress)

เพิ่มผู้ใช้ที่กำหนดไปยังรายชื่อเอดิเตอร์ของ File หากผู้ใช้เคยเป็นสมาชิกแล้ว ในรายชื่อผู้ดู ซึ่งจะโปรโมตผู้ใช้ออกจากรายชื่อผู้ดู

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่ต้องการเพิ่ม

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

addEditor(user)

เพิ่มผู้ใช้ที่กำหนดไปยังรายชื่อเอดิเตอร์ของ File หากผู้ใช้เคยเป็นสมาชิกแล้ว ในรายชื่อผู้ดู ซึ่งจะโปรโมตผู้ใช้ออกจากรายชื่อผู้ดู

พารามิเตอร์

ชื่อประเภทคำอธิบาย
userUserการนำเสนอของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

addEditors(emailAddresses)

เพิ่มอาร์เรย์ของผู้ใช้ที่ระบุลงในรายการเครื่องมือแก้ไขสำหรับ File หากมี มีผู้ใช้อยู่ในรายการผู้ดูอยู่แล้ว วิธีนี้จะช่วยโปรโมตพวกเขาออกจากรายการ ผู้ดู

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressesString[]อาร์เรย์อีเมลของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

addViewer(emailAddress)

เพิ่มผู้ใช้ที่กำหนดลงในรายการผู้ดูสำหรับ File หากผู้ใช้เคยเป็นสมาชิกแล้ว ในรายชื่อเอดิเตอร์ วิธีนี้จะไม่มีผล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่ต้องการเพิ่ม

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

addViewer(user)

เพิ่มผู้ใช้ที่กำหนดลงในรายการผู้ดูสำหรับ File หากผู้ใช้เคยเป็นสมาชิกแล้ว ในรายชื่อเอดิเตอร์ วิธีนี้จะไม่มีผล

พารามิเตอร์

ชื่อประเภทคำอธิบาย
userUserการนำเสนอของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

addViewers(emailAddresses)

เพิ่มอาร์เรย์ของผู้ใช้ที่ระบุลงในรายการผู้มีสิทธิ์อ่านสำหรับ File หากมี ผู้ใช้อยู่ในรายชื่อผู้แก้ไขอยู่แล้ว วิธีนี้ไม่มีผลต่อผู้ใช้

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressesString[]อาร์เรย์อีเมลของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getAccess(email)

ได้รับสิทธิ์ที่ให้แก่ผู้ใช้ที่กำหนด

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailStringอีเมลของผู้ใช้ที่ควรตรวจสอบสิทธิ์

รีเทิร์น

Permission — สิทธิ์ที่ผู้ใช้ได้รับ

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getAccess(user)

ได้รับสิทธิ์ที่ให้แก่ผู้ใช้ที่กำหนด

พารามิเตอร์

ชื่อประเภทคำอธิบาย
userUserตัวแทนของผู้ใช้ที่ควรตรวจสอบสิทธิ์

รีเทิร์น

Permission — สิทธิ์ที่ผู้ใช้ได้รับ

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getAs(contentType)

แสดงข้อมูลภายในออบเจ็กต์นี้เป็น BLOB ที่แปลงเป็นประเภทเนื้อหาที่ระบุ ช่วงเวลานี้ จะเพิ่มนามสกุลที่เหมาะสมลงในชื่อไฟล์ เช่น "myfile.pdf" อย่างไรก็ตาม จะถือว่าส่วนของชื่อไฟล์ที่อยู่หลังเครื่องหมายจุดสุดท้าย (ถ้ามี) เป็นส่วนที่มีอยู่ ที่ควรแทนที่ ดังนั้น "ShoppingList.12.25.2014" กลายเป็น "ShoppingList.12.25.pdf"

หากต้องการดูโควต้ารายวันสำหรับ Conversion โปรดดูโควต้าสำหรับ Google บริการ โดเมน Google Workspace ที่สร้างใหม่อาจมีข้อกำหนดที่เข้มงวดขึ้นชั่วคราว โควต้า

พารามิเตอร์

ชื่อประเภทคำอธิบาย
contentTypeStringประเภท MIME ที่จะแปลง สำหรับ BLOB ส่วนใหญ่ 'application/pdf' คือ เป็นตัวเลือกเดียวที่ใช้ได้ สำหรับรูปภาพในรูปแบบ BMP, GIF, JPEG หรือ PNG ระบบจะใช้ 'image/bmp', 'image/gif', 'image/jpeg' หรือ 'image/png' ด้วย ใช้ได้ ใช้ 'text/markdown' สำหรับเอกสารของ Google เอกสารได้ด้วย

รีเทิร์น

Blob — ข้อมูลในรูปแบบ BLOB


getBlob()

แสดงข้อมูลภายในออบเจ็กต์นี้เป็น BLOB

รีเทิร์น

Blob — ข้อมูลในรูปแบบ BLOB


getDateCreated()

รับวันที่สร้าง File

รีเทิร์น

Date — วันที่สร้าง File

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDescription()

รับคำอธิบายสำหรับ File

รีเทิร์น

String — คำอธิบายของ File

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getDownloadUrl()

รับ URL ที่ใช้เพื่อดาวน์โหลดไฟล์ได้ เฉพาะผู้ใช้ที่มีสิทธิ์เปิดไฟล์เท่านั้น ใน Google ไดรฟ์จะเข้าถึง URL ได้ คุณสามารถใช้ URL นี้ในเบราว์เซอร์เพื่อดาวน์โหลดไฟล์ได้ แต่ คุณใช้เพื่อดึงข้อมูลไฟล์ด้วย UrlFetchApp ไม่ได้ ถ้าคุณต้องการเนื้อหาของ ในสคริปต์ ให้ใช้ 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());
}

รีเทิร์น

String — URL ที่ใช้ดาวน์โหลดไฟล์ได้

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getEditors()

รับรายชื่อเอดิเตอร์ของ File นี้ หากผู้ใช้ที่เรียกใช้สคริปต์ ไม่มีสิทธิ์แก้ไข File วิธีนี้จะแสดงอาร์เรย์ที่ว่างเปล่า

// 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());
  }
}

รีเทิร์น

User[] — หากผู้ใช้มีสิทธิ์แก้ไขสำหรับ File นี้ ระบบจะแสดงรายการ เครื่องมือแก้ไข หากผู้ใช้ไม่มีสิทธิ์แก้ไข ระบบจะแสดงอาร์เรย์ที่ว่างเปล่า

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getId()

รับรหัสของ File

รีเทิร์น

String — รหัสของ File

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getLastUpdated()

รับข้อมูลวันที่อัปเดต File ครั้งล่าสุด

รีเทิร์น

Date — วันที่อัปเดต File ครั้งล่าสุด

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getMimeType()

รับประเภท MIME ของไฟล์

// 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());
}

รีเทิร์น

String — ประเภท MIME ของไฟล์

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getName()

รับชื่อของ File

รีเทิร์น

String — ชื่อของ File

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getOwner()

รับเจ้าของไฟล์

// 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());
}

รีเทิร์น

User — เจ้าของไฟล์

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getParents()

รับคอลเล็กชันของโฟลเดอร์ที่เป็นระดับบนสุดของ File โดยตรง

รีเทิร์น

FolderIterator — คอลเล็กชันของโฟลเดอร์ที่เป็นระดับบนสุดของ File โดยตรง

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getResourceKey()

รับคีย์ทรัพยากรของ File ซึ่งจำเป็นในการเข้าถึงรายการที่ ได้รับการแชร์โดยใช้ลิงก์

รีเทิร์น

String — คีย์แหล่งข้อมูลของ File

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getSecurityUpdateEligible()

รับข้อมูลว่า File นี้มีสิทธิ์ใช้การอัปเดตความปลอดภัยที่ โดยต้องใช้คีย์แหล่งข้อมูลเพื่อเข้าถึงเมื่อมีการแชร์โดยใช้ลิงก์

ไดรฟ์ต้องใช้คีย์แหล่งข้อมูลเพื่อเข้าถึงไฟล์หรือโฟลเดอร์บางรายการที่แชร์โดยใช้ ลิงก์ การเปลี่ยนแปลงนี้เป็นส่วนหนึ่งของการอัปเดตความปลอดภัย การอัปเดตจะเปิดอยู่โดยค่าเริ่มต้นสำหรับสิทธิ์ ไฟล์และโฟลเดอร์ หากต้องการเปิดหรือปิดข้อกำหนดของคีย์แหล่งข้อมูลสำหรับไฟล์ที่มีสิทธิ์ ให้ใช้ setSecurityUpdateEnabled

ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปเดตความปลอดภัยสำหรับ Google ไดรฟ์

รีเทิร์น

Boolean — ระบุว่าใช้ข้อกำหนดคีย์ทรัพยากรสำหรับ File ได้หรือไม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getSecurityUpdateEnabled()

รับข้อมูลว่า File นี้ต้องใช้คีย์ทรัพยากรสำหรับการเข้าถึงหรือไม่ แชร์โดยใช้ลิงก์ ทั้งนี้ ระบบจะเปิดข้อกำหนดนี้โดยค่าเริ่มต้นสำหรับไฟล์และโฟลเดอร์ที่มีสิทธิ์ หากต้องการเปิดหรือปิดข้อกำหนดของคีย์แหล่งข้อมูลสำหรับไฟล์ที่มีสิทธิ์ ให้ใช้ setSecurityUpdateEnabled

ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปเดตความปลอดภัยสำหรับ Google ไดรฟ์

รีเทิร์น

Boolean — เปิดใช้ข้อกำหนดคีย์ทรัพยากรสำหรับ File นี้หรือไม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getSharingAccess()

รับข้อมูลว่าผู้ใช้กลุ่มใดเข้าถึง File ได้ ยกเว้นบุคคลใดก็ได้ ผู้ใช้ที่ได้รับสิทธิ์เข้าถึงอย่างชัดเจน

รีเทิร์น

Access — ผู้ใช้ประเภทใดสามารถเข้าถึง File

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getSharingPermission()

ได้รับสิทธิ์ที่ให้แก่ผู้ใช้ที่เข้าถึง File ได้ นอกเหนือจากผู้ใช้รายบุคคลที่ได้รับสิทธิ์เข้าถึงอย่างชัดเจน

รีเทิร์น

Permission — สิทธิ์ที่มอบให้แก่ผู้ใช้ที่เข้าถึง File ได้

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getSize()

รับจำนวนไบต์ที่ใช้เก็บ File ในไดรฟ์ โปรดทราบว่า ไฟล์แอปพลิเคชัน Google Workspace จะไม่นับรวมในขีดจำกัดพื้นที่เก็บข้อมูล Google ไดรฟ์ และจึงส่งคืน 0 ไบต์

รีเทิร์น

Integer — จำนวนไบต์ที่ใช้เก็บ File ในไดรฟ์

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getTargetId()

หากเป็นทางลัด ระบบจะแสดงรหัสของรายการที่ชี้ไป

มิเช่นนั้น ระบบจะแสดงผล 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()}`);

รีเทิร์น

String — รหัสรายการเป้าหมาย


getTargetMimeType()

หากเป็นแป้นพิมพ์ลัด จะแสดงผลประเภท MIME ของรายการปลายทาง

มิเช่นนั้น ระบบจะแสดงผล 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()}`);

รีเทิร์น

String — ประเภท MIME ของรายการเป้าหมาย


getTargetResourceKey()

หากไฟล์เป็นทางลัด ระบบจะแสดงคีย์แหล่งข้อมูลของรายการที่ไฟล์ชี้ไป คีย์แหล่งข้อมูลคือ พารามิเตอร์เพิ่มเติมที่คุณต้องส่งเพื่อเข้าถึงไฟล์ที่แชร์โดยใช้ ลิงก์

หากไฟล์ไม่ใช่ทางลัด จะแสดง 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());

รีเทิร์น

String — คีย์แหล่งข้อมูลของรายการเป้าหมายหรือ null หากไฟล์ไม่ใช่ทางลัด

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getThumbnail()

รับภาพขนาดย่อสำหรับไฟล์ หรือ null หากไม่มีภาพขนาดย่อ

// 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());
}

รีเทิร์น

Blob — ภาพขนาดย่อของไฟล์

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getUrl()

รับ URL ที่ใช้เปิด File ในแอป Google ได้ เช่น ไดรฟ์หรือเอกสาร

รีเทิร์น

String — URL ที่สามารถใช้ดู File นี้ในแอป Google เช่น ไดรฟ์หรือเอกสาร

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

getViewers()

ดูรายชื่อผู้มีสิทธิ์อ่านและผู้แสดงความคิดเห็นสำหรับ File นี้ หากผู้ใช้ที่ เรียกใช้สคริปต์ไม่มีสิทธิ์แก้ไข File วิธีนี้ จะแสดงอาร์เรย์ที่ว่างเปล่า

// 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());
  }
}

รีเทิร์น

User[] — หากผู้ใช้มีสิทธิ์แก้ไขสำหรับ File นี้ ระบบจะแสดงรายการ ผู้มีสิทธิ์อ่านและผู้แสดงความคิดเห็น หากผู้ใช้ไม่มีสิทธิ์แก้ไข ระบบจะแสดงอาร์เรย์ที่ว่างเปล่า

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

isShareableByEditors()

กำหนดว่าผู้ใช้ที่มีสิทธิ์แก้ไข File ได้รับอนุญาตให้ แชร์กับผู้ใช้คนอื่นหรือเปลี่ยนสิทธิ์

รีเทิร์น

Booleantrue หากผู้ใช้ที่มีสิทธิ์แก้ไขสามารถแชร์กับผู้ใช้รายอื่น หรือ เปลี่ยนสิทธิ์ false หากไม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

isStarred()

ระบุว่า File ติดดาวในไดรฟ์ของผู้ใช้หรือไม่

รีเทิร์น

Booleantrue ถ้าติดดาว File ไว้ในไดรฟ์ของผู้ใช้ false หากไม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

isTrashed()

กำหนดว่า File อยู่ในถังขยะของไดรฟ์ของผู้ใช้หรือไม่

รีเทิร์น

Booleantrue หาก File อยู่ในถังขยะของไดรฟ์ของผู้ใช้ false หากไม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

makeCopy()

สร้างสำเนาของไฟล์

// 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());
}

รีเทิร์น

File — สำเนาใหม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

makeCopy(destination)

สร้างสำเนาของไฟล์ในไดเรกทอรีปลายทาง

// 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());
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
destinationFolderไดเรกทอรีที่จะคัดลอกไฟล์ไป

รีเทิร์น

File — สำเนาใหม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

makeCopy(name)

สร้างสำเนาของไฟล์และตั้งชื่อตามชื่อที่ระบุ

// 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());
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
nameStringชื่อไฟล์ที่ควรใช้กับสำเนาใหม่

รีเทิร์น

File — สำเนาใหม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

makeCopy(name, destination)

สร้างสำเนาของไฟล์ในไดเรกทอรีปลายทางและตั้งชื่อไฟล์ด้วยชื่อที่ระบุ

// 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());
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
nameStringชื่อไฟล์ที่ควรใช้กับสำเนาใหม่
destinationFolderไดเรกทอรีที่จะคัดลอกไฟล์ไป

รีเทิร์น

File — สำเนาใหม่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

moveTo(destination)

ย้ายรายการนี้ไปยังโฟลเดอร์ปลายทางที่ระบุ

ผู้ใช้ปัจจุบันต้องเป็นเจ้าของไฟล์หรือมีสิทธิ์แก้ไขเป็นอย่างน้อยสำหรับ โฟลเดอร์หลักปัจจุบันเพื่อย้ายรายการไปยังโฟลเดอร์ปลายทาง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
destinationFolderโฟลเดอร์ที่จะกลายเป็นโฟลเดอร์ระดับบนใหม่

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

removeCommenter(emailAddress)

นำผู้ใช้ที่ระบุออกจากรายการผู้แสดงความคิดเห็นสำหรับ File วิธีนี้ ไม่บล็อกไม่ให้ผู้ใช้เข้าถึง File หากผู้ใช้อยู่ในกลุ่มผู้ใช้ ที่มีสิทธิ์เข้าถึงทั่วไป เช่น หากมีการแชร์ File กับ ทั้งโดเมน

// 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');
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่จะนำออก

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

removeCommenter(user)

นำผู้ใช้ที่ระบุออกจากรายการผู้แสดงความคิดเห็นสำหรับ File วิธีนี้ ไม่บล็อกไม่ให้ผู้ใช้เข้าถึง File หากผู้ใช้อยู่ในกลุ่มผู้ใช้ ที่มีสิทธิ์เข้าถึงทั่วไป เช่น หากมีการแชร์ File กับ ทั้งโดเมน

// 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()));
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
userUserการนำเสนอของผู้ใช้ที่จะนำออก

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

removeEditor(emailAddress)

นำผู้ใช้ที่ระบุออกจากรายชื่อเอดิเตอร์ของ File วิธีนี้ไม่ บล็อกไม่ให้ผู้ใช้เข้าถึง File หากผู้ใช้อยู่ในกลุ่มผู้ใช้ที่มี สิทธิ์การเข้าถึงทั่วไป เช่น หากแชร์ File กับทั้งหมดของผู้ใช้ หรือหาก File อยู่ในไดรฟ์ที่แชร์ที่ผู้ใช้เข้าถึงได้

สำหรับไฟล์ในไดรฟ์ การดำเนินการนี้จะนำผู้ใช้ออกจากรายการผู้ดูด้วย

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่จะนำออก

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

removeEditor(user)

นำผู้ใช้ที่ระบุออกจากรายชื่อเอดิเตอร์ของ File วิธีนี้ไม่ บล็อกไม่ให้ผู้ใช้เข้าถึง File หากผู้ใช้อยู่ในกลุ่มผู้ใช้ที่มี สิทธิ์การเข้าถึงทั่วไป เช่น หากแชร์ File กับทั้งหมดของผู้ใช้ หรือหาก File อยู่ในไดรฟ์ที่แชร์ที่ผู้ใช้เข้าถึงได้

สำหรับไฟล์ในไดรฟ์ การดำเนินการนี้จะนำผู้ใช้ออกจากรายการผู้ดูด้วย

พารามิเตอร์

ชื่อประเภทคำอธิบาย
userUserการนำเสนอของผู้ใช้ที่จะนำออก

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

removeViewer(emailAddress)

นำผู้ใช้ที่ระบุออกจากรายการผู้มีสิทธิ์อ่านและผู้แสดงความคิดเห็นสำหรับ File ช่วงเวลานี้ จะไม่มีผลใดๆ หากผู้ใช้เป็นเอดิเตอร์ ไม่ใช่ผู้มีสิทธิ์อ่านหรือผู้แสดงความคิดเห็น วิธีการนี้ยัง ไม่บล็อกผู้ใช้ไม่ให้เข้าถึง File หากผู้ใช้อยู่ในกลุ่มผู้ใช้ที่ มีสิทธิ์เข้าถึงทั่วไป เช่น หากมีการแชร์ File กับ ทั้งโดเมน หรือหาก File อยู่ในไดรฟ์ที่แชร์ที่ผู้ใช้เข้าถึงได้

สำหรับไฟล์ในไดรฟ์ การดำเนินการนี้จะนำผู้ใช้ออกจากรายการเครื่องมือแก้ไขด้วย

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่จะนำออก

รีเทิร์น

FileFile นี้สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

removeViewer(user)

นำผู้ใช้ที่ระบุออกจากรายการผู้มีสิทธิ์อ่านและผู้แสดงความคิดเห็นสำหรับ File ช่วงเวลานี้ จะไม่มีผลใดๆ หากผู้ใช้เป็นผู้แก้ไข ไม่ใช่ผู้ดู วิธีนี้จะไม่บล็อก ไม่ให้ผู้ใช้เข้าถึง File หากผู้ใช้อยู่ในกลุ่มผู้ใช้ที่มี ตัวอย่างเช่น หากมีการแชร์ File กับทั้งโดเมนของผู้ใช้ หรือ หาก File อยู่ในไดรฟ์ที่แชร์ที่ผู้ใช้เข้าถึงได้

สำหรับไฟล์ในไดรฟ์ การดำเนินการนี้จะนำผู้ใช้ออกจากรายการเครื่องมือแก้ไขด้วย

พารามิเตอร์

ชื่อประเภทคำอธิบาย
userUserการนำเสนอของผู้ใช้ที่จะนำออก

รีเทิร์น

FileFile นี้สำหรับการทำสายโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

revokePermissions(emailAddress)

เพิกถอนสิทธิ์เข้าถึง File ที่มอบให้ผู้ใช้ที่กำหนด วิธีนี้ไม่ บล็อกไม่ให้ผู้ใช้เข้าถึง File หากผู้ใช้อยู่ในกลุ่มผู้ใช้ที่ มีสิทธิ์เข้าถึงทั่วไป เช่น หากมีการแชร์ File กับ ทั้งโดเมน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่ควรเพิกถอนสิทธิ์เข้าถึง

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

revokePermissions(user)

เพิกถอนสิทธิ์เข้าถึง File ที่มอบให้ผู้ใช้ที่กำหนด วิธีนี้ไม่ บล็อกไม่ให้ผู้ใช้เข้าถึง File หากผู้ใช้อยู่ในกลุ่มผู้ใช้ที่ มีสิทธิ์เข้าถึงทั่วไป เช่น หากมีการแชร์ File กับ ทั้งโดเมน

พารามิเตอร์

ชื่อประเภทคำอธิบาย
userUserตัวแทนของผู้ใช้ซึ่งควรเพิกถอนสิทธิ์เข้าถึง

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setContent(content)

เขียนทับเนื้อหาของไฟล์ด้วยการแทนที่ที่กำหนด มีข้อยกเว้นหาก content มีขนาดใหญ่กว่า 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
contentStringเนื้อหาใหม่ของไฟล์

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setDescription(description)

ตั้งค่าคำอธิบายสำหรับ File

พารามิเตอร์

ชื่อประเภทคำอธิบาย
descriptionStringคำอธิบายใหม่สำหรับ File

รีเทิร์น

FileFile นี้สำหรับการทำห่วงโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setName(name)

ตั้งชื่อของ File

พารามิเตอร์

ชื่อประเภทคำอธิบาย
nameStringชื่อใหม่ของ File

รีเทิร์น

FileFile นี้สำหรับการทำห่วงโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setOwner(emailAddress)

เปลี่ยนเจ้าของ File วิธีนี้จะทำให้เจ้าของเดิม สิทธิ์แก้ไข File อย่างชัดแจ้ง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่ควรเป็นเจ้าของใหม่

รีเทิร์น

FileFile นี้สำหรับการทำห่วงโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setOwner(user)

เปลี่ยนเจ้าของ File วิธีนี้จะทำให้เจ้าของเดิม สิทธิ์แก้ไข File อย่างชัดแจ้ง

พารามิเตอร์

ชื่อประเภทคำอธิบาย
userUserตัวแทนของผู้ใช้ที่ควรเป็นเจ้าของใหม่

รีเทิร์น

FileFile นี้สำหรับการทำห่วงโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setSecurityUpdateEnabled(enabled)

ตั้งค่าว่า File ต้องใช้คีย์ทรัพยากรสำหรับการเข้าถึงหรือไม่ แชร์โดยใช้ลิงก์ ระบบจะเปิดใช้ไฟล์และโฟลเดอร์ที่มีสิทธิ์โดยค่าเริ่มต้น

ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปเดตความปลอดภัยสำหรับ Google ไดรฟ์

พารามิเตอร์

ชื่อประเภทคำอธิบาย
enabledBooleanเลือกว่าจะเปิดใช้ข้อกำหนดคีย์ทรัพยากรสำหรับ File ไหม

รีเทิร์น

FileFile นี้สำหรับการทำเชน

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setShareableByEditors(shareable)

ตั้งค่าว่าจะอนุญาตให้ผู้ใช้ที่มีสิทธิ์แก้ไข File แชร์หรือไม่ กับผู้ใช้คนอื่นๆ หรือเปลี่ยนสิทธิ์ ค่าเริ่มต้นสำหรับ File ใหม่คือ true

พารามิเตอร์

ชื่อประเภทคำอธิบาย
shareableBooleantrue หากผู้ใช้ที่มีสิทธิ์แก้ไขควรได้รับอนุญาตให้แชร์ด้วย ผู้ใช้รายอื่นหรือเปลี่ยนสิทธิ์ false หากไม่

รีเทิร์น

FileFile นี้สำหรับการทำห่วงโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setSharing(accessType, permissionType)

กำหนดประเภทผู้ใช้ที่เข้าถึง File ได้และสิทธิ์ ยกเว้นผู้ใช้รายบุคคลที่ได้รับสิทธิ์เข้าถึงอย่างชัดเจน

// 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
accessTypeAccessผู้ใช้ประเภทใดที่จะสามารถเข้าถึง File ได้
permissionTypePermissionสิทธิ์ที่ควรมอบให้แก่ผู้ใช้ที่เข้าถึง File ได้

รีเทิร์น

FileFile นี้สำหรับการทำห่วงโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setStarred(starred)

ตั้งค่าว่าจะติดดาว File ในไดรฟ์ของผู้ใช้ไหม ค่าเริ่มต้นสำหรับ File ใหม่คือ false

พารามิเตอร์

ชื่อประเภทคำอธิบาย
starredBooleantrue หากควรติดดาว File ใน ไดรฟ์; false หากไม่

รีเทิร์น

FileFile นี้สำหรับการทำห่วงโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

setTrashed(trashed)

ตั้งค่าว่า File อยู่ในถังขยะของไดรฟ์ของผู้ใช้หรือไม่ เฉพาะ เจ้าของอาจทิ้ง File ลงถังขยะ ค่าเริ่มต้นของ File ใหม่คือ false

พารามิเตอร์

ชื่อประเภทคำอธิบาย
trashedBooleantrue หาก File ควรถูกย้ายไปที่ถังขยะของ ไดรฟ์ของผู้ใช้ false หากไม่

รีเทิร์น

FileFile นี้สำหรับการทำห่วงโซ่

การให้สิทธิ์

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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