Google Forms থেকে Google Drive-এ ফাইল আপলোড করুন

কোডিং স্তর : শিক্ষানবিস
সময়কাল : ১০ মিনিট
প্রকল্পের ধরণ : ইভেন্ট-চালিত ট্রিগার সহ অটোমেশন

উদ্দেশ্য

এই নমুনাটি সম্পন্ন করার পর, আপনি নিম্নলিখিত কাজগুলো করতে সক্ষম হবেন:

• সমাধানটি কী কাজ করে তা বুঝুন।
• সলিউশনের মধ্যে অ্যাপস স্ক্রিপ্ট সার্ভিসগুলো কী কাজ করে তা বুঝুন।
• স্ক্রিপ্টটি সেট আপ করুন।
• স্ক্রিপ্টটি চালান।

এই সমাধান সম্পর্কে

ফর্ম ব্যবহার করে ড্রাইভে একই সাথে ফাইল আপলোড এবং গোছান। ফর্মটিতে কোন ফাইলগুলো আপলোড করতে হবে এবং ফাইলগুলো কীভাবে গোছানো হবে, তার জন্য ইনপুট দেওয়ার ব্যবস্থা রয়েছে।

এটি কীভাবে কাজ করে

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

অ্যাপস স্ক্রিপ্ট পরিষেবা

এই সমাধানটি নিম্নলিখিত পরিষেবাগুলি ব্যবহার করে:

• স্ক্রিপ্ট সার্ভিস – এটি এমন একটি ট্রিগার তৈরি করে যা প্রতিবার কেউ ফর্ম জমা দিলে চালু হয়।
• প্রোপার্টিজ সার্ভিস – সেটআপের সময় স্ক্রিপ্ট দ্বারা তৈরি ট্রিগারের আইডি সংরক্ষণ করে, যাতে ডুপ্লিকেট ট্রিগার তৈরি না হয়।
• ড্রাইভ সার্ভিস – সেটআপের সময়, এটি ড্রাইভে ফর্মটির অবস্থান খুঁজে নেয় এবং সেই একই স্থানে একটি ফোল্ডার তৈরি করে। যখন কোনো ব্যবহারকারী ফর্মটি জমা দেন, তখন ড্রাইভ সার্ভিস ফাইলগুলোকে সেই ফোল্ডারে এবং নির্বাচিত হলে একটি নির্দিষ্ট সাবফোল্ডারে পাঠিয়ে দেয়। যদি সাবফোল্ডারটি আগে থেকে না থাকে, তবে স্ক্রিপ্টটি সেটি তৈরি করে নেয়।
• ফর্মস সার্ভিস – ব্যবহারকারী ফর্ম জমা দেওয়ার পর তার নির্বাচিত ফাইল ও ফোল্ডারের নাম সংগ্রহ করে ড্রাইভ সার্ভিসে পাঠিয়ে দেয়।

পূর্বশর্ত

এই নমুনাটি ব্যবহার করার জন্য আপনার নিম্নলিখিত পূর্বশর্তগুলো প্রয়োজন:

• একটি গুগল অ্যাকাউন্ট (গুগল ওয়ার্কস্পেস অ্যাকাউন্টের জন্য প্রশাসকের অনুমোদনের প্রয়োজন হতে পারে)।
• ইন্টারনেট সংযোগসহ একটি ওয়েব ব্রাউজার।

স্ক্রিপ্টটি সেট আপ করুন

ফর্মটি তৈরি করুন

1. forms.google.com- এ যান এবং ‘Blank ক্লিক করুন।
2. ‘Untitled form’-এ ক্লিক করুন এবং ফর্মটির নাম পরিবর্তন করে ‘Upload files to Drive’ রাখুন।
3. Untitled question-এ ক্লিক করুন এবং প্রশ্নটির নাম পরিবর্তন করে Subfolder রাখুন।
4. সাবফোল্ডার সংক্রান্ত প্রশ্নে, > বিবরণ-এ ক্লিক করুন।
5. বিবরণের জন্য, আপনার ফাইলগুলি সংরক্ষণ করার জন্য সাবফোল্ডারটি নির্বাচন করুন। আপনি যদি <কোনোটিই নয়> নির্বাচন করেন, তাহলে ফাইলগুলি আপলোড করা ফাইল ফোল্ডারে সংরক্ষিত হবে।
6. সাবফোল্ডার প্রশ্নে নিম্নলিখিত বিকল্পগুলি যোগ করুন:
   • <কিছুই না>
   • প্রকল্প এ
   • প্রকল্প বি
   • প্রকল্প সি
7. প্রশ্নটিকে আবশ্যক করতে, Required-এ ক্লিক করুন।
8. প্রশ্ন যোগ করুন ক্লিক করুন।
9. মাল্টিপল চয়েস-এ ক্লিক করুন এবং ফাইল আপলোড নির্বাচন করুন।
10. চালিয়ে যান-এ ক্লিক করুন।
11. প্রশ্ন অংশে, আপলোড করার জন্য ফাইলগুলো লিখুন। আপনি ফাইলের ধরন এবং সর্বোচ্চ যতগুলো ফাইল আপলোড করার অনুমতি দিতে চান, তা বেছে নিতে পারেন।
12. প্রশ্নটিকে আবশ্যক করতে, ‘Required’-এ ক্লিক করুন।

অ্যাপস স্ক্রিপ্ট প্রজেক্টটি তৈরি করুন

1. ফর্মটি থেকে, > স্ক্রিপ্ট সম্পাদক-এ ক্লিক করুন।
2. ‘Untitled project’-এ ক্লিক করুন এবং প্রজেক্টটির নাম পরিবর্তন করে ‘Upload files to Drive’ রাখুন।
3. আরেকটি স্ক্রিপ্ট ফাইল তৈরি করতে, a file > Script-এ ক্লিক করুন। ফাইলটির নাম দিন Setup ।

4. উভয় স্ক্রিপ্ট ফাইলের বিষয়বস্তু নিম্নলিখিত বিষয়বস্তু দিয়ে প্রতিস্থাপন করুন:

   কোড.জিএস

   solutions/automations/upload-files/Code.js

   গিটহাবে দেখুন

   // TODO Before you start using this sample, you must run the setUp()
   // function in the Setup.gs file.
   
   // Application constants
   const APP_TITLE = "Upload files to Drive from Forms";
   const APP_FOLDER_NAME = "Upload files to Drive (File responses)";
   
   // Identifies the subfolder form item
   const APP_SUBFOLDER_ITEM = "Subfolder";
   const APP_SUBFOLDER_NONE = "<None>";
   
   /**
    * Gets the file uploads from a form response and moves files to the corresponding subfolder.
    *
    * @param {object} event - Form submit.
    */
   function onFormSubmit(e) {
     try {
       // Gets the application root folder.
       let destFolder = getFolder_(APP_FOLDER_NAME);
   
       // Gets all form responses.
       const itemResponses = e.response.getItemResponses();
   
       // Determines the subfolder to route the file to, if any.
       let subFolderName;
       const dest = itemResponses.filter(
         (itemResponse) =>
           itemResponse.getItem().getTitle().toString() === APP_SUBFOLDER_ITEM,
       );
   
       // Gets the destination subfolder name, but ignores if APP_SUBFOLDER_NONE was selected;
       if (dest.length > 0) {
         if (dest[0].getResponse() !== APP_SUBFOLDER_NONE) {
           subFolderName = dest[0].getResponse();
         }
       }
       // Gets the subfolder or creates it if it doesn't exist.
       if (subFolderName !== undefined) {
         destFolder = getSubFolder_(destFolder, subFolderName);
       }
       console.log(`Destination folder to use:
       Name: ${destFolder.getName()}
       ID: ${destFolder.getId()}
       URL: ${destFolder.getUrl()}`);
   
       // Gets the file upload response as an array to allow for multiple files.
       const fileUploads = itemResponses
         .filter(
           (itemResponse) =>
             itemResponse.getItem().getType().toString() === "FILE_UPLOAD",
         )
         .map((itemResponse) => itemResponse.getResponse())
         .reduce((a, b) => a.concat(b), []);
   
       // Moves the files to the destination folder.
       if (fileUploads.length > 0) {
         for (const fileId of fileUploads) {
           DriveApp.getFileById(fileId).moveTo(destFolder);
           console.log(`File Copied: ${fileId}`);
         }
       }
     } catch (err) {
       console.log(err);
     }
   }
   
   /**
    * Returns a Drive folder under the passed in objParentFolder parent
    * folder. Checks if folder of same name exists before creating, returning
    * the existing folder or the newly created one if not found.
    *
    * @param {object} objParentFolder - Drive folder as an object.
    * @param {string} subFolderName - Name of subfolder to create/return.
    * @return {object} Drive folder
    */
   function getSubFolder_(objParentFolder, subFolderName) {
     // Iterates subfolders of parent folder to check if folder already exists.
     const subFolders = objParentFolder.getFolders();
     while (subFolders.hasNext()) {
       const folder = subFolders.next();
   
       // Returns the existing folder if found.
       if (folder.getName() === subFolderName) {
         return folder;
       }
     }
     // Creates a new folder if one doesn't already exist.
     return objParentFolder
       .createFolder(subFolderName)
       .setDescription(
         `Created by ${APP_TITLE} application to store uploaded Forms files.`,
       );
   }

   সেটআপ.জিএস

   solutions/automations/upload-files/Setup.js

   গিটহাবে দেখুন

   // TODO You must run the setUp() function before you start using this sample.
   
   /**
    * The setUp() function performs the following:
    *  - Creates a Google Drive folder named by the APP_FOLDER_NAME
    *    variable in the Code.gs file.
    *  - Creates a trigger to handle onFormSubmit events.
    */
   function setUp() {
     // Ensures the root destination folder exists.
     const appFolder = getFolder_(APP_FOLDER_NAME);
     if (appFolder !== null) {
       console.log(`Application folder setup.
       Name: ${appFolder.getName()}
       ID: ${appFolder.getId()}
       URL: ${appFolder.getUrl()}`);
     } else {
       console.log("Could not setup application folder.");
     }
     // Calls the function that creates the Forms onSubmit trigger.
     installTrigger_();
   }
   
   /**
    * Returns a folder to store uploaded files in the same location
    * in Drive where the form is located. First, it checks if the folder
    * already exists, and creates it if it doesn't.
    *
    * @param {string} folderName - Name of the Drive folder.
    * @return {object} Google Drive Folder
    */
   function getFolder_(folderName) {
     // Gets the Drive folder where the form is located.
     const ssId = FormApp.getActiveForm().getId();
     const parentFolder = DriveApp.getFileById(ssId).getParents().next();
   
     // Iterates through the subfolders to check if folder already exists.
     // The script checks for the folder name specified in the APP_FOLDER_NAME variable.
     const subFolders = parentFolder.getFolders();
     while (subFolders.hasNext()) {
       const folder = subFolders.next();
   
       // Returns the existing folder if found.
       if (folder.getName() === folderName) {
         return folder;
       }
     }
     // Creates a new folder if one doesn't already exist.
     return parentFolder
       .createFolder(folderName)
       .setDescription(
         `Created by ${APP_TITLE} application to store uploaded files.`,
       );
   }
   
   /**
    * Installs trigger to capture onFormSubmit event when a form is submitted.
    * Ensures that the trigger is only installed once.
    * Called by setup().
    */
   function installTrigger_() {
     // Ensures existing trigger doesn't already exist.
     const propTriggerId =
       PropertiesService.getScriptProperties().getProperty("triggerUniqueId");
     if (propTriggerId !== null) {
       const triggers = ScriptApp.getProjectTriggers();
       for (const t in triggers) {
         if (triggers[t].getUniqueId() === propTriggerId) {
           console.log(
             `Trigger with the following unique ID already exists: ${propTriggerId}`,
           );
           return;
         }
       }
     }
     // Creates the trigger if one doesn't exist.
     const triggerUniqueId = ScriptApp.newTrigger("onFormSubmit")
       .forForm(FormApp.getActiveForm())
       .onFormSubmit()
       .create()
       .getUniqueId();
     PropertiesService.getScriptProperties().setProperty(
       "triggerUniqueId",
       triggerUniqueId,
     );
     console.log(
       `Trigger with the following unique ID was created: ${triggerUniqueId}`,
     );
   }
   
   /**
    * Removes all script properties and triggers for the project.
    * Use primarily to test setup routines.
    */
   function removeTriggersAndScriptProperties() {
     PropertiesService.getScriptProperties().deleteAllProperties();
     // Removes all triggers associated with project.
     const triggers = ScriptApp.getProjectTriggers();
     for (const t in triggers) {
       ScriptApp.deleteTrigger(triggers[t]);
     }
   }
   
   /**
    * Removes all form responses to reset the form.
    */
   function deleteAllResponses() {
     FormApp.getActiveForm().deleteAllResponses();
   }

স্ক্রিপ্টটি চালান

1. অ্যাপস স্ক্রিপ্ট এডিটরে, Setup.gs ফাইলটিতে যান।
2. ফাংশন ড্রপডাউন থেকে setUp ) নির্বাচন করুন।
3. রান-এ ক্লিক করুন।
4. অনুরোধ করা হলে, স্ক্রিপ্টটিকে অনুমোদন দিন। <<../_snippets/oauth.md>>
5. ফর্মে ফিরে যান এবং প্রিভিউ-তে ক্লিক করুন। .
6. ফর্মে একটি সাবফোল্ডার নির্বাচন করুন এবং একটি ফাইল আপলোড করুন।
7. সাবমিট-এ ক্লিক করুন।
8. ড্রাইভে যান এবং 'Upload files to Drive (File responses)' ফোল্ডারটি খুলুন। আপনার আপলোড করা ফাইলগুলো ফর্মে আপনার নির্বাচিত সাবফোল্ডারটিতে রয়েছে।

অবদানকারীরা

এই নমুনাটি গুগল ডেভেলপার বিশেষজ্ঞদের সহায়তায় গুগল দ্বারা রক্ষণাবেক্ষণ করা হয়।

পরবর্তী পদক্ষেপ

• ইভেন্ট-চালিত ট্রিগার
• ফর্ম পরিষেবা রেফারেন্স