উন্নত ড্রাইভ পরিষেবা

কাস্টম প্রোপার্টি এবং রিভিশন সহ ফাইল ও ফোল্ডার পরিচালনা করতে।

অ্যাডভান্সড ড্রাইভ সার্ভিস আপনাকে গুগল অ্যাপস স্ক্রিপ্টে গুগল ড্রাইভ এপিআই ব্যবহার করার সুযোগ দেয়। অ্যাপস স্ক্রিপ্টের বিল্ট-ইন ড্রাইভ সার্ভিসের মতোই, এই এপিআই স্ক্রিপ্টগুলোকে গুগল ড্রাইভে ফাইল ও ফোল্ডার তৈরি করতে, খুঁজে বের করতে এবং পরিবর্তন করতে দেয়। বেশিরভাগ ক্ষেত্রে, বিল্ট-ইন সার্ভিসটি ব্যবহার করা সহজ, কিন্তু এই অ্যাডভান্সড সার্ভিসটি কিছু অতিরিক্ত ফিচার প্রদান করে, যার মধ্যে কাস্টম ফাইল প্রোপার্টি এবং ফাইল ও ফোল্ডারের রিভিশন ব্যবহারের সুবিধাও রয়েছে।

এটি একটি উন্নত পরিষেবা যা ব্যবহারের আগে সক্রিয় করতে হবে।

রেফারেন্স

এই পরিষেবা সম্পর্কে বিস্তারিত তথ্যের জন্য, Drive API-এর রেফারেন্স ডকুমেন্টেশন দেখুন। Apps Script-এর সমস্ত অ্যাডভান্সড পরিষেবার মতো, অ্যাডভান্সড Drive পরিষেবাটিও পাবলিক API-এর মতোই একই অবজেক্ট, মেথড এবং প্যারামিটার ব্যবহার করে। আরও তথ্যের জন্য, "How method signatures are determined" দেখুন। এছাড়াও, Drive API-তে delete নামের মেথডগুলোকে অ্যাডভান্সড পরিষেবাতে remove বলা হয় (যেমন Drive.Permissions.remove() ), কারণ জাভাস্ক্রিপ্টে delete একটি সংরক্ষিত শব্দ।

সমস্যা জানাতে এবং অন্যান্য সহায়তা পেতে, ড্রাইভ এপিআই সাপোর্ট গাইড দেখুন।

নমুনা কোড

এই বিভাগের কোড নমুনাগুলিতে API-এর সংস্করণ ৩ ব্যবহার করা হয়েছে।

ফাইল আপলোড করুন

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একজন ব্যবহারকারীর ড্রাইভে একটি ফাইল সংরক্ষণ করতে হয়।

অ্যাডভান্সড/ড্রাইভ.জিএস
/**
 * 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);
  }
}

একটি ফোল্ডার তৈরি করুন

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে ড্রাইভে একটি ফোল্ডার তৈরি করতে হয়।

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

ফোল্ডারগুলির তালিকা

নিম্নলিখিত কোড নমুনাটি ব্যবহারকারীর ড্রাইভের শীর্ষ-স্তরের ফোল্ডারগুলো তালিকাভুক্ত করার পদ্ধতি প্রদর্শন করে। ফলাফলের সম্পূর্ণ তালিকা অ্যাক্সেস করার জন্য পেজ টোকেনের ব্যবহার লক্ষ্য করুন।

অ্যাডভান্সড/ড্রাইভ.জিএস
/**
 * 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);
}

তালিকা সংশোধন

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি নির্দিষ্ট ফাইলের রিভিশনগুলো তালিকাভুক্ত করতে হয়। উল্লেখ্য যে, কিছু ফাইলের একাধিক রিভিশন থাকতে পারে এবং ফলাফলের সম্পূর্ণ তালিকা অ্যাক্সেস করার জন্য আপনার পেজ টোকেন ব্যবহার করা উচিত।

অ্যাডভান্সড/ড্রাইভ.জিএস
/**
 * Lists the revisions of a given file.
 * @param {string} fileId The ID of the file to list revisions for.
 */
function listRevisions(fileId) {
  let revisions;
  let 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 ফিল্ডটি ব্যবহার করুন। আরও তথ্যের জন্য, “Add custom file properties ” দেখুন।

অ্যাডভান্সড/ড্রাইভ.জিএস
/**
 * 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);
  }
}

একটি ফাইলে একজন ব্যবহারকারীকে যুক্ত করুন

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একজন ব্যবহারকারীকে একটি ফাইলের সম্পাদক হিসেবে যুক্ত করতে হয় এবং ইমেল বিজ্ঞপ্তিটি বন্ধ রাখতে হয়।

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