Drive की बेहतर सेवा

Drive की ऐडवांस सेवा की मदद से, Apps Script में Google Drive API का इस्तेमाल किया जा सकता है. Apps Script की Drive की पहले से मौजूद सेवा की तरह ही, इस एपीआई की मदद से स्क्रिप्ट, Google Drive में फ़ाइलें और फ़ोल्डर बना सकती हैं, उन्हें ढूंढ सकती हैं, और उनमें बदलाव कर सकती हैं. ज़्यादातर मामलों में, पहले से मौजूद सेवा का इस्तेमाल करना आसान होता है. हालांकि, यह बेहतर सेवा कुछ अतिरिक्त सुविधाएं देती है. जैसे, फ़ाइल की कस्टम प्रॉपर्टी का ऐक्सेस और फ़ाइलों और फ़ोल्डर में बदलाव करना.

ध्यान दें: यह एक बेहतर सेवा है. इसे इस्तेमाल करने से पहले चालू करना ज़रूरी है.

रेफ़रंस

इस सेवा के बारे में ज़्यादा जानकारी के लिए, Google Drive API का रेफ़रंस दस्तावेज़ देखें. Apps Script की सभी ऐडवांस सेवाओं की तरह, Drive की ऐडवांस सेवा भी उन ऑब्जेक्ट, तरीकों, और पैरामीटर का इस्तेमाल करती है जिनका इस्तेमाल सार्वजनिक एपीआई करता है. ज़्यादा जानकारी के लिए, मेथड सिग्नेचर तय करने का तरीका लेख पढ़ें.

समस्याओं की शिकायत करने और अन्य सहायता पाने के लिए, Drive API की सहायता से जुड़ी गाइड देखें.

नमूना कोड

इस सेक्शन में दिए गए कोड सैंपल, एपीआई के तीसरे वर्शन का इस्तेमाल करते हैं.

फ़ाइलें अपलोड करें

यहां दिए गए कोड सैंपल में, किसी उपयोगकर्ता के Drive में फ़ाइल सेव करने का तरीका बताया गया है.

advanced/drive.gs

GitHub पर देखना

/**
 * 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);
  }
}

फ़ोल्डर की सूची बनाएं

नीचे दिए गए कोड सैंपल में, उपयोगकर्ता के Drive में मौजूद टॉप-लेवल फ़ोल्डर की सूची बनाने का तरीका बताया गया है. नतीजों की पूरी सूची ऐक्सेस करने के लिए, पेज टोकन का इस्तेमाल करने का तरीका जानें.

advanced/drive.gs

GitHub पर देखना

/**
 * 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

GitHub पर देखना

/**
 * 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

GitHub पर देखना

/**
 * 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);
  }
}