Class DriveApp

यह फ़ाइल के लिए, पिछले iterator से मिले 'जारी रखने के टोकन' का इस्तेमाल करके, फ़ाइल के लिए दोबारा शुरू करता है. यह तरीका तब कारगर होता है, जब एक बार में किसी इटरेटटर को प्रोसेस करने में, प्रोसेस करने के लिए तय किए गए ज़्यादा से ज़्यादा समय से ज़्यादा समय लगता है. आम तौर पर, कंटिन्यूएशन टोकन एक हफ़्ते के लिए मान्य होते हैं.

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

पैरामीटर

वापसी का टिकट

FileIterator — उन फ़ाइलों का कलेक्शन जो जारी रखने वाला टोकन जनरेट होने पर, पिछले iterator में रह गई थीं.

पिछले iterator से मिले कंटिन्यूएशन टोकन का इस्तेमाल करके, फ़ोल्डर के लिए फिर से फ़ंक्शन चलाता है. यह तरीका तब काम आता है, जब एक बार में किसी इटरेटटर को प्रोसेस करने में, प्रोसेस करने के लिए तय किए गए ज़्यादा से ज़्यादा समय से ज़्यादा समय लग जाता है. आम तौर पर, कंटिन्यूएशन टोकन एक हफ़्ते के लिए मान्य होते हैं.

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

पैरामीटर

वापसी का टिकट

FolderIterator — उन फ़ोल्डर का कलेक्शन जो जारी रखने वाला टोकन जनरेट होने पर, पिछले iterator में बने रहे.

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

पैरामीटर

वापसी का टिकट

File — नई फ़ाइल.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

उपयोगकर्ता के Drive के रूट में, दिए गए नाम और कॉन्टेंट वाली टेक्स्ट फ़ाइल बनाता है. अगर content का साइज़ 50 एमबी से ज़्यादा है, तो अपवाद दिखाता है.

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

पैरामीटर

वापसी का टिकट

File — नई फ़ाइल.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

उपयोगकर्ता के Drive के रूट में, दिए गए नाम, कॉन्टेंट, और MIME टाइप वाली फ़ाइल बनाता है. अगर content 10 एमबी से ज़्यादा है, तो अपवाद दिखाता है.

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

पैरामीटर

वापसी का टिकट

File — नई फ़ाइल.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

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

पैरामीटर

वापसी का टिकट

Folder — नया फ़ोल्डर.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

दिए गए Drive आइटम आईडी का शॉर्टकट बनाता है और उसे दिखाता है.

पैरामीटर

वापसी का टिकट

File — नया शॉर्टकट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

दिए गए Drive आइटम आईडी और संसाधन कुंजी का शॉर्टकट बनाता है और उसे दिखाता है. रिसॉर्स कीवर्ड एक अतिरिक्त पैरामीटर होता है. इसे उस टारगेट फ़ाइल या फ़ोल्डर को ऐक्सेस करने के लिए पास करना होता है जिसे लिंक का इस्तेमाल करके शेयर किया गया है.

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

पैरामीटर

वापसी का टिकट

File — नया शॉर्टकट.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

आइटम के पैरंट पर असर डालने वाले सभी कॉल के लिए, enforceSingleParent को चालू या बंद करता है.

ज़्यादा जानकारी के लिए, Google Drive के फ़ोल्डर स्ट्रक्चर और शेयर करने के मॉडल को आसान बनाना ब्लॉग देखें.

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

पैरामीटर

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

दिए गए आईडी वाली फ़ाइल को दिखाता है. अगर फ़ाइल मौजूद नहीं है या उपयोगकर्ता के पास इसे ऐक्सेस करने की अनुमति नहीं है, तो स्क्रिप्टिंग अपवाद दिखाता है.

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

पैरामीटर

वापसी का टिकट

File — दिए गए आईडी वाली फ़ाइल.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

दिए गए आईडी और रिसॉर्स कुंजी की मदद से फ़ाइल को फ़ेच करता है. संसाधन कुंजियां एक अतिरिक्त पैरामीटर होती हैं, जिन्हें लिंक का इस्तेमाल करके शेयर की गई फ़ाइलों को ऐक्सेस करने के लिए पास करना होता है.

अगर फ़ाइल मौजूद नहीं है या उपयोगकर्ता के पास इसे ऐक्सेस करने की अनुमति नहीं है, तो स्क्रिप्टिंग एक्सेप्शन दिखाता है.

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

पैरामीटर

वापसी का टिकट

File — दिए गए आईडी वाली फ़ाइल.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

उपयोगकर्ता के Drive में मौजूद सभी फ़ाइलों का कलेक्शन मिलता है.

वापसी का टिकट

FileIterator — उपयोगकर्ता के Drive में मौजूद सभी फ़ाइलों का कलेक्शन.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

उपयोगकर्ता के Drive में मौजूद उन सभी फ़ाइलों का कलेक्शन मिलता है जिनका नाम दिया गया है.

पैरामीटर

वापसी का टिकट

FileIterator — उपयोगकर्ता के Drive में मौजूद उन सभी फ़ाइलों का कलेक्शन जिनका नाम दिया गया है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

उपयोगकर्ता के Drive में मौजूद उन सभी फ़ाइलों का कलेक्शन पाता है जिनका एमआईएम टाइप दिया गया है.

पैरामीटर

वापसी का टिकट

FileIterator — उपयोगकर्ता के Drive में मौजूद उन सभी फ़ाइलों का कलेक्शन जिनका MIME टाइप दिया गया है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

दिए गए आईडी वाला फ़ोल्डर पाता है. अगर फ़ोल्डर मौजूद नहीं है या उपयोगकर्ता के पास इसे ऐक्सेस करने की अनुमति नहीं है, तो स्क्रिप्टिंग एक्सेप्शन दिखाता है.

पैरामीटर

वापसी का टिकट

Folder — दिए गए आईडी वाला फ़ोल्डर.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

दिए गए आईडी और रिसॉर्स कुंजी के साथ फ़ोल्डर पाता है. संसाधन कुंजियां एक अतिरिक्त पैरामीटर होती हैं. लिंक का इस्तेमाल करके शेयर किए गए फ़ोल्डर को ऐक्सेस करने के लिए, उन्हें पास करना ज़रूरी होता है.

अगर फ़ोल्डर मौजूद नहीं है या उपयोगकर्ता के पास उसे ऐक्सेस करने की अनुमति नहीं है, तो स्क्रिप्टिंग एक्सेप्शन दिखाता है.

पैरामीटर

वापसी का टिकट

Folder — दिए गए आईडी वाला फ़ोल्डर.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

उपयोगकर्ता के Drive में मौजूद सभी फ़ोल्डर का कलेक्शन मिलता है.

वापसी का टिकट

FolderIterator — उपयोगकर्ता के Drive में मौजूद सभी फ़ोल्डर का कलेक्शन.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

उपयोगकर्ता के Drive में मौजूद उन सभी फ़ोल्डर का कलेक्शन पाता है जिनका नाम दिया गया है.

पैरामीटर

वापसी का टिकट

FolderIterator — उपयोगकर्ता के Drive में मौजूद उन सभी फ़ोल्डर का कलेक्शन जिनका नाम दिया गया है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

उपयोगकर्ता के Drive के रूट में मौजूद फ़ोल्डर की जानकारी मिलती है.

// 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 — उपयोगकर्ता के Drive का रूट फ़ोल्डर.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

इससे उन बाइट की संख्या का पता चलता है जिन्हें उपयोगकर्ता को Drive में सेव करने की अनुमति है.

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

वापसी का टिकट

Integer — Drive में उपयोगकर्ता को स्टोर करने की अनुमति वाली बाइट की संख्या.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

इससे, Drive में उपयोगकर्ता के स्टोर किए जा रहे बाइट की संख्या का पता चलता है.

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

वापसी का टिकट

Integer — Drive में फ़िलहाल उपयोगकर्ता के स्टोर किए गए बाइट की संख्या.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

उपयोगकर्ता के Drive के ट्रैश में मौजूद सभी फ़ाइलों का कलेक्शन मिलता है.

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

उपयोगकर्ता के Drive के ट्रैश में मौजूद सभी फ़ोल्डर का कलेक्शन पाता है.

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

उपयोगकर्ता के Drive में मौजूद उन सभी फ़ाइलों का कलेक्शन पाता है जो खोज के लिए इस्तेमाल हुए शब्दों से मेल खाती हैं. खोज के लिए ज़रूरी शर्तों के बारे में Google Drive SDK टूल के दस्तावेज़ में बताया गया है. ध्यान दें कि Drive की सेवा, Drive API के 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());
}

पैरामीटर

वापसी का टिकट

FileIterator — उपयोगकर्ता के Drive में मौजूद उन सभी फ़ाइलों का कलेक्शन जो खोज के लिए इस्तेमाल हुए शब्दों से मेल खाती हैं.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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

उपयोगकर्ता के Drive में मौजूद उन सभी फ़ोल्डर का कलेक्शन पाता है जो खोज के लिए इस्तेमाल हुए शब्दों से मेल खाते हैं. खोज के लिए ज़रूरी शर्तों के बारे में Google Drive SDK टूल के दस्तावेज़ में बताया गया है. ध्यान दें कि Drive की सेवा, Drive API के 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());
}

पैरामीटर

वापसी का टिकट

FolderIterator — उपयोगकर्ता के Drive में मौजूद उन सभी फ़ोल्डर का कलेक्शन जो खोज के लिए इस्तेमाल हुए शब्दों से मेल खाते हैं.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या एक से ज़्यादा स्कोप के लिए अनुमति की ज़रूरत होती है:

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