Class File

ไฟล์

ไฟล์ใน Google ไดรฟ์ เข้าถึงหรือสร้างไฟล์ได้จาก DriveApp

// Trash every untitled spreadsheet that hasn't been updated in a week.
const files = DriveApp.getFilesByName('Untitled spreadsheet');
while (files.hasNext()) {
  const file = files.next();
  if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) {
    file.setTrashed(true);
  }
}

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
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 หากผู้ใช้อยู่ในรายการผู้ชมอยู่แล้ว เมธอดนี้จะเลื่อนผู้ใช้ออกจากรายการผู้ชม

const files = DriveApp.getFilesByName('Test');

// Loops through the files
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter('hello@example.com');
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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 หากผู้ใช้รายใดอยู่ในรายชื่อผู้ชมอยู่แล้ว วิธีการนี้จะเลื่อนผู้ใช้รายนั้นออกจากรายชื่อผู้ชม

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

รับสิทธิ์ที่มอบให้แก่ผู้ใช้ที่เฉพาะเจาะจง วิธีการนี้ไม่รองรับการแสดงผลสิทธิ์สำหรับ Google Group หรือสิทธิ์ที่รับค่าผ่าน Google Groups

พารามิเตอร์

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

รีเทิร์น

Permission — สิทธิ์ที่มอบให้แก่ผู้ใช้

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

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

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

getAccess(user)

รับสิทธิ์ที่มอบให้แก่ผู้ใช้ที่เฉพาะเจาะจง วิธีการนี้ไม่รองรับการแสดงผลสิทธิ์สำหรับ Google Group หรือสิทธิ์ที่รับค่าผ่าน Google Groups

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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' ก็ได้ สำหรับเอกสาร Google เอกสาร จะใช้ 'text/markdown' ก็ได้เช่นกัน

รีเทิร์น

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 จะไม่นับรวมในขีดจำกัดพื้นที่เก็บข้อมูลของไดรฟ์ จึงแสดงผลเป็น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 (const 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!'
const file = DriveApp.createFile('New Text File', 'Hello, world!');

// Logs the content of the text file to the console.
console.log(file.getBlob().getDataAsString());

// Updates the content of the text file to 'Updated text!'
file.setContent('Updated text!');

// Logs content of the text file to the console.
console.log(file.getBlob().getDataAsString());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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.)
const 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