Class DriveApp

DriveApp

تسمح هذه الميزة للنصوص البرمجية بإنشاء الملفات والمجلدات والبحث عنها وتعديلها في Google Drive. للوصول إلى الملفات أو المجلدات في مساحات التخزين السحابي المشتركة، استخدِم خدمة Drive المتقدّمة.

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

أماكن إقامة

الموقعالنوعالوصف
AccessAccessتعداد يمثل فئات المستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، إلى جانب أي فرد المستخدمين الذين تم منحهم إذن الوصول بشكل صريح.
PermissionPermissionتعداد يمثل الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، إلى جانب لأي مستخدم فردي تم منحه إذن الوصول بشكل صريح.

الطُرق

الطريقةنوع الإرجاعوصف قصير
continueFileIterator(continuationToken)FileIteratorاستئناف تكرار الملف باستخدام الرمز المميز للمتابعة من تكراري سابق.
continueFolderIterator(continuationToken)FolderIteratorاستئناف تكرار مجلد باستخدام الرمز المميز للمتابعة من تكرار سابق.
createFile(blob)Fileينشئ ملفًا في جذر حساب المستخدم على Drive من خلال قيمة Blob معيّنة من البيانات العشوائية.
createFile(name, content)Fileينشئ ملفًا نصيًا في جذر Drive الخاص بالمستخدم بالاسم والمحتوى المقدَّم.
createFile(name, content, mimeType)Fileينشئ ملفًا في جذر حساب المستخدم على Drive باستخدام الاسم والمحتوى ونوع MIME.
createFolder(name)Folderينشئ مجلدًا في جذر حساب المستخدم على Drive بالاسم المحدّد.
createShortcut(targetId)Fileيُنشئ اختصارًا لمعرّف عنصر Drive المقدَّم، ويعرضه.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)Fileيُنشئ اختصارًا لمعرّف عنصر Drive ومفتاح المصدر المقدمين، ويعرضه.
enforceSingleParent(value)voidتفعيل أو إيقاف فرض سلوك الأهل الوحيد لجميع المكالمات التي تؤثر في العناصر الرئيسية للعناصر.
getFileById(id)Fileيحصل على الملف برقم التعريف المحدّد.
getFileByIdAndResourceKey(id, resourceKey)Fileيتم الحصول على الملف مع المعرّف ومفتاح المورد المحدّدَين.
getFiles()FileIteratorالحصول على مجموعة تضم كل الملفات في حساب المستخدم على Drive
getFilesByName(name)FileIteratorيحصل على مجموعة تضم كل الملفات في Drive الخاصة بالمستخدم والتي تحمل الاسم المحدّد.
getFilesByType(mimeType)FileIteratorيحصل على مجموعة تضم كل الملفات في Drive الخاص بالمستخدم والتي تكون من نوع MIME المحدد.
getFolderById(id)Folderيحصل على المجلد الذي يحتوي على المعرّف المحدّد.
getFolderByIdAndResourceKey(id, resourceKey)Folderيحصل على المجلد الذي يحتوي على المعرّف ومفتاح المصدر المحدّدين.
getFolders()FolderIteratorالحصول على مجموعة تضم كل المجلدات في Drive للمستخدم
getFoldersByName(name)FolderIteratorالحصول على مجموعة تضم كل المجلدات في Drive الخاص بالمستخدم والتي تحمل الاسم المحدّد
getRootFolder()Folderالحصول على المجلد في جذر Drive للمستخدم.
getStorageLimit()Integerالحصول على عدد وحدات البايت المسموح للمستخدم بتخزينها في Drive
getStorageUsed()Integerالحصول على عدد وحدات البايت التي يخزِّنها المستخدم حاليًا في Drive
getTrashedFiles()FileIteratorالحصول على مجموعة تضم كل الملفات في مهملات المستخدم على Drive
getTrashedFolders()FolderIteratorالحصول على مجموعة تضم كل المجلدات في المهملات في حساب المستخدم على Drive
searchFiles(params)FileIteratorالحصول على مجموعة تضم جميع الملفات في Drive الخاصة بالمستخدم والتي تتطابق مع عملية البحث المحدّدة المعايير.
searchFolders(params)FolderIteratorالحصول على مجموعة من كل المجلدات التي تطابق عملية البحث المحدّدة في Drive الخاص بالمستخدم المعايير.

الوثائق التفصيلية

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

المعلمات

الاسمالنوعالوصف
continuationTokenStringهو الرمز المميّز للمتابعة من مكرّر ملف سابق.

الإرجاع

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

المعلمات

الاسمالنوعالوصف
continuationTokenStringرمز مميز للمتابعة من مكرّر مجلد سابق.

الإرجاع

FolderIterator — مجموعة من المجلدات التي بقيت في تكرار سابق عند المتابعة تم إنشاء رمز مميز.


createFile(blob)

ينشئ ملفًا في جذر حساب المستخدم على Drive من خلال قيمة Blob معيّنة من البيانات العشوائية.

// Create an image file in Google Drive using the Maps service.
var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob();
DriveApp.createFile(blob);

المعلمات

الاسمالنوعالوصف
blobBlobSourceبيانات الملف الجديد.

الإرجاع

File: الملف الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

createFile(name, content)

ينشئ ملفًا نصيًا في جذر Drive الخاص بالمستخدم بالاسم والمحتوى المقدَّم. يرمي باستثناء ما إذا كان حجم content أكبر من 50 ميغابايت.

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

المعلمات

الاسمالنوعالوصف
nameStringاسم الملف الجديد.
contentStringمحتوى الملف الجديد.

الإرجاع

File: الملف الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

createFile(name, content, mimeType)

ينشئ ملفًا في جذر حساب المستخدم على Drive باستخدام الاسم والمحتوى ونوع MIME. الرميات باستثناء إذا كان حجم content أكبر من 10 ميغابايت.

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

المعلمات

الاسمالنوعالوصف
nameStringاسم الملف الجديد.
contentStringمحتوى الملف الجديد.
mimeTypeStringنوع MIME للملف الجديد.

الإرجاع

File: الملف الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

createFolder(name)

ينشئ مجلدًا في جذر حساب المستخدم على Drive بالاسم المحدّد.

المعلمات

الاسمالنوعالوصف
nameStringاسم المجلد الجديد

الإرجاع

Folder: المجلد الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

createShortcut(targetId)

يُنشئ اختصارًا لمعرّف عنصر Drive المقدَّم، ويعرضه.

المعلمات

الاسمالنوعالوصف
targetIdStringرقم تعريف الملف أو المجلد الهدف.

الإرجاع

File: الاختصار الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

يُنشئ اختصارًا لمعرّف عنصر 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());
}

المعلمات

الاسمالنوعالوصف
targetIdStringرقم تعريف الملف أو المجلد الهدف.
targetResourceKeyStringمفتاح المصدر للملف أو المجلد الهدف.

الإرجاع

File: الاختصار الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

enforceSingleParent(value)

تفعيل أو إيقاف فرض سلوك الأهل الوحيد لجميع المكالمات التي تؤثر في العناصر الرئيسية للعناصر.

يمكنك الاطّلاع على مدونة تبسيط بنية مجلدات Google Drive ونماذج المشاركة لـ المزيد من التفاصيل.

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

المعلمات

الاسمالنوعالوصف
valueBooleanالحالة الجديدة لعلامة forcesingleParent.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

getFileById(id)

يحصل على الملف برقم التعريف المحدّد. عرض استثناء برمجة نصية إذا لم يكن الملف موجودًا أو لا يملك المستخدم إذنًا للوصول إليها.

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

المعلمات

الاسمالنوعالوصف
idStringرقم تعريف الملف.

الإرجاع

File - الملف الذي يحمل المعرّف المحدّد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

getFileByIdAndResourceKey(id, resourceKey)

يتم الحصول على الملف مع المعرّف ومفتاح المورد المحدّدَين. مفاتيح الموارد هي مَعلمة إضافية. التي يجب تمريرها للوصول إلى الملفات التي تمت مشاركتها باستخدام رابط.

عرض استثناء للبرامج النصية إذا لم يكن الملف موجودًا أو لم يكن لدى المستخدم إذن من الوصول إليها.

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

المعلمات

الاسمالنوعالوصف
idStringرقم تعريف الملف.
resourceKeyStringمفتاح المصدر للمجلد.

الإرجاع

File - الملف الذي يحمل المعرّف المحدّد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

getFiles()

الحصول على مجموعة تضم كل الملفات في حساب المستخدم على Drive

الإرجاع

FileIterator — مجموعة تضم كل الملفات في Drive للمستخدم.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

getFilesByName(name)

يحصل على مجموعة تضم كل الملفات في Drive الخاصة بالمستخدم والتي تحمل الاسم المحدّد.

المعلمات

الاسمالنوعالوصف
nameStringاسم الملفات المطلوب البحث عنها.

الإرجاع

FileIterator — مجموعة تضم جميع الملفات في Drive الخاصة بالمستخدم والتي تحمل الاسم المحدّد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

getFilesByType(mimeType)

يحصل على مجموعة تضم كل الملفات في Drive الخاص بالمستخدم والتي تكون من نوع MIME المحدد.

المعلمات

الاسمالنوعالوصف
mimeTypeStringنوع MIME للملفات المطلوب البحث عنها.

الإرجاع

FileIterator — مجموعة من كل الملفات في Drive الخاص بالمستخدم والتي تشتمل على MIME المحدد الكتابة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

getFolderById(id)

يحصل على المجلد الذي يحتوي على المعرّف المحدّد. عرض استثناء برمجة نصية إذا لم يكن المجلد موجودًا أو لا يمتلك المستخدم إذنًا بالوصول إليها.

المعلمات

الاسمالنوعالوصف
idStringرقم تعريف المجلد

الإرجاع

Folder - المجلد الذي يحتوي على المعرّف المحدّد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

getFolderByIdAndResourceKey(id, resourceKey)

يحصل على المجلد الذي يحتوي على المعرّف ومفتاح المصدر المحدّدين. مفاتيح الموارد هي مَعلمة إضافية. التي يجب تمريرها للوصول إلى المجلدات التي تمت مشاركتها باستخدام رابط.

عرض استثناء برمجة نصية إذا لم يكن المجلد موجودًا أو لم يكن لدى المستخدم إذن من الوصول إليها.

المعلمات

الاسمالنوعالوصف
idStringرقم تعريف المجلد
resourceKeyStringمفتاح المصدر للمجلد.

الإرجاع

Folder - المجلد الذي يحتوي على المعرّف المحدّد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

getFolders()

الحصول على مجموعة تضم كل المجلدات في Drive للمستخدم

الإرجاع

FolderIterator — مجموعة من كل المجلدات في Drive للمستخدم

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

getFoldersByName(name)

الحصول على مجموعة تضم كل المجلدات في Drive الخاص بالمستخدم والتي تحمل الاسم المحدّد

المعلمات

الاسمالنوعالوصف
nameStringاسم المجلدات المطلوب البحث عنها.

الإرجاع

FolderIterator — مجموعة تضم كل المجلدات في Drive الخاص بالمستخدم والتي تحمل الاسم المحدّد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

getRootFolder()

الحصول على المجلد في جذر 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

getStorageLimit()

الحصول على عدد وحدات البايت المسموح للمستخدم بتخزينها في 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

getStorageUsed()

الحصول على عدد وحدات البايت التي يخزِّنها المستخدم حاليًا في 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

getTrashedFiles()

الحصول على مجموعة تضم كل الملفات في مهملات المستخدم على 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

getTrashedFolders()

الحصول على مجموعة تضم كل المجلدات في المهملات في حساب المستخدم على 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

searchFiles(params)

الحصول على مجموعة تضم جميع الملفات في Drive الخاصة بالمستخدم والتي تتطابق مع عملية البحث المحدّدة المعايير. يمكنك الاطّلاع على معايير البحث بالتفصيل في مستندات حزمة تطوير البرامج (SDK) لتطبيق Google Drive. لاحظ أن Drive الإصدار الثاني من Drive API وتختلف بعض حقول طلبات البحث عن الإصدار 3. راجِع الحقل. الاختلافات بين الإصدارين 2 و3

الوسيطة 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.""
var files = DriveApp.searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

المعلمات

الاسمالنوعالوصف
paramsStringمعايير البحث، كما هو موضَّح في مستندات حزمة تطوير البرامج (SDK) لخدمة Google Drive

الإرجاع

FileIterator — مجموعة تضم كل الملفات التي تتطابق مع طلب البحث في Drive للمستخدم المعايير.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

searchFolders(params)

الحصول على مجموعة من كل المجلدات التي تطابق عملية البحث المحدّدة في Drive الخاص بالمستخدم المعايير. يمكنك الاطّلاع على معايير البحث بالتفصيل في مستندات حزمة تطوير البرامج (SDK) لتطبيق Google Drive. لاحظ أن Drive الإصدار الثاني من Drive API وتختلف بعض حقول طلبات البحث عن الإصدار 3. راجِع الحقل. الاختلافات بين الإصدارين 2 و3

الوسيطة 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.
var folders = DriveApp.searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var folder = folders.next();
  console.log(folder.getName());
}

المعلمات

الاسمالنوعالوصف
paramsStringمعايير البحث، كما هو موضَّح في مستندات حزمة تطوير البرامج (SDK) لخدمة Google Drive

الإرجاع

FolderIterator — مجموعة تضم كل المجلدات التي تطابق طلب البحث في Drive الخاص بالمستخدم المعايير.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

طرق متوقّفة نهائيًا