Class DriveApp

ড্রাইভঅ্যাপ

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

// Logs the name of every file in the user's Drive.
const files = DriveApp.getFiles();
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getName());
}

বৈশিষ্ট্য

সম্পত্তি প্রকার বর্ণনা
Access Access একটি এনাম (enum), যা এমন ব্যবহারকারীদের শ্রেণীকে প্রতিনিধিত্ব করে যারা কোনো ফাইল বা ফোল্ডার অ্যাক্সেস করতে পারে, এছাড়াও সেইসব স্বতন্ত্র ব্যবহারকারীও এর অন্তর্ভুক্ত যাদেরকে স্পষ্টভাবে অ্যাক্সেস দেওয়া হয়েছে।
Permission Permission একটি এনাম (enum), যা সেইসব ব্যবহারকারীদের প্রদত্ত অনুমতিসমূহকে উপস্থাপন করে, যারা কোনো ফাইল বা ফোল্ডার অ্যাক্সেস করতে পারে; এর বাইরে এমন কোনো স্বতন্ত্র ব্যবহারকারীও অন্তর্ভুক্ত নয়, যাদেরকে স্পষ্টভাবে অ্যাক্সেস দেওয়া হয়েছে।

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
continue File Iterator(continuationToken) File Iterator পূর্ববর্তী ইটারেটর থেকে একটি কন্টিনিউয়েশন টোকেন ব্যবহার করে ফাইল ইটারেশন পুনরায় শুরু করে।
continue Folder Iterator(continuationToken) Folder Iterator পূর্ববর্তী ইটারেটর থেকে একটি কন্টিনিউয়েশন টোকেন ব্যবহার করে ফোল্ডার ইটারেশন পুনরায় শুরু করে।
create File(blob) File প্রদত্ত যেকোনো ডেটার Blob থেকে ব্যবহারকারীর ড্রাইভের রুটে একটি ফাইল তৈরি করে।
create File(name, content) File ব্যবহারকারীর ড্রাইভের রুটে প্রদত্ত নাম ও বিষয়বস্তুসহ একটি টেক্সট ফাইল তৈরি করে।
create File(name, content, mimeType) File ব্যবহারকারীর ড্রাইভের রুটে প্রদত্ত নাম, বিষয়বস্তু এবং MIME টাইপ অনুযায়ী একটি ফাইল তৈরি করে।
create Folder(name) Folder ব্যবহারকারীর ড্রাইভের রুটে প্রদত্ত নামে একটি ফোল্ডার তৈরি করে।
create Shortcut(targetId) File প্রদত্ত ড্রাইভ আইটেম আইডিতে একটি শর্টকাট তৈরি করে এবং সেটি ফেরত দেয়।
create Shortcut For Target Id And Resource Key(targetId, targetResourceKey) File প্রদত্ত ড্রাইভ আইটেম আইডি এবং রিসোর্স কী-তে একটি শর্টকাট তৈরি করে এবং সেটি ফেরত দেয়।
enforce Single Parent(value) void আইটেমের প্যারেন্টদের প্রভাবিত করে এমন সমস্ত কলের জন্য enforceSingleParent আচরণ সক্ষম বা অক্ষম করে।
get File By Id(id) File প্রদত্ত আইডি সহ ফাইলটি পাওয়া যায়।
get File By Id And Resource Key(id, resourceKey) File প্রদত্ত আইডি এবং রিসোর্স কী ব্যবহার করে ফাইলটি খুঁজে বের করে।
get Files() File Iterator ব্যবহারকারীর ড্রাইভে থাকা সমস্ত ফাইলের একটি সংগ্রহ পাওয়া যায়।
get Files By Name(name) File Iterator ব্যবহারকারীর ড্রাইভে থাকা প্রদত্ত নামের সমস্ত ফাইল সংগ্রহ করে।
get Files By Type(mimeType) File Iterator ব্যবহারকারীর ড্রাইভে থাকা প্রদত্ত MIME টাইপের সমস্ত ফাইলের একটি সংগ্রহ নিয়ে আসে।
get Folder By Id(id) Folder প্রদত্ত আইডি সহ ফোল্ডারটি খুঁজে বের করে।
get Folder By Id And Resource Key(id, resourceKey) Folder প্রদত্ত আইডি এবং রিসোর্স কী ব্যবহার করে ফোল্ডারটি খুঁজে বের করে।
get Folders() Folder Iterator ব্যবহারকারীর ড্রাইভে থাকা সমস্ত ফোল্ডারের একটি সংগ্রহ পাওয়া যায়।
get Folders By Name(name) Folder Iterator ব্যবহারকারীর ড্রাইভে থাকা প্রদত্ত নামের সমস্ত ফোল্ডারের একটি সংগ্রহ নিয়ে আসে।
get Root Folder() Folder ব্যবহারকারীর ড্রাইভের রুটে থাকা ফোল্ডারটি খুঁজে বের করে।
get Storage Limit() Integer ব্যবহারকারীকে ড্রাইভে কত বাইট ডেটা সংরক্ষণ করার অনুমতি দেওয়া হয়েছে, তা জানা যায়।
get Storage Used() Integer ব্যবহারকারী বর্তমানে ড্রাইভে কত বাইট ডেটা সংরক্ষণ করছেন, তা জানা যায়।
get Trashed Files() File Iterator ব্যবহারকারীর ড্রাইভের ট্র্যাশে থাকা সমস্ত ফাইলের একটি সংগ্রহ নিয়ে আসে।
get Trashed Folders() Folder Iterator ব্যবহারকারীর ড্রাইভের ট্র্যাশে থাকা সমস্ত ফোল্ডারের একটি সংগ্রহ নিয়ে আসে।
search Files(params) File Iterator ব্যবহারকারীর ড্রাইভে থাকা সেই সমস্ত ফাইলের একটি সংগ্রহ এনে দেয়, যেগুলো প্রদত্ত অনুসন্ধানের শর্তাবলীর সাথে মেলে।
search Folders(params) Folder Iterator ব্যবহারকারীর ড্রাইভে থাকা সেই সমস্ত ফোল্ডারের একটি সংগ্রহ এনে দেয়, যেগুলো প্রদত্ত অনুসন্ধানের শর্তাবলীর সাথে মেলে।

বিস্তারিত ডকুমেন্টেশন

continueFileIterator(continuationToken)

পূর্ববর্তী ইটারেটর থেকে একটি কন্টিনিউয়েশন টোকেন ব্যবহার করে ফাইল ইটারেশন পুনরায় শুরু করে। যদি একটি ইটারেটর একবারে প্রসেস করতে গিয়ে সর্বোচ্চ এক্সিকিউশন টাইম অতিক্রম করে, তবে এই পদ্ধতিটি কার্যকর। কন্টিনিউয়েশন টোকেনগুলো সাধারণত এক সপ্তাহের জন্য বৈধ থাকে।

// Continues getting a list of all 'Untitled document' files in the user's
// Drive. Creates a file iterator named 'previousIterator'.
const previousIterator = DriveApp.getFilesByName('Untitled document');

// Gets continuation token from the previous file iterator.
const continuationToken = previousIterator.getContinuationToken();

// Creates a new iterator using the continuation token from the previous file
// iterator.
const newIterator = DriveApp.continueFileIterator(continuationToken);

// Resumes the file iteration using a continuation token from 'firstIterator'
// and logs the file name.
if (newIterator.hasNext()) {
  const file = newIterator.next();
  console.log(file.getName());
}

প্যারামিটার

নাম প্রকার বর্ণনা
continuation Token String পূর্ববর্তী ফাইল ইটারেটর থেকে প্রাপ্ত একটি কন্টিনিউয়েশন টোকেন।

ফেরত

FileIterator — পূর্ববর্তী ইটারেটরে থাকা ফাইলগুলোর একটি সংগ্রহ, যা কন্টিনিউয়েশন টোকেনটি তৈরি করার সময় অবশিষ্ট ছিল।

continueFolderIterator(continuationToken)

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

// Continues getting a list of all folders in user's Drive.
// Creates a folder iterator named 'previousIterator'.
const previousIterator = DriveApp.getFolders();

// Gets continuation token from the previous folder iterator.
const continuationToken = previousIterator.getContinuationToken();

// Creates a new iterator using the continuation token from the previous folder
// iterator.
const newIterator = DriveApp.continueFolderIterator(continuationToken);

// Resumes the folder iteration using a continuation token from the previous
// iterator and logs the folder name.
if (newIterator.hasNext()) {
  const folder = newIterator.next();
  console.log(folder.getName());
}

প্যারামিটার

নাম প্রকার বর্ণনা
continuation Token String পূর্ববর্তী ফোল্ডার ইটারেটর থেকে প্রাপ্ত একটি কন্টিনিউয়েশন টোকেন।

ফেরত

FolderIterator — ফোল্ডারগুলোর একটি সংগ্রহ যা কন্টিনিউয়েশন টোকেন তৈরি করার সময় পূর্ববর্তী ইটারেটরে রয়ে গিয়েছিল।

createFile(blob)

প্রদত্ত যেকোনো ডেটার Blob থেকে ব্যবহারকারীর ড্রাইভের রুটে একটি ফাইল তৈরি করে।

প্যারামিটার

নাম প্রকার বর্ণনা
blob Blob Source নতুন ফাইলের ডেটা।

ফেরত

File — নতুন ফাইলটি।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive

createFile(name, content)

ব্যবহারকারীর ড্রাইভের রুটে প্রদত্ত নাম ও বিষয়বস্তু সহ একটি টেক্সট ফাইল তৈরি করে। content ৫০ মেগাবাইটের বেশি হলে একটি ব্যতিক্রমী ত্রুটি (exception) দেখায়।

// Create a text file with the content "Hello, world!"
DriveApp.createFile('New Text File', 'Hello, world!');

প্যারামিটার

নাম প্রকার বর্ণনা
name String নতুন ফাইলটির নাম।
content String নতুন ফাইলের বিষয়বস্তু।

ফেরত

File — নতুন ফাইলটি।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive

createFile(name, content, mimeType)

ব্যবহারকারীর ড্রাইভের রুটে প্রদত্ত নাম, বিষয়বস্তু এবং MIME টাইপ অনুযায়ী একটি ফাইল তৈরি করে। content আকার ১০ মেগাবাইটের বেশি হলে একটি ব্যতিক্রমী ত্রুটি (exception) প্রদর্শন করে।

// Create an HTML file with the content "Hello, world!"
DriveApp.createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);

প্যারামিটার

নাম প্রকার বর্ণনা
name String নতুন ফাইলটির নাম।
content String নতুন ফাইলের বিষয়বস্তু।
mime Type String নতুন ফাইলটির MIME টাইপ।

ফেরত

File — নতুন ফাইলটি।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive

createFolder(name)

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

প্যারামিটার

নাম প্রকার বর্ণনা
name String নতুন ফোল্ডারটির নাম।

ফেরত

Folder — নতুন ফোল্ডারটি।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive

createShortcut(targetId)

প্রদত্ত ড্রাইভ আইটেম আইডিতে একটি শর্টকাট তৈরি করে এবং সেটি ফেরত দেয়।

প্যারামিটার

নাম প্রকার বর্ণনা
target Id String লক্ষ্য ফাইল বা ফোল্ডারের ফাইল আইডি।

ফেরত

File — নতুন শর্টকাট।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

প্রদত্ত ড্রাইভ আইটেম আইডি এবং রিসোর্স কী-এর একটি শর্টকাট তৈরি করে এবং সেটি ফেরত দেয়। রিসোর্স কী হলো একটি অতিরিক্ত প্যারামিটার, যা লিঙ্কের মাধ্যমে শেয়ার করা নির্দিষ্ট ফাইল বা ফোল্ডার অ্যাক্সেস করার জন্য পাস করতে হয়।

// Creates shortcuts for all folders in the user's drive that have a specific
// name.
// TODO(developer): Replace 'Test-Folder' with a valid folder name in your
// drive.
const folders = DriveApp.getFoldersByName('Test-Folder');

// Iterates through all folders named 'Test-Folder'.
while (folders.hasNext()) {
  const folder = folders.next();

  // Creates a shortcut to the provided Drive item ID and resource key, and
  // returns it.
  DriveApp.createShortcutForTargetIdAndResourceKey(
      folder.getId(),
      folder.getResourceKey(),
  );
}

প্যারামিটার

নাম প্রকার বর্ণনা
target Id String লক্ষ্য ফাইল বা ফোল্ডারের আইডি।
target Resource Key String লক্ষ্য ফাইল বা ফোল্ডারের রিসোর্স কী।

ফেরত

File — নতুন শর্টকাট।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive

enforceSingleParent(value)

আইটেমের প্যারেন্টদের প্রভাবিত করে এমন সমস্ত কলের জন্য enforceSingleParent আচরণ সক্ষম বা অক্ষম করে।

আরও বিস্তারিত জানতে “Simplifying Google Drive's folder structure and sharing models” ব্লগটি দেখুন।

// Enables enforceSingleParent behavior for all calls affecting item parents.
DriveApp.enforceSingleParent(true);

প্যারামিটার

নাম প্রকার বর্ণনা
value Boolean enforceSingleParent ফ্ল্যাগটির নতুন অবস্থা।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive

getFileById(id)

প্রদত্ত আইডি সহ ফাইলটি খুঁজে বের করে। ফাইলটি বিদ্যমান না থাকলে বা ব্যবহারকারীর এটি অ্যাক্সেস করার অনুমতি না থাকলে একটি স্ক্রিপ্টিং ব্যতিক্রম (scripting exception) প্রদর্শন করে।

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace 'Test' with your file name.
const files = DriveApp.getFilesByName('Test');

if (files.hasNext()) {
  // Gets the ID of each file in the list.
  const fileId = files.next().getId();

  // Gets the file name using its ID and logs it to the console.
  console.log(DriveApp.getFileById(fileId).getName());
}

প্যারামিটার

নাম প্রকার বর্ণনা
id String ফাইলটির আইডি।

ফেরত

File — প্রদত্ত আইডিযুক্ত ফাইল।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFileByIdAndResourceKey(id, resourceKey)

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

ফাইলটি বিদ্যমান না থাকলে অথবা ব্যবহারকারীর এটি অ্যাক্সেস করার অনুমতি না থাকলে একটি স্ক্রিপ্টিং ব্যতিক্রম (scripting exception) দেখানো হয়।

// Gets a list of all files in Drive with the given name.
// TODO(developer): Replace 'Test' with your file name.
const files = DriveApp.getFilesByName('Test');
if (files.hasNext()) {
  // Gets the first file in the list.
  const file = files.next();

  // Gets the ID and resource key.
  const key = file.getResourceKey();
  const id = file.getId();

  // Logs the file name to the console using its ID and resource key.
  console.log(DriveApp.getFileByIdAndResourceKey(id, key).getName());
}

প্যারামিটার

নাম প্রকার বর্ণনা
id String ফাইলটির আইডি।
resource Key String ফোল্ডারটির রিসোর্স কী।

ফেরত

File — প্রদত্ত আইডিযুক্ত ফাইল।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFiles()

ব্যবহারকারীর ড্রাইভে থাকা সমস্ত ফাইলের একটি সংগ্রহ পাওয়া যায়।

ফেরত

FileIterator — ব্যবহারকারীর ড্রাইভে থাকা সমস্ত ফাইলের একটি সংগ্রহ।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFilesByName(name)

ব্যবহারকারীর ড্রাইভে থাকা প্রদত্ত নামের সমস্ত ফাইল সংগ্রহ করে।

প্যারামিটার

নাম প্রকার বর্ণনা
name String যে ফাইলগুলো খুঁজতে হবে, সেগুলোর নাম।

ফেরত

FileIterator — ব্যবহারকারীর ড্রাইভে থাকা প্রদত্ত নামের সমস্ত ফাইলের একটি সংগ্রহ।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFilesByType(mimeType)

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

প্যারামিটার

নাম প্রকার বর্ণনা
mime Type String যে ফাইলগুলো খুঁজতে হবে সেগুলোর MIME টাইপ।

ফেরত

FileIterator — ব্যবহারকারীর ড্রাইভে থাকা প্রদত্ত MIME টাইপের সমস্ত ফাইলের একটি সংগ্রহ।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFolderById(id)

প্রদত্ত আইডি সহ ফোল্ডারটি খুঁজে বের করে। যদি ফোল্ডারটি বিদ্যমান না থাকে অথবা ব্যবহারকারীর এটি অ্যাক্সেস করার অনুমতি না থাকে, তবে একটি স্ক্রিপ্টিং ব্যতিক্রম (scripting exception) প্রদর্শন করে।

প্যারামিটার

নাম প্রকার বর্ণনা
id String ফোল্ডারটির আইডি।

ফেরত

Folder — প্রদত্ত আইডিযুক্ত ফোল্ডারটি।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFolderByIdAndResourceKey(id, resourceKey)

প্রদত্ত আইডি এবং রিসোর্স কী ব্যবহার করে ফোল্ডারটি পাওয়া যায়। রিসোর্স কী হলো একটি অতিরিক্ত প্যারামিটার, যা লিঙ্কের মাধ্যমে শেয়ার করা ফোল্ডার অ্যাক্সেস করার জন্য পাস করতে হয়।

যদি ফোল্ডারটি বিদ্যমান না থাকে অথবা ব্যবহারকারীর এটি অ্যাক্সেস করার অনুমতি না থাকে, তাহলে একটি স্ক্রিপ্টিং ব্যতিক্রম (scripting exception) দেখানো হয়।

প্যারামিটার

নাম প্রকার বর্ণনা
id String ফোল্ডারটির আইডি।
resource Key String ফোল্ডারটির রিসোর্স কী।

ফেরত

Folder — প্রদত্ত আইডিযুক্ত ফোল্ডারটি।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFolders()

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

ফেরত

FolderIterator — ব্যবহারকারীর ড্রাইভে থাকা সমস্ত ফোল্ডারের একটি সংগ্রহ।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getFoldersByName(name)

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

প্যারামিটার

নাম প্রকার বর্ণনা
name String যে ফোল্ডারগুলো খুঁজতে হবে সেগুলোর নাম।

ফেরত

FolderIterator — ব্যবহারকারীর ড্রাইভে থাকা প্রদত্ত নামের সমস্ত ফোল্ডারের একটি সংগ্রহ।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getRootFolder()

ব্যবহারকারীর ড্রাইভের রুটে থাকা ফোল্ডারটি খুঁজে বের করে। 

// Gets the user's My Drive folder and logs its name to the console.
console.log(DriveApp.getRootFolder().getName());

// Logs the Drive owner's name to the console.
console.log(DriveApp.getRootFolder().getOwner().getName());

ফেরত

Folder — ব্যবহারকারীর ড্রাইভের মূল ফোল্ডার।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getStorageLimit()

ব্যবহারকারীকে ড্রাইভে কত বাইট ডেটা সংরক্ষণ করার অনুমতি দেওয়া হয়েছে, তা জানা যায়। 

// Gets the number of bytes the user can store in Drive and logs it to the
// console.
console.log(DriveApp.getStorageLimit());

ফেরত

Integer — ব্যবহারকারীকে ড্রাইভে যে পরিমাণ বাইট সংরক্ষণ করার অনুমতি দেওয়া হয়।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getStorageUsed()

ব্যবহারকারী বর্তমানে ড্রাইভে কত বাইট ডেটা সংরক্ষণ করছেন, তা জানা যায়। 

// Gets the number of bytes the user is currently storing in Drive and logs it
// to the console.
console.log(DriveApp.getStorageUsed());

ফেরত

Integer — ব্যবহারকারী বর্তমানে ড্রাইভে যে পরিমাণ বাইট সংরক্ষণ করছেন।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getTrashedFiles()

ব্যবহারকারীর ড্রাইভের ট্র্যাশে থাকা সমস্ত ফাইলের একটি সংগ্রহ নিয়ে আসে। 

// Gets a list of all the files in the trash of the user's Drive.
const trashFiles = DriveApp.getTrashedFiles();

// Logs the trash file names to the console.
while (trashFiles.hasNext()) {
  const file = trashFiles.next();
  console.log(file.getName());
}

ফেরত

FileIterator — ট্র্যাশে থাকা ফাইলগুলোর একটি সংগ্রহ।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getTrashedFolders()

ব্যবহারকারীর ড্রাইভের ট্র্যাশে থাকা সমস্ত ফোল্ডারের একটি সংগ্রহ নিয়ে আসে। 

// Gets a collection of all the folders in the trash of the user's Drive.
const trashFolders = DriveApp.getTrashedFolders();

// Logs the trash folder names to the console.
while (trashFolders.hasNext()) {
  const folder = trashFolders.next();
  console.log(folder.getName());
}

ফেরত

FolderIterator — ট্র্যাশে থাকা ফোল্ডারগুলোর একটি সংগ্রহ।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

searchFiles(params)

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

` params আর্গুমেন্টটি একটি কোয়েরি স্ট্রিং যা স্ট্রিং ভ্যালু ধারণ করতে পারে, তাই উদ্ধৃতি চিহ্নগুলো সঠিকভাবে এস্কেপ করার ব্যাপারে সতর্ক থাকুন (উদাহরণস্বরূপ, "title contains 'Gulliver\\'s Travels'" অথবা 'title contains "Gulliver\'s Travels"' )। 

// Logs the name of every file in the user's Drive that modified after February 28,
// 2022 whose name contains "untitled.""
const files = DriveApp.searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getName());
}

প্যারামিটার

নাম প্রকার বর্ণনা
params String অনুসন্ধানের মানদণ্ড, যা গুগল ড্রাইভ এসডিকে ডকুমেন্টেশনে বিস্তারিতভাবে উল্লেখ করা আছে।

ফেরত

FileIterator — ব্যবহারকারীর ড্রাইভে থাকা সেই সমস্ত ফাইলের একটি সংগ্রহ, যা অনুসন্ধানের শর্তের সাথে মেলে।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

searchFolders(params)

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

` params আর্গুমেন্টটি একটি কোয়েরি স্ট্রিং যা স্ট্রিং ভ্যালু ধারণ করতে পারে, তাই উদ্ধৃতি চিহ্নগুলো সঠিকভাবে এস্কেপ করার ব্যাপারে সতর্ক থাকুন (উদাহরণস্বরূপ, "title contains 'Gulliver\\'s Travels'" অথবা 'title contains "Gulliver\'s Travels"' )। 

// Logs the name of every folder in the user's Drive that you own and is starred.
const folders = DriveApp.searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  const folder = folders.next();
  console.log(folder.getName());
}

প্যারামিটার

নাম প্রকার বর্ণনা
params String অনুসন্ধানের মানদণ্ড, যা গুগল ড্রাইভ এসডিকে ডকুমেন্টেশনে বিস্তারিতভাবে উল্লেখ করা আছে।

ফেরত

FolderIterator — ব্যবহারকারীর ড্রাইভে থাকা সেই সমস্ত ফোল্ডারের একটি সংগ্রহ, যা অনুসন্ধানের শর্তের সাথে মেলে।

অনুমোদন

যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

অপ্রচলিত পদ্ধতি