Class Folder

โฟลเดอร์

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

// Log the name of every folder in the user's Drive.
var folders = DriveApp.getFolders();
while (folders.hasNext()) {
  var folder = folders.next();
  Logger.log(folder.getName());
}

วิธีการ

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
addEditor(emailAddress)Folderเพิ่มผู้ใช้ที่ระบุไปยังรายชื่อเอดิเตอร์ของ Folder
addEditor(user)Folderเพิ่มผู้ใช้ที่ระบุไปยังรายชื่อเอดิเตอร์ของ Folder
addEditors(emailAddresses)Folderเพิ่มอาร์เรย์ของผู้ใช้ที่ระบุในรายชื่อเครื่องมือแก้ไขสำหรับ Folder
addViewer(emailAddress)Folderเพิ่มผู้ใช้ที่ระบุลงในรายการผู้ชมสำหรับ Folder
addViewer(user)Folderเพิ่มผู้ใช้ที่ระบุลงในรายการผู้ชมสำหรับ Folder
addViewers(emailAddresses)Folderเพิ่มอาร์เรย์ของผู้ใช้ที่ระบุในรายชื่อผู้ดูสำหรับ Folder
createFile(blob)Fileสร้างไฟล์ในโฟลเดอร์ปัจจุบันจากข้อมูลที่กําหนดเอง Blob ที่ให้ไว้
createFile(name, content)Fileสร้างไฟล์ข้อความในโฟลเดอร์ปัจจุบันด้วยชื่อและเนื้อหาที่ระบุ
createFile(name, content, mimeType)Fileสร้างไฟล์ในโฟลเดอร์ปัจจุบันโดยใช้ชื่อ เนื้อหา และประเภท MIME ที่ระบุ
createFolder(name)Folderสร้างโฟลเดอร์ในโฟลเดอร์ปัจจุบันด้วยชื่อที่ระบุ
createShortcut(targetId)Fileสร้างทางลัดไปยังรหัสรายการในไดรฟ์ที่ระบุและส่งกลับ
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)Fileสร้างทางลัดไปยังรหัสรายการในไดรฟ์และคีย์ทรัพยากรที่ระบุ แล้วส่งกลับ
getAccess(email)Permissionรับสิทธิ์ที่มอบให้กับผู้ใช้ที่ระบุ
getAccess(user)Permissionรับสิทธิ์ที่มอบให้กับผู้ใช้ที่ระบุ
getDateCreated()Dateรับข้อมูลวันที่สร้าง Folder
getDescription()Stringรับคำอธิบายสำหรับ Folder
getEditors()User[]รับรายชื่อเอดิเตอร์สำหรับ Folder นี้
getFiles()FileIteratorรับคอลเล็กชันของไฟล์ทั้งหมดที่เป็นรายการย่อยของโฟลเดอร์ปัจจุบัน
getFilesByName(name)FileIteratorรับคอลเล็กชันของไฟล์ทั้งหมดที่เป็นรายการย่อยของโฟลเดอร์ปัจจุบันและมีชื่อตาม
getFilesByType(mimeType)FileIteratorรับคอลเล็กชันของไฟล์ทั้งหมดที่เป็นรายการย่อยของโฟลเดอร์ปัจจุบันและมีประเภท MIME ที่ระบุ
getFolders()FolderIteratorรับคอลเล็กชันของโฟลเดอร์ทั้งหมดที่เป็นรายการย่อยของโฟลเดอร์ปัจจุบัน
getFoldersByName(name)FolderIteratorรับคอลเล็กชันของโฟลเดอร์ทั้งหมดที่เป็นโฟลเดอร์ย่อยของโฟลเดอร์ปัจจุบันและมีชื่อตาม
getId()Stringรับรหัสของ Folder
getLastUpdated()Dateรับข้อมูลวันที่อัปเดต Folder ครั้งล่าสุด
getName()Stringเรียกชื่อของ Folder
getOwner()Userรับเจ้าของ Folder นี้
getParents()FolderIteratorรับคอลเล็กชันโฟลเดอร์ที่เป็นระดับบนสุดของ Folder ทันที
getResourceKey()Stringรับคีย์ทรัพยากรของ Folder ซึ่งจำเป็นสำหรับการเข้าถึงรายการที่แชร์โดยใช้ลิงก์
getSecurityUpdateEligible()Booleanกำหนดว่า Folder นี้มีสิทธิ์ใช้การอัปเดตความปลอดภัยที่ต้องมีคีย์แหล่งข้อมูลสำหรับการเข้าถึงหรือไม่เมื่อแชร์ด้วยลิงก์
getSecurityUpdateEnabled()Booleanกำหนดว่า Folder นี้ต้องใช้คีย์ทรัพยากรสำหรับการเข้าถึงหรือไม่เมื่อแชร์โดยใช้ลิงก์
getSharingAccess()Accessรับข้อมูลระดับของผู้ใช้ที่สามารถเข้าถึง Folder ได้ นอกเหนือจากผู้ใช้รายบุคคลที่ได้รับสิทธิ์เข้าถึงอย่างชัดเจน
getSharingPermission()Permissionได้รับสิทธิ์ให้แก่ผู้ใช้ที่เข้าถึง Folder ได้ นอกเหนือจากผู้ใช้แต่ละรายที่ได้รับสิทธิ์อย่างชัดแจ้ง
getSize()Integerรับจำนวนไบต์ที่ใช้จัดเก็บ Folder ในไดรฟ์
getUrl()Stringรับ URL ที่สามารถใช้เปิด Folder ในแอป Google เช่น ไดรฟ์และเอกสาร
getViewers()User[]รับรายชื่อผู้ดูและผู้แสดงความคิดเห็นสำหรับ Folder นี้
isShareableByEditors()Booleanกำหนดว่าผู้ใช้ที่มีสิทธิ์แก้ไขใน Folder จะได้รับอนุญาตให้แชร์กับผู้ใช้รายอื่นหรือเปลี่ยนสิทธิ์หรือไม่
isStarred()Booleanกำหนดว่าได้ติดดาว Folder ในไดรฟ์ของผู้ใช้แล้วหรือไม่
isTrashed()Booleanกำหนดว่า Folder อยู่ในถังขยะของไดรฟ์ของผู้ใช้หรือไม่
moveTo(destination)Folderย้ายรายการนี้ไปยังโฟลเดอร์ปลายทางที่ระบุ
removeEditor(emailAddress)Folderนำผู้ใช้ที่ระบุออกจากรายชื่อเอดิเตอร์ของ Folder
removeEditor(user)Folderนำผู้ใช้ที่ระบุออกจากรายชื่อเอดิเตอร์ของ Folder
removeViewer(emailAddress)Folderนำผู้ใช้ที่ระบุออกจากรายชื่อผู้ดูและผู้แสดงความคิดเห็นสำหรับ Folder
removeViewer(user)Folderนำผู้ใช้ที่ระบุออกจากรายชื่อผู้ดูและผู้แสดงความคิดเห็นสำหรับ Folder
revokePermissions(emailAddress)Folderเพิกถอนสิทธิ์เข้าถึง Folder ที่มอบให้แก่ผู้ใช้
revokePermissions(user)Folderเพิกถอนสิทธิ์เข้าถึง Folder ที่มอบให้แก่ผู้ใช้
searchFiles(params)FileIteratorรับคอลเล็กชันของไฟล์ทั้งหมดที่เป็นโฟลเดอร์ย่อยของโฟลเดอร์ปัจจุบัน และตรงกับเกณฑ์การค้นหาที่ระบุ
searchFolders(params)FolderIteratorรับคอลเล็กชันของโฟลเดอร์ทั้งหมดที่เป็นโฟลเดอร์ย่อยของโฟลเดอร์ปัจจุบัน และตรงกับเกณฑ์การค้นหาที่ระบุ
setDescription(description)Folderตั้งค่าคำอธิบายสำหรับ Folder
setName(name)Folderตั้งชื่อของ Folder
setOwner(emailAddress)Folderเปลี่ยนเจ้าของ Folder
setOwner(user)Folderเปลี่ยนเจ้าของ Folder
setSecurityUpdateEnabled(enabled)Folderตั้งค่าว่า Folder ต้องใช้คีย์ทรัพยากรสำหรับการเข้าถึงหรือไม่เมื่อแชร์โดยใช้ลิงก์
setShareableByEditors(shareable)Folderตั้งค่าว่าจะอนุญาตให้ผู้ใช้ที่มีสิทธิ์แก้ไขใน Folder แชร์กับผู้ใช้รายอื่นหรือเปลี่ยนสิทธิ์หรือไม่
setSharing(accessType, permissionType)Folderตั้งค่าคลาสของผู้ใช้ที่สามารถเข้าถึง Folder และสิทธิ์ของผู้ใช้ที่ได้รับอนุญาต นอกเหนือจากผู้ใช้รายบุคคลที่ได้รับสิทธิ์เข้าถึงอย่างชัดเจน
setStarred(starred)Folderตั้งค่าการติดดาว Folder ในไดรฟ์ของผู้ใช้
setTrashed(trashed)Folderตั้งค่าว่า Folder อยู่ในถังขยะของไดรฟ์ของผู้ใช้หรือไม่

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

addEditor(emailAddress)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

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

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

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

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

addEditor(user)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

addEditors(emailAddresses)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

addViewer(emailAddress)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

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

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

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

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

addViewer(user)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

addViewers(emailAddresses)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

createFile(blob)

สร้างไฟล์ในโฟลเดอร์ปัจจุบันจากข้อมูลที่กําหนดเอง Blob ที่ให้ไว้

// Create an image file in Google Drive using the Maps service.
var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob();
DriveApp.getRootFolder().createFile(blob);

พารามิเตอร์

ชื่อTypeคำอธิบาย
blobBlobSourceข้อมูลสำหรับไฟล์ใหม่

รีเทิร์น

File — ไฟล์ใหม่

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

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

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

createFile(name, content)

สร้างไฟล์ข้อความในโฟลเดอร์ปัจจุบันด้วยชื่อและเนื้อหาที่ระบุ ซึ่งมีข้อยกเว้นหาก content มีขนาดใหญ่กว่า 50 MB

// Create a text file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New Text File', 'Hello, world!');

พารามิเตอร์

ชื่อTypeคำอธิบาย
nameStringชื่อของไฟล์ใหม่
contentStringเนื้อหาสำหรับไฟล์ใหม่

รีเทิร์น

File — ไฟล์ใหม่

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

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

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

createFile(name, content, mimeType)

สร้างไฟล์ในโฟลเดอร์ปัจจุบันโดยใช้ชื่อ เนื้อหา และประเภท MIME ที่ระบุ มีข้อยกเว้นหาก content มีขนาดใหญ่กว่า 10 MB

// Create an HTML file with the content "Hello, world!"
DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);

พารามิเตอร์

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

รีเทิร์น

File — ไฟล์ใหม่

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

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

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

createFolder(name)

สร้างโฟลเดอร์ในโฟลเดอร์ปัจจุบันด้วยชื่อที่ระบุ

พารามิเตอร์

ชื่อTypeคำอธิบาย
nameStringชื่อโฟลเดอร์ใหม่

รีเทิร์น

Folder — โฟลเดอร์ใหม่

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

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

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

createShortcut(targetId)

สร้างทางลัดไปยังรหัสรายการในไดรฟ์ที่ระบุและส่งกลับ

พารามิเตอร์

ชื่อTypeคำอธิบาย
targetIdStringรหัสของไฟล์หรือโฟลเดอร์เป้าหมาย

รีเทิร์น

File — ทางลัดใหม่

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

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

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

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

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

// Creates shortcuts for all folders in the user's drive that have a specific name.
// TODO(developer): Replace 'Test-Folder' with a valid folder name in your drive.
const folders = DriveApp.getFoldersByName('Test-Folder');

// Iterates through all folders named 'Test-Folder'.
while (folders.hasNext()) {
  const folder = folders.next();

  // Creates a shortcut to the provided Drive item ID and resource key, and returns it.
  DriveApp.createShortcutForTargetIdAndResourceKey(folder.getId(), folder.getResourceKey());
}

พารามิเตอร์

ชื่อTypeคำอธิบาย
targetIdStringรหัสของไฟล์หรือโฟลเดอร์เป้าหมาย
targetResourceKeyStringคีย์ทรัพยากรของไฟล์หรือโฟลเดอร์เป้าหมาย

รีเทิร์น

File — ทางลัดใหม่

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

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

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

getAccess(email)

รับสิทธิ์ที่มอบให้กับผู้ใช้ที่ระบุ

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

getAccess(user)

รับสิทธิ์ที่มอบให้กับผู้ใช้ที่ระบุ

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

getDateCreated()

รับข้อมูลวันที่สร้าง Folder

รีเทิร์น

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

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

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

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

getDescription()

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

รีเทิร์น

String — คำอธิบายสำหรับ Folder

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

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

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

getEditors()

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

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of editors and logs their names to the console.
const editors = folder.getEditors();
for (editor of editors) {
  console.log(editor.getName());
}

รีเทิร์น

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

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

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

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

getFiles()

รับคอลเล็กชันของไฟล์ทั้งหมดที่เป็นรายการย่อยของโฟลเดอร์ปัจจุบัน

รีเทิร์น

FileIterator — คอลเล็กชันของไฟล์ทั้งหมดที่เป็นรายการย่อยของโฟลเดอร์ปัจจุบัน

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

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

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

getFilesByName(name)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
nameStringชื่อไฟล์ที่จะค้นหา

รีเทิร์น

FileIterator — คอลเล็กชันของไฟล์ทั้งหมดที่เป็นส่วนย่อยของโฟลเดอร์ปัจจุบันและมีชื่อที่ระบุไว้

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

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

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

getFilesByType(mimeType)

รับคอลเล็กชันของไฟล์ทั้งหมดที่เป็นรายการย่อยของโฟลเดอร์ปัจจุบันและมีประเภท MIME ที่ระบุ

พารามิเตอร์

ชื่อTypeคำอธิบาย
mimeTypeStringประเภท MIME ของไฟล์ที่จะค้นหา

รีเทิร์น

FileIterator — คอลเล็กชันของไฟล์ทั้งหมดที่เป็นรายการย่อยของโฟลเดอร์ปัจจุบันและมีประเภท MIME ที่ระบุ

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

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

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

getFolders()

รับคอลเล็กชันของโฟลเดอร์ทั้งหมดที่เป็นรายการย่อยของโฟลเดอร์ปัจจุบัน

รีเทิร์น

FolderIterator — คอลเล็กชันของโฟลเดอร์ทั้งหมดที่เป็นโฟลเดอร์ย่อยของโฟลเดอร์ปัจจุบัน

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

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

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

getFoldersByName(name)

รับคอลเล็กชันของโฟลเดอร์ทั้งหมดที่เป็นโฟลเดอร์ย่อยของโฟลเดอร์ปัจจุบันและมีชื่อตาม

พารามิเตอร์

ชื่อTypeคำอธิบาย
nameStringชื่อของโฟลเดอร์ที่จะค้นหา

รีเทิร์น

FolderIterator — คอลเล็กชันของโฟลเดอร์ทั้งหมดที่เป็นโฟลเดอร์ย่อยของโฟลเดอร์ปัจจุบันและมีชื่อที่กำหนด

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

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

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

getId()

รับรหัสของ Folder

รีเทิร์น

String — รหัสของ Folder

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

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

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

getLastUpdated()

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

รีเทิร์น

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

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

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

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

getName()

เรียกชื่อของ Folder

รีเทิร์น

String — ชื่อของ Folder

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

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

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

getOwner()

รับเจ้าของ Folder นี้

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the owner of the folder and logs the name to the console.
const folderOwner = folder.getOwner();
console.log(folderOwner.getName());

รีเทิร์น

User — เจ้าของ Folder นี้

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

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

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

getParents()

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

รีเทิร์น

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

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

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

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

getResourceKey()

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

รีเทิร์น

String — คีย์ทรัพยากรของ Folder

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

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

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

getSecurityUpdateEligible()

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

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

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

รีเทิร์น

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

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

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

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

getSecurityUpdateEnabled()

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

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

รีเทิร์น

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

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

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

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

getSharingAccess()

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

รีเทิร์น

Access — ผู้ใช้ระดับใดจะเข้าถึง Folder ได้

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

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

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

getSharingPermission()

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

รีเทิร์น

Permission — สิทธิ์ที่ผู้ใช้ที่เข้าถึง Folder ได้

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

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

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

getSize()

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

รีเทิร์น

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

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

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

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

getUrl()

รับ URL ที่สามารถใช้เปิด Folder ในแอป Google เช่น ไดรฟ์และเอกสาร

รีเทิร์น

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

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

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

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

getViewers()

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

// Gets a folder by its ID.
// TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of viewers and logs their names to the console.
const viewers = folder.getViewers();
for (viewer of viewers) {
  console.log(viewer.getName());
}

รีเทิร์น

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

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

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

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

isShareableByEditors()

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

รีเทิร์น

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

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

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

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

isStarred()

กำหนดว่าได้ติดดาว Folder ในไดรฟ์ของผู้ใช้แล้วหรือไม่

รีเทิร์น

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

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

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

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

isTrashed()

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

รีเทิร์น

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

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

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

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

moveTo(destination)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

removeEditor(emailAddress)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

removeEditor(user)

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

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
userUserตัวแทนของผู้ใช้ที่จะนำออก

รีเทิร์น

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

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

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

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

removeViewer(emailAddress)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

removeViewer(user)

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

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
userUserตัวแทนของผู้ใช้ที่จะนำออก

รีเทิร์น

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

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

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

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

revokePermissions(emailAddress)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

revokePermissions(user)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

searchFiles(params)

รับคอลเล็กชันของไฟล์ทั้งหมดที่เป็นโฟลเดอร์ย่อยของโฟลเดอร์ปัจจุบัน และตรงกับเกณฑ์การค้นหาที่ระบุ ดูเกณฑ์การค้นหาอย่างละเอียดได้ในเอกสารประกอบเกี่ยวกับ SDK ของ Google ไดรฟ์ โปรดทราบว่าบริการไดรฟ์ใช้ Drive API เวอร์ชัน 2 และฟิลด์การค้นหาบางช่องแตกต่างจากเวอร์ชัน 3 ตรวจสอบความแตกต่างของช่องระหว่าง v2 และ v3

อาร์กิวเมนต์ params เป็นสตริงคำค้นหาที่อาจมีค่าสตริงได้ ดังนั้นโปรดใช้อักขระหลีกกับเครื่องหมายคำพูดให้ถูกต้อง (เช่น "title contains 'Gulliver\\'s Travels'" หรือ 'title contains "Gulliver\'s Travels"')

// Logs the name of every file that are children of the current folder and modified after February 28,
// 2022 whose name contains "untitled.""
var files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

พารามิเตอร์

ชื่อTypeคำอธิบาย
paramsStringเกณฑ์การค้นหาตามรายละเอียดในเอกสารประกอบ Google Drive SDK

รีเทิร์น

FileIterator — คอลเล็กชันของไฟล์ทั้งหมดที่เป็นรายการย่อยของโฟลเดอร์ปัจจุบันและตรงตามเกณฑ์การค้นหา

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

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

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

searchFolders(params)

รับคอลเล็กชันของโฟลเดอร์ทั้งหมดที่เป็นโฟลเดอร์ย่อยของโฟลเดอร์ปัจจุบัน และตรงกับเกณฑ์การค้นหาที่ระบุ ดูเกณฑ์การค้นหาอย่างละเอียดได้ในเอกสารประกอบเกี่ยวกับ SDK ของ Google ไดรฟ์ โปรดทราบว่าบริการไดรฟ์ใช้ Drive API เวอร์ชัน 2 และฟิลด์การค้นหาบางช่องแตกต่างจากเวอร์ชัน 3 ตรวจสอบความแตกต่างของช่องระหว่าง v2 และ v3

อาร์กิวเมนต์ params เป็นสตริงคำค้นหาที่อาจมีค่าสตริงได้ ดังนั้นโปรดใช้อักขระหลีกกับเครื่องหมายคำพูดให้ถูกต้อง (เช่น "title contains 'Gulliver\\'s Travels'" หรือ 'title contains "Gulliver\'s Travels"')

// Logs the name of every folder that are children of the current folder and you own and is starred.
var folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var folder = folders.next();
  console.log(folder.getName());
}

พารามิเตอร์

ชื่อTypeคำอธิบาย
paramsStringเกณฑ์การค้นหาตามรายละเอียดในเอกสารประกอบ Google Drive SDK

รีเทิร์น

FolderIterator — คอลเล็กชันของโฟลเดอร์ทั้งหมดที่เป็นโฟลเดอร์ย่อยของโฟลเดอร์ปัจจุบันและตรงกับเกณฑ์การค้นหา

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

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

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

setDescription(description)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
descriptionStringคำอธิบายใหม่สำหรับ Folder

รีเทิร์น

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

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

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

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

setName(name)

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

พารามิเตอร์

ชื่อTypeคำอธิบาย
nameStringชื่อใหม่ของ Folder

รีเทิร์น

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

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

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

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

setOwner(emailAddress)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setOwner(user)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setSecurityUpdateEnabled(enabled)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setShareableByEditors(shareable)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setSharing(accessType, permissionType)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setStarred(starred)

ตั้งค่าการติดดาว Folder ในไดรฟ์ของผู้ใช้ ค่าเริ่มต้นของ Folder ใหม่คือ false

พารามิเตอร์

ชื่อTypeคำอธิบาย
starredBooleantrue หาก Folder ควรติดดาวในไดรฟ์ของผู้ใช้ false หากไม่ใช่

รีเทิร์น

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

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

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

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

setTrashed(trashed)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

วิธีการที่เลิกใช้งานแล้ว