เพื่อจัดการไฟล์และโฟลเดอร์ ซึ่งรวมถึงพร็อพเพอร์ตี้ที่กำหนดเองและเวอร์ชันก่อนหน้า
บริการไดรฟ์ขั้นสูงช่วยให้คุณใช้ Google Drive API ใน Google Apps Script ได้ API นี้ช่วยให้สคริปต์สร้าง ค้นหา และแก้ไขไฟล์และโฟลเดอร์ใน Google ไดรฟ์ได้เช่นเดียวกับบริการไดรฟ์ ในตัวของApps Script ในกรณีส่วนใหญ่ บริการในตัวจะใช้งานง่ายกว่า แต่บริการขั้นสูงนี้มีฟีเจอร์เพิ่มเติมบางอย่าง รวมถึงการเข้าถึงพร็อพเพอร์ตี้ไฟล์ที่กำหนดเอง ตลอดจนเวอร์ชันก่อนหน้าของไฟล์และโฟลเดอร์
นี่เป็นบริการขั้นสูงที่ต้องเปิดใช้ก่อน ใช้งาน
ข้อมูลอ้างอิง
ดูข้อมูลโดยละเอียดเกี่ยวกับบริการนี้ได้ในเอกสารอ้างอิงสำหรับ Drive API บริการไดรฟ์ขั้นสูงใช้ฟังก์ชันออบเจ็กต์ เมธอด และพารามิเตอร์เดียวกันกับ API สาธารณะ เช่นเดียวกับบริการขั้นสูงทั้งหมดใน Apps Script ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ วิธีกำหนดลายเซ็นของเมธอด
นอกจากนี้ เมธอดที่ชื่อ delete ใน Drive API จะชื่อ remove ใน
บริการขั้นสูง (เช่น Drive.Permissions.remove()) เนื่องจาก delete เป็น
คำสงวนใน JavaScript
หากต้องการรายงานปัญหาและดูการสนับสนุนอื่นๆ โปรดดูคู่มือการสนับสนุน Drive API
โค้ดตัวอย่าง
โค้ดตัวอย่างในส่วนนี้ใช้ API เวอร์ชัน 3
อัปโหลดไฟล์
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีบันทึกไฟล์ลงในไดรฟ์ของผู้ใช้
สร้างโฟลเดอร์
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างโฟลเดอร์ในไดรฟ์
/**
* Creates a new folder.
*/
function createFolder() {
var folderMetadata = {
'name': 'New Folder',
'mimeType': 'application/vnd.google-apps.folder'
};
var folder = Drive.Files.create(folderMetadata);
Logger.log('Folder ID: ' + folder.id);
}
ค้นหาไฟล์
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีค้นหาไฟล์โดยใช้สตริงคำค้นหา
/**
* Searches for files with a specific name.
*/
function searchFiles() {
var query = 'name contains "Project Plan" and trashed = false';
var files = Drive.Files.list({
'q': query,
'fields': 'files(id, name, mimeType)'
});
if (files.files && files.files.length > 0) {
for (var i = 0; i < files.files.length; i++) {
var file = files.files[i];
Logger.log('%s (ID: %s)', file.name, file.id);
}
} else {
Logger.log('No files found.');
}
}
แสดงรายการโฟลเดอร์
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแสดงรายการโฟลเดอร์ระดับบนสุดในไดรฟ์ของผู้ใช้ โปรดสังเกตการใช้โทเค็นหน้าเพื่อเข้าถึงรายการผลลัพธ์ทั้งหมด
แสดงรายการเวอร์ชันก่อนหน้า
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแสดงรายการเวอร์ชันก่อนหน้าของไฟล์ที่ระบุ โปรดทราบว่าไฟล์บางไฟล์อาจมีเวอร์ชันก่อนหน้าหลายเวอร์ชัน และคุณควรใช้โทเค็นหน้าเพื่อเข้าถึงรายการผลลัพธ์ทั้งหมด
เพิ่มพร็อพเพอร์ตี้ไฟล์
ตัวอย่างโค้ดต่อไปนี้ใช้ช่อง appProperties เพื่อเพิ่มคุณสมบัติที่กำหนดเองลงในไฟล์ สคริปต์เท่านั้นที่จะมองเห็นคุณสมบัติที่กำหนดเอง หากต้องการเพิ่มคุณสมบัติที่กำหนดเองลงในไฟล์ที่แอปอื่นๆ มองเห็นได้ด้วย ให้ใช้ช่อง properties แทน ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ เพิ่มพร็อพเพอร์ตี้ไฟล์ที่กำหนดเอง
เพิ่มผู้ใช้ลงในไฟล์
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเพิ่มผู้ใช้เป็นผู้แก้ไขลงในไฟล์และระงับการแจ้งเตือนทางอีเมล
/**
* Adds a user to a file as an editor without sending an email notification.
*/
function addEditor() {
var fileId = '1234567890abcdefghijklmnopqrstuvwxyz';
var userEmail = 'bob@example.com';
var request = {
'role': 'writer',
'type': 'user',
'emailAddress': userEmail
};
Drive.Permissions.create(request, fileId, {
'sendNotificationEmail': false
});
}