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 หากผู้ใช้เคยเป็นสมาชิกแล้ว ในรายชื่อผู้ดู ซึ่งจะโปรโมตผู้ใช้ออกจากรายชื่อผู้ดู

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

addEditor(user)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

addEditors(emailAddresses)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

addViewer(emailAddress)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

addViewer(user)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

addViewers(emailAddresses)

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

พารามิเตอร์

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

พารามิเตอร์

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

พารามิเตอร์

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

พารามิเตอร์

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

รีเทิร์น

File — ไฟล์ใหม่

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

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

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

createFolder(name)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
nameStringชื่อของโฟลเดอร์ใหม่

รีเทิร์น

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

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

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

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

createShortcut(targetId)

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

พารามิเตอร์

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

พารามิเตอร์

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

รีเทิร์น

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

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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

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)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

getFilesByType(mimeType)

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

พารามิเตอร์

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

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

พารามิเตอร์

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

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

removeEditor(emailAddress)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

removeEditor(user)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

removeViewer(emailAddress)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

removeViewer(user)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

revokePermissions(emailAddress)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

revokePermissions(user)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

searchFiles(params)

รับคอลเล็กชันไฟล์ทั้งหมดที่เป็นระดับย่อยของโฟลเดอร์ปัจจุบันและตรงกับการค้นหาที่ระบุ เกณฑ์ โปรดดูรายละเอียดเกณฑ์การค้นหาในเอกสารประกอบ Google Drive SDK โปรดทราบว่าไดรฟ์ บริการใช้ 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());
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
paramsStringเกณฑ์การค้นหา โปรดดูรายละเอียดในเอกสารประกอบเกี่ยวกับ Google Drive SDK

รีเทิร์น

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

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

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

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

searchFolders(params)

รับคอลเล็กชันของโฟลเดอร์ทั้งหมดที่เป็นโฟลเดอร์ย่อยของโฟลเดอร์ปัจจุบันและตรงกับการค้นหาที่ระบุ เกณฑ์ โปรดดูรายละเอียดเกณฑ์การค้นหาในเอกสารประกอบ Google Drive SDK โปรดทราบว่าไดรฟ์ บริการใช้ 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());
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
paramsStringเกณฑ์การค้นหา โปรดดูรายละเอียดในเอกสารประกอบเกี่ยวกับ Google Drive SDK

รีเทิร์น

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

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

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

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

setDescription(description)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setName(name)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setOwner(emailAddress)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setOwner(user)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setSecurityUpdateEnabled(enabled)

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setShareableByEditors(shareable)

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

พารามิเตอร์

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setStarred(starred)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

setTrashed(trashed)

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

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