Class DriveApp

DriveApp

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

// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

พร็อพเพอร์ตี้

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

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
continueFileIterator(continuationToken)FileIteratorทำซ้ำไฟล์ต่อโดยใช้โทเค็นต่อเนื่องจากตัวทำซ้ำก่อนหน้า
continueFolderIterator(continuationToken)FolderIteratorดำเนินการทำซ้ำโฟลเดอร์ต่อโดยใช้โทเค็นต่อเนื่องจากตัวทำซ้ำก่อนหน้า
createFile(blob)Fileสร้างไฟล์ในรูทของไดรฟ์ของผู้ใช้จาก Blob ที่ระบุของข้อมูลที่กำหนดเอง
createFile(name, content)Fileสร้างไฟล์ข้อความในรูทของไดรฟ์ของผู้ใช้โดยใช้ชื่อและเนื้อหาในนั้น
createFile(name, content, mimeType)Fileสร้างไฟล์ในรูทของไดรฟ์ของผู้ใช้โดยใช้ชื่อ เนื้อหา และประเภท MIME ตามที่ระบุ
createFolder(name)Folderสร้างโฟลเดอร์ในรูทของไดรฟ์ของผู้ใช้โดยใช้ชื่อที่ตั้งไว้
createShortcut(targetId)Fileสร้างทางลัดไปยังรหัสรายการในไดรฟ์ที่ระบุ แล้วส่งกลับ
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)Fileสร้างทางลัดไปยังรหัสรายการในไดรฟ์และคีย์แหล่งข้อมูลที่ระบุ แล้วส่งกลับ
enforceSingleParent(value)voidเปิดใช้หรือปิดใช้ลักษณะการบังคับใช้ SingleParent สำหรับการเรียกทั้งหมดที่มีผลกับรายการระดับบน
getFileById(id)Fileรับไฟล์ที่มีรหัสที่ระบุ
getFileByIdAndResourceKey(id, resourceKey)Fileดาวน์โหลดไฟล์ด้วยรหัสที่ระบุและคีย์ทรัพยากร
getFiles()FileIteratorรับคอลเล็กชันไฟล์ทั้งหมดในไดรฟ์ของผู้ใช้
getFilesByName(name)FileIteratorรับคอลเล็กชันไฟล์ทั้งหมดในไดรฟ์ของผู้ใช้ที่มีชื่อตามที่ระบุ
getFilesByType(mimeType)FileIteratorรับคอลเล็กชันไฟล์ทั้งหมดในไดรฟ์ของผู้ใช้ที่มีประเภท MIME ที่ระบุ
getFolderById(id)Folderรับโฟลเดอร์ที่มีรหัสที่ระบุ
getFolderByIdAndResourceKey(id, resourceKey)Folderรับโฟลเดอร์ที่มีรหัสและคีย์แหล่งข้อมูลที่ระบุ
getFolders()FolderIteratorรับคอลเล็กชันของโฟลเดอร์ทั้งหมดในไดรฟ์ของผู้ใช้
getFoldersByName(name)FolderIteratorรับคอลเล็กชันของโฟลเดอร์ทั้งหมดในไดรฟ์ของผู้ใช้ที่มีชื่อตามที่ระบุ
getRootFolder()Folderรับโฟลเดอร์ที่รูทของไดรฟ์ของผู้ใช้
getStorageLimit()Integerรับจำนวนไบต์ที่ผู้ใช้เก็บในไดรฟ์ได้
getStorageUsed()Integerรับจำนวนไบต์ที่ผู้ใช้จัดเก็บไว้ในไดรฟ์
getTrashedFiles()FileIteratorรับคอลเล็กชันของไฟล์ทั้งหมดในถังขยะสำหรับไดรฟ์ของผู้ใช้
getTrashedFolders()FolderIteratorรับคอลเล็กชันของโฟลเดอร์ทั้งหมดในถังขยะสำหรับไดรฟ์ของผู้ใช้
searchFiles(params)FileIteratorรับคอลเล็กชันไฟล์ทั้งหมดในไดรฟ์ของผู้ใช้ที่ตรงกับการค้นหาที่ระบุ เกณฑ์
searchFolders(params)FolderIteratorรับคอลเล็กชันของโฟลเดอร์ทั้งหมดในไดรฟ์ของผู้ใช้ที่ตรงกับการค้นหาที่ระบุ เกณฑ์

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

continueFileIterator(continuationToken)

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

// Continues getting a list of all 'Untitled document' files in the user's Drive.
// Creates a file iterator named 'previousIterator'.
const previousIterator = DriveApp.getFilesByName('Untitled document');

// Gets continuation token from the previous file iterator.
const continuationToken = previousIterator.getContinuationToken();

// Creates a new iterator using the continuation token from the previous file iterator.
const newIterator = DriveApp.continueFileIterator(continuationToken);

// Resumes the file iteration using a continuation token from 'firstIterator' and
// logs the file name.
if (newIterator.hasNext()) {
  const file = newIterator.next();
  console.log(file.getName());
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
continuationTokenStringโทเค็นต่อเนื่องจากตัวทำซ้ำไฟล์ก่อนหน้า

รีเทิร์น

FileIterator — คอลเล็กชันของไฟล์ที่อยู่ในตัวซ้ำก่อนหน้าเมื่อโทเค็นต่อเนื่อง ถูกสร้างขึ้น แล้ว


continueFolderIterator(continuationToken)

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

// Continues getting a list of all folders in user's Drive.
// Creates a folder iterator named 'previousIterator'.
const previousIterator = DriveApp.getFolders();

// Gets continuation token from the previous folder iterator.
const continuationToken = previousIterator.getContinuationToken();

// Creates a new iterator using the continuation token from the previous folder iterator.
const newIterator = DriveApp.continueFolderIterator(continuationToken);

// Resumes the folder iteration using a continuation token from the previous iterator and logs
// the folder name.
if (newIterator.hasNext()) {
  const folder = newIterator.next();
  console.log(folder.getName());
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
continuationTokenStringโทเค็นต่อเนื่องจากตัวทำซ้ำโฟลเดอร์ก่อนหน้า

รีเทิร์น

FolderIterator — คอลเล็กชันของโฟลเดอร์ที่ยังคงอยู่ในโปรแกรมวนซ้ำก่อนหน้านี้เมื่อมีการดำเนินการต่อ สร้างโทเค็นแล้ว


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.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.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.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

enforceSingleParent(value)

เปิดใช้หรือปิดใช้ลักษณะการบังคับใช้ SingleParent สำหรับการเรียกทั้งหมดที่มีผลกับรายการระดับบน

ดูบล็อก การลดความซับซ้อนของโครงสร้างโฟลเดอร์และโมเดลการแชร์ของ Google ไดรฟ์สำหรับ รายละเอียดเพิ่มเติม

// Enables enforceSingleParent behavior for all calls affecting item parents.
DriveApp.enforceSingleParent(true);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
valueBooleanสถานะใหม่ของค่าสถานะ forceSingleParent

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

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

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

getFileById(id)

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace 'Test' with your file name.
const files = DriveApp.getFilesByName('Test');

if (files.hasNext()) {
  // Gets the ID of each file in the list.
  const fileId = files.next().getId();

  // Gets the file name using its ID and logs it to the console.
  console.log(DriveApp.getFileById(fileId).getName());
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
idStringรหัสของไฟล์

รีเทิร์น

File — ไฟล์ที่มีรหัสที่กำหนด

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

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

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

getFileByIdAndResourceKey(id, resourceKey)

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

ส่งข้อยกเว้นสคริปต์ในกรณีที่ไม่มีไฟล์หรือผู้ใช้ไม่มีสิทธิ์ เพื่อเข้าถึงฟีดได้

// Gets a list of all files in Drive with the given name.
// TODO(developer): Replace 'Test' with your file name.
const files = DriveApp.getFilesByName('Test');
if (files.hasNext()) {

  // Gets the first file in the list.
  const file = files.next();

  // Gets the ID and resource key.
  const key = file.getResourceKey();
  const id = file.getId();

  // Logs the file name to the console using its ID and resource key.
  console.log(DriveApp.getFileByIdAndResourceKey(id, key).getName());
}

พารามิเตอร์

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

รีเทิร์น

File — ไฟล์ที่มีรหัสที่กำหนด

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

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

getFolderById(id)

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

พารามิเตอร์

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

รีเทิร์น

Folder — โฟลเดอร์ที่มีรหัสที่กำหนด

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

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

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

getFolderByIdAndResourceKey(id, resourceKey)

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

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

พารามิเตอร์

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

รีเทิร์น

Folder — โฟลเดอร์ที่มีรหัสที่กำหนด

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

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

getRootFolder()

รับโฟลเดอร์ที่รูทของไดรฟ์ของผู้ใช้

// Gets the user's My Drive folder and logs its name to the console.
console.log(DriveApp.getRootFolder().getName());

// Logs the Drive owner's name to the console.
console.log(DriveApp.getRootFolder().getOwner().getName());

รีเทิร์น

Folder — โฟลเดอร์รูทของไดรฟ์ของผู้ใช้

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

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

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

getStorageLimit()

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

// Gets the number of bytes the user can store in Drive and logs it to the console.
console.log(DriveApp.getStorageLimit());

รีเทิร์น

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

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

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

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

getStorageUsed()

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

// Gets the number of bytes the user is currently storing in Drive and logs it to the console.
console.log(DriveApp.getStorageUsed());

รีเทิร์น

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

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

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

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

getTrashedFiles()

รับคอลเล็กชันของไฟล์ทั้งหมดในถังขยะสำหรับไดรฟ์ของผู้ใช้

// Gets a list of all the files in the trash of the user's Drive.
const trashFiles = DriveApp.getTrashedFiles();

// Logs the trash file names to the console.
while (trashFiles.hasNext()) {
  const file = trashFiles.next();
  console.log(file.getName());
}

รีเทิร์น

FileIterator — คอลเล็กชันของไฟล์ในถังขยะ

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

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

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

getTrashedFolders()

รับคอลเล็กชันของโฟลเดอร์ทั้งหมดในถังขยะสำหรับไดรฟ์ของผู้ใช้

// Gets a collection of all the folders in the trash of the user's Drive.
const trashFolders = DriveApp.getTrashedFolders();

// Logs the trash folder names to the console.
while (trashFolders.hasNext()) {
  const folder = trashFolders.next();
  console.log(folder.getName());
}

รีเทิร์น

FolderIterator — คอลเล็กชันของโฟลเดอร์ในถังขยะ

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

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

  • https://www.googleapis.com/auth/drive.readonly
  • 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 in the user's Drive that modified after February 28,
// 2022 whose name contains "untitled.""
var files = DriveApp.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 in the user's Drive that you own and is starred.
var folders = DriveApp.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

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