Class Folder

โฟลเดอร์

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

// Log the name of every folder in the user's Drive.
const folders = DriveApp.getFolders();
while (folders.hasNext()) {
  const 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 ของข้อมูลที่กำหนด

พารามิเตอร์

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

รับสิทธิ์ที่มอบให้แก่ผู้ใช้ที่เฉพาะเจาะจง วิธีการนี้ไม่รองรับการแสดงผลสิทธิ์สำหรับ 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

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 (const 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 จะไม่นับรวมในขีดจำกัดพื้นที่เก็บข้อมูลของไดรฟ์ จึงแสดงผลเป็น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 (const 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.""
const files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  const 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.
const folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  const 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.)
const 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

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