บริการไดรฟ์ขั้นสูง

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

ข้อมูลอ้างอิง

สำหรับข้อมูลโดยละเอียดเกี่ยวกับบริการนี้ โปรดดูที่ข้อมูลอ้างอิง เอกสารประกอบสำหรับ Google Drive API ชอบทั้งหมด บริการขั้นสูงใน Apps Script บริการไดรฟ์ใช้ออบเจ็กต์ เมธอด และพารามิเตอร์เดียวกันกับ API สาธารณะ สำหรับข้อมูลเพิ่มเติม โปรดดูวิธีของลายเซ็นเมธอด กำหนดไว้

หากต้องการรายงานปัญหาและค้นหาการสนับสนุนอื่นๆ โปรดดูการสนับสนุน Drive API

โค้ดตัวอย่าง

ตัวอย่างโค้ดในส่วนนี้ใช้เวอร์ชัน 3 ของ API ได้

อัปโหลดไฟล์

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีบันทึกไฟล์ไปยัง ไดรฟ์

advanced/drive.gs
/**
 * Uploads a new file to the user's Drive.
 */
function uploadFile() {
  try {
    // Makes a request to fetch a URL.
    const image = UrlFetchApp.fetch('http://goo.gl/nd7zjB').getBlob();
    let file = {
      name: 'google_logo.png',
      mimeType: 'image/png'
    };
    // Create a file in the user's Drive.
    file = Drive.Files.create(file, image, {'fields': 'id,size'});
    console.log('ID: %s, File size (bytes): %s', file.id, file.size);
  } catch (err) {
    // TODO (developer) - Handle exception
    console.log('Failed to upload file with error %s', err.message);
  }
}

แสดงรายการโฟลเดอร์

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

advanced/drive.gs
/**
 * Lists the top-level folders in the user's Drive.
 */
function listRootFolders() {
  const query = '"root" in parents and trashed = false and ' +
    'mimeType = "application/vnd.google-apps.folder"';
  let folders;
  let pageToken = null;
  do {
    try {
      folders = Drive.Files.list({
        q: query,
        pageSize: 100,
        pageToken: pageToken
      });
      if (!folders.files || folders.files.length === 0) {
        console.log('All folders found.');
        return;
      }
      for (let i = 0; i < folders.files.length; i++) {
        const folder = folders.files[i];
        console.log('%s (ID: %s)', folder.name, folder.id);
      }
      pageToken = folders.nextPageToken;
    } catch (err) {
      // TODO (developer) - Handle exception
      console.log('Failed with error %s', err.message);
    }
  } while (pageToken);
}

แสดงรายการการแก้ไข

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

advanced/drive.gs
/**
 * Lists the revisions of a given file.
 * @param {string} fileId The ID of the file to list revisions for.
 */
function listRevisions(fileId) {
  let revisions;
  const pageToken = null;
  do {
    try {
      revisions = Drive.Revisions.list(
          fileId,
          {'fields': 'revisions(modifiedTime,size),nextPageToken'});
      if (!revisions.revisions || revisions.revisions.length === 0) {
        console.log('All revisions found.');
        return;
      }
      for (let i = 0; i < revisions.revisions.length; i++) {
        const revision = revisions.revisions[i];
        const date = new Date(revision.modifiedTime);
        console.log('Date: %s, File size (bytes): %s', date.toLocaleString(),
            revision.size);
      }
      pageToken = revisions.nextPageToken;
    } catch (err) {
      // TODO (developer) - Handle exception
      console.log('Failed with error %s', err.message);
    }
  } while (pageToken);
}

เพิ่มคุณสมบัติของไฟล์

ตัวอย่างโค้ดต่อไปนี้ใช้ช่อง appProperties เพื่อเพิ่ม ลงในไฟล์ มีเพียงสคริปต์เท่านั้นที่เห็นคุณสมบัติที่กำหนดเอง หากต้องการเพิ่ม คุณสมบัติที่กำหนดเองไปยังไฟล์ที่ปรากฏต่อแอปอื่นๆ ด้วย ให้ใช้ properties แทน ดูข้อมูลเพิ่มเติมได้ที่เพิ่มไฟล์ที่กำหนดเอง พร็อพเพอร์ตี้

advanced/drive.gs
/**
 * Adds a custom app property to a file. Unlike Apps Script's DocumentProperties,
 * Drive's custom file properties can be accessed outside of Apps Script and
 * by other applications; however, appProperties are only visible to the script.
 * @param {string} fileId The ID of the file to add the app property to.
 */
function addAppProperty(fileId) {
  try {
    let file = {
      'appProperties': {
        'department': 'Sales'
      }
    };
    // Updates a file to add an app property.
    file = Drive.Files.update(file, fileId, null, {'fields': 'id,appProperties'});
    console.log(
        'ID: %s, appProperties: %s',
        file.id,
        JSON.stringify(file.appProperties, null, 2));
  } catch (err) {
    // TODO (developer) - Handle exception
    console.log('Failed with error %s', err.message);
  }
}