Class DriveApp

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

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

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

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

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`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`	เปิดหรือปิดใช้ลักษณะการทำงานของ enforceSingleParent สำหรับการเรียกทั้งหมดที่ส่งผลต่อรายการหลัก
`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`	รับคอลเล็กชันของโฟลเดอร์ทั้งหมดในไดรฟ์ของผู้ใช้ที่ตรงกับเกณฑ์การค้นหาที่ระบุ

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

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`addFile(child)`	`Folder`	เพิ่มไฟล์ที่ระบุไปยังรูทของไดรฟ์ของผู้ใช้
`addFolder(child)`	`Folder`	เพิ่มโฟลเดอร์ที่ระบุไปยังรูทของไดรฟ์ของผู้ใช้
`removeFile(child)`	`Folder`	นำไฟล์ที่ระบุออกจากรูทของไดรฟ์ของผู้ใช้
`removeFolder(child)`	`Folder`	นำโฟลเดอร์ที่ระบุออกจากรูทของไดรฟ์ของผู้ใช้

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

`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());
}

พารามิเตอร์

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

รีเทิร์น

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());
}

พารามิเตอร์

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

รีเทิร์น

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

`createFile(blob)`

สร้างไฟล์ในรูทของไดรฟ์ของผู้ใช้จาก Blob ของข้อมูลที่กำหนด

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`blob`	`BlobSource`	ข้อมูลสำหรับไฟล์ใหม่

รีเทิร์น

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!');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`name`	`String`	ชื่อของไฟล์ใหม่
`content`	`String`	เนื้อหาสำหรับไฟล์ใหม่

รีเทิร์น

File - ไฟล์ใหม่

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`name`	`String`	ชื่อของไฟล์ใหม่
`content`	`String`	เนื้อหาสำหรับไฟล์ใหม่
`mimeType`	`String`	ประเภท MIME ของไฟล์ใหม่

รีเทิร์น

File - ไฟล์ใหม่

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

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

`createFolder(name)`

สร้างโฟลเดอร์ในรูทของไดรฟ์ของผู้ใช้โดยใช้ชื่อที่ระบุ

พารามิเตอร์

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

รีเทิร์น

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

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

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

`createShortcut(targetId)`

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`targetId`	`String`	รหัสไฟล์ของไฟล์หรือโฟลเดอร์เป้าหมาย

รีเทิร์น

File — แป้นพิมพ์ลัดใหม่

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

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(),
  );
}

พารามิเตอร์

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

รีเทิร์น

File — แป้นพิมพ์ลัดใหม่

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

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

`enforceSingleParent(value)`

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

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

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`value`	`Boolean`	สถานะใหม่ของแฟล็ก enforceSingleParent

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

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());
}

พารามิเตอร์

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

รีเทิร์น

File — ไฟล์ที่มีรหัสที่ระบุ

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

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());
}

พารามิเตอร์

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

รีเทิร์น

File — ไฟล์ที่มีรหัสที่ระบุ

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

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

`getFiles()`

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

รีเทิร์น

FileIterator — คอลเล็กชันของไฟล์ทั้งหมดในไดรฟ์ของผู้ใช้

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

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

`getFilesByName(name)`

รับคอลเล็กชันของไฟล์ทั้งหมดในไดรฟ์ของผู้ใช้ที่มีชื่อที่ระบุ

พารามิเตอร์

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

รีเทิร์น

FileIterator — คอลเล็กชันของไฟล์ทั้งหมดในไดรฟ์ของผู้ใช้ที่มีชื่อที่ระบุ

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

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

`getFilesByType(mimeType)`

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

พารามิเตอร์

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

รีเทิร์น

FileIterator — คอลเล็กชันของไฟล์ทั้งหมดในไดรฟ์ของผู้ใช้ที่มี MIME ประเภทที่ระบุ

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

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

`getFolderById(id)`

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

พารามิเตอร์

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

รีเทิร์น

Folder - โฟลเดอร์ที่มีรหัสที่ระบุ

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

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

`getFolderByIdAndResourceKey(id, resourceKey)`

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

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

พารามิเตอร์

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

รีเทิร์น

Folder - โฟลเดอร์ที่มีรหัสที่ระบุ

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

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

`getFolders()`

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

รีเทิร์น

FolderIterator — คอลเล็กชันของโฟลเดอร์ทั้งหมดในไดรฟ์ของผู้ใช้

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

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

`getFoldersByName(name)`

รับคอลเล็กชันของโฟลเดอร์ทั้งหมดในไดรฟ์ของผู้ใช้ที่มีชื่อที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`name`	`String`	ชื่อโฟลเดอร์ที่จะค้นหา

รีเทิร์น

FolderIterator — คอลเล็กชันของโฟลเดอร์ทั้งหมดในไดรฟ์ของผู้ใช้ที่มีชื่อที่ระบุ

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

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 — โฟลเดอร์รูทของไดรฟ์ของผู้ใช้

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

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 — จำนวนไบต์ที่ผู้ใช้ได้รับอนุญาตให้จัดเก็บในไดรฟ์

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

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 — จำนวนไบต์ที่ผู้ใช้จัดเก็บไว้ในไดรฟ์ในขณะนี้

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

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 — คอลเล็กชันของไฟล์ในถังขยะ

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

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 - โฟลเดอร์ที่อยู่ในถังขยะ

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

https://www.googleapis.com/auth/drive.readonly
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 in the user's Drive that modified after February 28,
// 2022 whose name contains "untitled.""
const files = DriveApp.searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getName());
}

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`params`	`String`	เกณฑ์การค้นหาตามที่ระบุไว้ในเอกสารประกอบ Google ไดรฟ์ SDK

รีเทิร์น

FileIterator — คอลเล็กชันของไฟล์ทั้งหมดในไดรฟ์ของผู้ใช้ที่ตรงกับเกณฑ์การค้นหา

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

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

`searchFolders(params)`

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

// Logs the name of every folder in the user's Drive that you own and is starred.
const folders = DriveApp.searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  const folder = folders.next();
  console.log(folder.getName());
}

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`params`	`String`	เกณฑ์การค้นหาตามที่ระบุไว้ในเอกสารประกอบ Google ไดรฟ์ SDK

รีเทิร์น

FolderIterator — คอลเล็กชันของโฟลเดอร์ทั้งหมดในไดรฟ์ของผู้ใช้ที่ตรงกับเกณฑ์การค้นหา

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

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

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

`addFile(child)`

เลิกใช้งานแล้ว แต่ให้ใช้ File.moveTo(destination) หรือ Folder.createShortcut(targetId) แทน

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`child`	`File`	ไฟล์ย่อยที่จะเพิ่ม

รีเทิร์น

Folder — ผู้ปกครองรายใหม่ของไฟล์ที่เพิ่มเป็นไฟล์ย่อย

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

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

`addFolder(child)`

เลิกใช้งานแล้ว แต่ให้ใช้ Folder.moveTo(destination) หรือ Folder.createShortcut(targetId) แทน

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`child`	`Folder`	โฟลเดอร์ย่อยที่จะเพิ่ม

รีเทิร์น

Folder — โฟลเดอร์ระดับบนสุดใหม่ของโฟลเดอร์ที่เพิ่มเป็นโฟลเดอร์ย่อย

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

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

`removeFile(child)`

เลิกใช้งานแล้ว แต่ให้ระบุองค์กรใน File.moveTo(destination)

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`child`	`File`	ไฟล์ย่อยที่จะนำออก

รีเทิร์น

Folder — ผู้ปกครองคนก่อนของเด็ก

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

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

`removeFolder(child)`

เลิกใช้งานแล้ว แต่ให้ระบุองค์กรใน Folder.moveTo(destination)

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`child`	`Folder`	โฟลเดอร์ย่อยที่จะนำออก

รีเทิร์น

Folder — ผู้ปกครองคนก่อนของเด็ก

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

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

Class DriveApp จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

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

เมธอด

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

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

continueFileIterator(continuationToken)

พารามิเตอร์

รีเทิร์น

continueFolderIterator(continuationToken)

พารามิเตอร์

รีเทิร์น

createFile(blob)

พารามิเตอร์

รีเทิร์น

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

createFile(name, content)

พารามิเตอร์

รีเทิร์น

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

createFile(name, content, mimeType)

พารามิเตอร์

รีเทิร์น

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

createFolder(name)

พารามิเตอร์

รีเทิร์น

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

createShortcut(targetId)

พารามิเตอร์

รีเทิร์น

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

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

พารามิเตอร์

รีเทิร์น

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

enforceSingleParent(value)

พารามิเตอร์

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

getFileById(id)

พารามิเตอร์

รีเทิร์น

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

getFileByIdAndResourceKey(id, resourceKey)

พารามิเตอร์

รีเทิร์น

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

getFiles()

รีเทิร์น

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

getFilesByName(name)

พารามิเตอร์

รีเทิร์น

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

getFilesByType(mimeType)

พารามิเตอร์

รีเทิร์น

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

getFolderById(id)

พารามิเตอร์

รีเทิร์น

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

getFolderByIdAndResourceKey(id, resourceKey)

พารามิเตอร์

รีเทิร์น

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

getFolders()

รีเทิร์น

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

getFoldersByName(name)

พารามิเตอร์

รีเทิร์น

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

getRootFolder()

รีเทิร์น

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

getStorageLimit()

รีเทิร์น

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

getStorageUsed()

รีเทิร์น

Class DriveApp

`continueFileIterator(continuationToken)`

`continueFolderIterator(continuationToken)`

`createFile(blob)`

`createFile(name, content)`

`createFile(name, content, mimeType)`

`createFolder(name)`

`createShortcut(targetId)`

`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`

`enforceSingleParent(value)`

`getFileById(id)`

`getFileByIdAndResourceKey(id, resourceKey)`

`getFiles()`

`getFilesByName(name)`

`getFilesByType(mimeType)`

`getFolderById(id)`

`getFolderByIdAndResourceKey(id, resourceKey)`

`getFolders()`

`getFoldersByName(name)`

`getRootFolder()`

`getStorageLimit()`

`getStorageUsed()`

`getTrashedFiles()`

`getTrashedFolders()`

`searchFiles(params)`

`searchFolders(params)`

`addFile(child)`

`addFolder(child)`

`removeFile(child)`

`removeFolder(child)`