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อีเมลของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

Folder — This Folder, for chaining.

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

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

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

addEditor(user)

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

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder, for chaining.

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

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

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

addEditors(emailAddresses)

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

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder, for chaining.

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

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

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

addViewer(emailAddress)

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

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder, for chaining.

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

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

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

addViewer(user)

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

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder, for chaining.

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

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

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

addViewers(emailAddresses)

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

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder, for chaining.

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

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

พารามิเตอร์

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

รีเทิร์น

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

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

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

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

getAccess(user)

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
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 — Whether the resource key requirement can be applied for the 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โฟลเดอร์ที่จะกลายเป็นโฟลเดอร์ระดับบนใหม่

รีเทิร์น

Folder — This Folder, for chaining.

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

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

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

removeEditor(emailAddress)

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

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

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder, for chaining.

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

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

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

removeEditor(user)

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

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

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder, for chaining.

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

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

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

removeViewer(emailAddress)

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

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

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder for chaining.

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

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

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

removeViewer(user)

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

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

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder for chaining.

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

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

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

revokePermissions(emailAddress)

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

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder, for chaining.

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

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

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

revokePermissions(user)

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

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder, for chaining.

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

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

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

searchFiles(params)

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

รีเทิร์น

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

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

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

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

searchFolders(params)

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

ไดรฟ์ไม่รองรับการเปลี่ยนกรรมสิทธิ์ของรายการที่เป็นของบัญชี gmail.com แต่รองรับบัญชี Workspace

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder, for chaining.

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

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

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

setOwner(user)

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

ไดรฟ์ไม่รองรับการเปลี่ยนกรรมสิทธิ์ของรายการที่เป็นของบัญชี gmail.com แต่รองรับบัญชี Workspace

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder, for chaining.

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

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

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

setSecurityUpdateEnabled(enabled)

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

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

พารามิเตอร์

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

รีเทิร์น

Folder — This Folder, for chaining.

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

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

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