Class Folder

المجلد

مجلد في Google Drive يمكن الوصول إلى المجلدات أو إنشاؤها من DriveApp. 

// Log the name of every folder in the user's Drive.
const folders = DriveApp.getFolders();
while (folders.hasNext()) {
  const folder = folders.next();
  Logger.log(folder.getName());
}

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
addEditor(emailAddress)Folderتضيف هذه الطريقة المستخدم المحدّد إلى قائمة المحرّرين في Folder.
addEditor(user)Folderتضيف هذه الطريقة المستخدم المحدّد إلى قائمة المحرّرين في Folder.
addEditors(emailAddresses)Folderتضيف هذه الطريقة مصفوفة المستخدمين المحدّدة إلى قائمة المحرّرين في Folder.
addViewer(emailAddress)Folderتضيف هذه الطريقة المستخدم المحدّد إلى قائمة المشاهدين في Folder.
addViewer(user)Folderتضيف هذه الطريقة المستخدم المحدّد إلى قائمة المشاهدين في Folder.
addViewers(emailAddresses)Folderتضيف هذه الطريقة مصفوفة المستخدمين المحدّدة إلى قائمة المشاهدين في Folder.
createFile(blob)Fileتنشئ هذه الدالة ملفًا في المجلد الحالي من Blob معيّن يتضمّن بيانات عشوائية.
createFile(name, content)Fileينشئ ملفًا نصيًا في المجلد الحالي بالاسم والمحتوى المحدّدين.
createFile(name, content, mimeType)Fileتنشئ هذه الطريقة ملفًا في المجلد الحالي بالاسم والمحتوى ونوع MIME المحدّدين.
createFolder(name)Folderينشئ هذا الأمر مجلدًا في المجلد الحالي بالاسم المحدّد.
createShortcut(targetId)Fileتنشئ هذه الطريقة اختصارًا لمعرّف عنصر Drive المقدَّم وتعرضه.
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)Fileينشئ هذا الإجراء اختصارًا لمعرّف عنصر Drive ومفتاح المورد المقدَّمَين، ويعرضه.
getAccess(email)Permissionتعرض هذه الطريقة الإذن الممنوح لمستخدم معيّن.
getAccess(user)Permissionتعرض هذه الطريقة الإذن الممنوح لمستخدم معيّن.
getDateCreated()Dateتعرض هذه السمة تاريخ إنشاء Folder.
getDescription()Stringتعرض هذه السمة وصفًا لـ Folder.
getEditors()User[]تعرض هذه الطريقة قائمة بالمحرّرين لـ Folder.
getFiles()FileIteratorيحصل على مجموعة من جميع الملفات التي تندرج ضمن المجلد الحالي.
getFilesByName(name)FileIteratorيحصل على مجموعة من جميع الملفات التي تندرج ضمن المجلد الحالي ولها الاسم المحدّد.
getFilesByType(mimeType)FileIteratorتعرض هذه الطريقة مجموعة من جميع الملفات التي تندرج ضمن المجلد الحالي ولها نوع MIME المحدّد.
getFolders()FolderIteratorتعرض هذه الطريقة مجموعة من جميع المجلدات التي تندرج ضمن المجلد الحالي.
getFoldersByName(name)FolderIteratorتعرض هذه الطريقة مجموعة من جميع المجلدات التي تندرج ضمن المجلد الحالي وتحمل الاسم المحدّد.
getId()Stringتعرض هذه السمة معرّف Folder.
getLastUpdated()Dateتعرض هذه السمة تاريخ آخر تعديل على Folder.
getName()Stringتعرض هذه السمة اسم Folder.
getOwner()Userتعرض هذه الطريقة مالك Folder.
getParents()FolderIteratorتعرض هذه الطريقة مجموعة من المجلدات التي تمثّل المجلدات الرئيسية المباشرة للعنصر Folder.
getResourceKey()Stringيحصل هذا الحقل على مفتاح المورد الخاص بـ Folder المطلوب للوصول إلى الملفات التي تمت مشاركتها باستخدام رابط.
getSecurityUpdateEligible()Booleanتعرض هذه السمة ما إذا كان Folder مؤهلاً لتطبيق تحديث الأمان الذي يتطلب مفتاح مصدر للوصول إلى الملفات عند مشاركتها باستخدام رابط.
getSecurityUpdateEnabled()Booleanتعرض هذه السمة ما إذا كان Folder يتطلّب مفتاح مورد للوصول إليه عند مشاركته باستخدام رابط.
getSharingAccess()Accessتعرض هذه السمة فئة المستخدمين الذين يمكنهم الوصول إلى Folder، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكل صريح.
getSharingPermission()Permissionتعرض هذه السمة الإذن الممنوح للمستخدمين الذين يمكنهم الوصول إلى Folder، بالإضافة إلى أي مستخدمين فرديين تم منحهم الإذن بالوصول بشكل صريح.
getSize()Integerتعرض هذه الطريقة عدد وحدات البايت المستخدَمة لتخزين Folder في Drive.
getUrl()Stringيحصل على عنوان URL الذي يمكن استخدامه لفتح Folder في أحد تطبيقات Google، مثل Drive أو "مستندات Google".
getViewers()User[]تعرض هذه الطريقة قائمة بالمشاهدين والمعلّقين على Folder.
isShareableByEditors()Booleanتحدّد هذه السمة ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل Folder بمشاركة الملف مع مستخدمين آخرين أو تغيير الأذونات.
isStarred()Booleanتُحدِّد هذه السمة ما إذا تم تمييز Folder بنجمة في حساب Drive الخاص بالمستخدم.
isTrashed()Booleanيحدّد هذا الحقل ما إذا كان Folder في مهملات حساب المستخدم على Drive.
moveTo(destination)Folderتنقل هذه الطريقة العنصر إلى مجلد الوجهة المقدَّم.
removeEditor(emailAddress)Folderتزيل هذه الطريقة المستخدم المحدّد من قائمة المحرّرين في Folder.
removeEditor(user)Folderتزيل هذه الطريقة المستخدم المحدّد من قائمة المحرّرين في Folder.
removeViewer(emailAddress)Folderتزيل هذه الطريقة المستخدم المحدّد من قائمة المشاهدين والمعلّقين على Folder.
removeViewer(user)Folderتزيل هذه الطريقة المستخدم المحدّد من قائمة المشاهدين والمعلّقين على Folder.
revokePermissions(emailAddress)Folderيلغي هذا الإجراء إذن الوصول إلى Folder الممنوح للمستخدم المحدّد.
revokePermissions(user)Folderيلغي هذا الإجراء إذن الوصول إلى Folder الممنوح للمستخدم المحدّد.
searchFiles(params)FileIteratorيحصل على مجموعة من جميع الملفات التي تمثّل عناصر فرعية للمجلد الحالي وتتطابق مع معايير البحث المحدّدة.
searchFolders(params)FolderIteratorيحصل على مجموعة من جميع المجلدات الفرعية للمجلد الحالي والتي تتطابق مع معايير البحث المحدّدة.
setDescription(description)Folderتضبط هذه السمة وصف Folder.
setName(name)Folderتضبط هذه السمة اسم Folder.
setOwner(emailAddress)Folderتغيير مالك Folder
setOwner(user)Folderتغيير مالك Folder
setSecurityUpdateEnabled(enabled)Folderيحدّد هذا الإعداد ما إذا كانت السمة Folder تتطلّب مفتاح مصدر للوصول إليها عند مشاركتها باستخدام رابط.
setShareableByEditors(shareable)Folderتضبط هذه السمة ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل Folder بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات.
setSharing(accessType, permissionType)Folderتحدّد هذه السمة فئة المستخدمين الذين يمكنهم الوصول إلى Folder والأذونات الممنوحة لهم، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكل صريح.
setStarred(starred)Folderتضبط هذه السمة ما إذا كان Folder مميّزًا بنجمة في حساب Drive الخاص بالمستخدم.
setTrashed(trashed)Folderيحدّد هذا الحقل ما إذا كان Folder في مهملات حساب المستخدم على Drive.

مستندات تفصيلية

addEditor(emailAddress)

تضيف هذه الطريقة المستخدم المحدّد إلى قائمة المحرّرين في Folder. إذا كان المستخدم مُدرَجًا في قائمة المشاهدين، سيؤدي هذا الإجراء إلى إزالته من القائمة.

المعلمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم الذي تريد إضافته

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

addEditor(user)

تضيف هذه الطريقة المستخدم المحدّد إلى قائمة المحرّرين في Folder. إذا كان المستخدم مُدرَجًا في قائمة المشاهدين، سيؤدي هذا الإجراء إلى إزالته من القائمة.

المعلمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم الذي تريد إضافته

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

addEditors(emailAddresses)

تضيف هذه الطريقة مصفوفة المستخدمين المحدّدة إلى قائمة المحرّرين في Folder. إذا كان أي من المستخدمين مدرجًا في قائمة المشاهدين، ستؤدي هذه الطريقة إلى إزالته من القائمة.

المعلمات

الاسمالنوعالوصف
emailAddressesString[]مصفوفة من عناوين البريد الإلكتروني للمستخدمين الذين تريد إضافتهم

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

addViewer(emailAddress)

تضيف هذه الطريقة المستخدم المحدّد إلى قائمة المشاهدين في Folder. إذا كان المستخدم مُدرجًا في قائمة المحرّرين، لن يكون لهذا الإجراء أي تأثير.

المعلمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم الذي تريد إضافته

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

addViewer(user)

تضيف هذه الطريقة المستخدم المحدّد إلى قائمة المشاهدين في Folder. إذا كان المستخدم مُدرجًا في قائمة المحرّرين، لن يكون لهذا الإجراء أي تأثير.

المعلمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم الذي تريد إضافته

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

addViewers(emailAddresses)

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

المعلمات

الاسمالنوعالوصف
emailAddressesString[]مصفوفة من عناوين البريد الإلكتروني للمستخدمين الذين تريد إضافتهم

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

createFile(blob)

تنشئ هذه الدالة ملفًا في المجلد الحالي من Blob معيّن يتضمّن بيانات عشوائية.

المعلمات

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

الإرجاع

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

التفويض

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

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

createFile(name, content)

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

createFile(name, content, mimeType)

تنشئ هذه الطريقة ملفًا في المجلد الحالي بالاسم والمحتوى ونوع MIME المحدّدين. يتم عرض استثناء إذا كان content أكبر من 10 ميغابايت. 

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

المعلمات

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

الإرجاع

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

التفويض

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

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

createFolder(name)

ينشئ هذا الأمر مجلدًا في المجلد الحالي بالاسم المحدّد.

المعلمات

الاسمالنوعالوصف
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

getAccess(email)

تعرض هذه الطريقة الإذن الممنوح لمستخدم معيّن. لا تتيح الطريقة عرض الأذونات الخاصة بمجموعة Google أو الأذونات الموروثة من خلال "مجموعات Google".

المعلمات

الاسمالنوعالوصف
emailStringعنوان البريد الإلكتروني للمستخدم الذي يجب التحقّق من أذوناته. لا تتوافق هذه المجموعات مع "مجموعات Google".

الإرجاع

Permission: الأذونات الممنوحة للمستخدم

التفويض

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

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

getAccess(user)

تعرض هذه الطريقة الإذن الممنوح لمستخدم معيّن. لا تتيح الطريقة عرض الأذونات الخاصة بمجموعة Google أو الأذونات الموروثة من خلال "مجموعات Google".

المعلمات

الاسمالنوعالوصف
userUserتمثّل هذه السمة المستخدم الذي يجب التحقّق من أذوناته.

الإرجاع

Permission: الأذونات الممنوحة للمستخدم

التفويض

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

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

getDateCreated()

تعرض هذه السمة تاريخ إنشاء Folder.

الإرجاع

Date: تاريخ إنشاء Folder

التفويض

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

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

getDescription()

تعرض هذه السمة وصفًا لـ Folder.

الإرجاع

String: وصف Folder

التفويض

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

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

getEditors()

تعرض هذه الطريقة قائمة بالمحرّرين لـ Folder. إذا لم يكن لدى المستخدم الذي ينفّذ البرنامج النصي إذن بتعديل Folder، ستعرض هذه الطريقة مصفوفة فارغة. 

//  Gets a folder by its ID.
//  TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of editors and logs their names to the console.
const editors = folder.getEditors();
for (const editor of editors) {
  console.log(editor.getName());
}

الإرجاع

User[]: قائمة المحرّرين في Folder هذا، إذا كان لدى المستخدم إذن تعديل، أو مصفوفة فارغة في حال عدم توفّر هذا الإذن

التفويض

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

  • 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)

يحصل على مجموعة من جميع الملفات التي تندرج ضمن المجلد الحالي ولها الاسم المحدّد.

المعلمات

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

الإرجاع

FileIterator: مجموعة من جميع الملفات الفرعية للمجلد الحالي والتي تحمل الاسم المحدّد.

التفويض

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

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

getFilesByType(mimeType)

تعرض هذه الطريقة مجموعة من جميع الملفات التي تندرج ضمن المجلد الحالي ولها نوع MIME المحدّد.

المعلمات

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

الإرجاع

‫FileIterator: مجموعة من جميع الملفات الفرعية للمجلد الحالي والتي لها نوع MIME المحدّد.

التفويض

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

  • 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)

تعرض هذه الطريقة مجموعة من جميع المجلدات التي تندرج ضمن المجلد الحالي وتحمل الاسم المحدّد.

المعلمات

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

الإرجاع

FolderIterator: مجموعة من جميع المجلدات الفرعية للمجلد الحالي والتي تحمل الاسم المحدّد.

التفويض

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

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

getId()

تعرض هذه السمة معرّف Folder.

الإرجاع

String: معرّف Folder

التفويض

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

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

getLastUpdated()

تعرض هذه السمة تاريخ آخر تعديل على Folder.

الإرجاع

Date: تاريخ آخر تعديل على Folder

التفويض

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

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

getName()

تعرض هذه السمة اسم Folder.

الإرجاع

String: اسم Folder

التفويض

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

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

getOwner()

تعرض هذه الطريقة مالك Folder. 

//  Gets a folder by its ID.
//  TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the owner of the folder and logs the name to the console.
const folderOwner = folder.getOwner();
console.log(folderOwner.getName());

الإرجاع

User: مالك Folder هذا

التفويض

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

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

getParents()

تعرض هذه الطريقة مجموعة من المجلدات التي تمثّل المجلدات الرئيسية المباشرة للعنصر Folder.

الإرجاع

FolderIterator: مجموعة من المجلدات التي تمثّل المجلدات الرئيسية المباشرة لـ Folder

التفويض

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

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

getResourceKey()

يحصل هذا الحقل على مفتاح المورد الخاص بـ Folder المطلوب للوصول إلى الملفات التي تمت مشاركتها باستخدام رابط.

الإرجاع

String: مفتاح المورد الخاص بـ Folder

التفويض

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

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

getSecurityUpdateEligible()

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

يتطلّب Drive مفتاح مورد للوصول إلى بعض الملفات أو المجلدات التي تمت مشاركتها باستخدام رابط. هذا التغيير هو جزء من تحديث أمان. يكون التعديل مفعّلاً تلقائيًا للملفات والمجلدات المؤهَّلة. لتفعيل متطلبات مفتاح المورد أو إيقافها للملفات المؤهَّلة، استخدِم setSecurityUpdateEnabled.

مزيد من المعلومات حول تحديث الأمان لخدمة Google Drive

الإرجاع

Boolean: ما إذا كان يمكن تطبيق شرط مفتاح المورد على Folder.

التفويض

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

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

getSecurityUpdateEnabled()

تعرض هذه السمة ما إذا كان Folder يتطلّب مفتاح مورد للوصول إليه عند مشاركته باستخدام رابط. يكون هذا الشرط مفعّلاً تلقائيًا للملفات والمجلدات المؤهّلة. لتفعيل متطلبات مفتاح المورد أو إيقافها للملفات المؤهَّلة، استخدِم setSecurityUpdateEnabled.

مزيد من المعلومات حول تحديث الأمان لخدمة Google Drive

الإرجاع

Boolean: لتحديد ما إذا كان شرط مفتاح المورد مفعَّلاً لهذا Folder.

التفويض

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

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

getSharingAccess()

تعرض هذه السمة فئة المستخدمين الذين يمكنهم الوصول إلى Folder، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكل صريح.

الإرجاع

Access: فئة المستخدمين الذين يمكنهم الوصول إلى Folder

التفويض

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

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

getSharingPermission()

تعرض هذه السمة الإذن الممنوح للمستخدمين الذين يمكنهم الوصول إلى Folder، بالإضافة إلى أي مستخدمين فرديين تم منحهم الإذن بالوصول بشكل صريح.

الإرجاع

Permission: الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى Folder

التفويض

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

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

getSize()

تعرض هذه الطريقة عدد وحدات البايت المستخدَمة لتخزين Folder في Drive. يُرجى العِلم أنّ ملفات تطبيقات Google Workspace لا تُحتسَب ضمن حدود مساحة التخزين في Drive، وبالتالي تعرض 0 بايت.

الإرجاع

Integer: عدد وحدات البايت المستخدَمة لتخزين Folder في Drive

التفويض

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

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

getUrl()

يحصل على عنوان URL الذي يمكن استخدامه لفتح Folder في أحد تطبيقات Google، مثل Drive أو "مستندات Google".

الإرجاع

String: عنوان URL الذي يمكن استخدامه لعرض هذا Folder في أحد تطبيقات Google، مثل Drive أو &quot;مستندات Google&quot;

التفويض

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

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

getViewers()

تعرض هذه الطريقة قائمة بالمشاهدين والمعلّقين على Folder. إذا لم يكن لدى المستخدم الذي ينفّذ النص البرمجي إذن تعديل Folder، ستعرض هذه الطريقة مصفوفة فارغة. 

//  Gets a folder by its ID.
//  TODO(developer): Replace the folder ID with your own.
const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz');

// Gets the list of viewers and logs their names to the console.
const viewers = folder.getViewers();
for (const viewer of viewers) {
  console.log(viewer.getName());
}

الإرجاع

User[]: قائمة المشاهدين والمعلّقين على هذا Folder إذا كان لدى المستخدم إذن بالتعديل، أو مصفوفة فارغة في حال عدم توفّر هذا الإذن.

التفويض

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

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

isShareableByEditors()

تحدّد هذه السمة ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل Folder بمشاركة الملف مع مستخدمين آخرين أو تغيير الأذونات.

الإرجاع

Boolean — true إذا كان مسموحًا للمستخدمين الذين لديهم أذونات التعديل مشاركة الملف مع مستخدمين آخرين أو تغيير الأذونات، false إذا لم يكن مسموحًا بذلك

التفويض

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

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

isStarred()

تُحدِّد هذه السمة ما إذا تم تمييز Folder بنجمة في حساب Drive الخاص بالمستخدم.

الإرجاع

‫Boolean — true إذا تم تمييز Folder بنجمة في حساب المستخدم على Drive، وfalse إذا لم يتم تمييزه

التفويض

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

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

isTrashed()

يحدّد هذا الحقل ما إذا كان Folder في مهملات حساب المستخدم على Drive.

الإرجاع

‫Boolean — true إذا كان Folder في مهملات حساب المستخدم على Drive، false إذا لم يكن كذلك

التفويض

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

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

moveTo(destination)

تنقل هذه الطريقة العنصر إلى مجلد الوجهة المقدَّم.

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

المعلمات

الاسمالنوعالوصف
destinationFolderالمجلد الذي سيصبح المجلد الرئيسي الجديد

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

removeEditor(emailAddress)

تزيل هذه الطريقة المستخدم المحدّد من قائمة المحرّرين في Folder. لا تمنع هذه الطريقة المستخدمين من الوصول إلى Folder إذا كانوا ينتمون إلى فئة من المستخدمين لديهم إذن وصول عام، مثلاً، إذا تمت مشاركة Folder مع نطاق المستخدم بأكمله، أو إذا كان Folder في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.

المعلمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم الذي تريد إزالته

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

removeEditor(user)

تزيل هذه الطريقة المستخدم المحدّد من قائمة المحرّرين في Folder. لا تمنع هذه الطريقة المستخدمين من الوصول إلى Folder إذا كانوا ينتمون إلى فئة من المستخدمين لديهم إذن وصول عام، مثلاً، إذا تمت مشاركة Folder مع نطاق المستخدم بأكمله، أو إذا كان Folder في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.

المعلمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم المطلوب إزالته

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

removeViewer(emailAddress)

تزيل هذه الطريقة المستخدم المحدّد من قائمة المشاهدين والمعلّقين على Folder. ليس لهذه الطريقة أي تأثير إذا كان المستخدم محرّرًا وليس مشاهدًا أو معلّقًا. لا تمنع هذه الطريقة أيضًا المستخدمين من الوصول إلى Folder إذا كانوا ينتمون إلى فئة من المستخدمين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة Folder مع النطاق بأكمله للمستخدم، أو إذا كان Folder في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المحرّرين.

المعلمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم الذي تريد إزالته

الإرجاع

‫Folder: هذا Folder للسلاسل.

التفويض

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

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

removeViewer(user)

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

بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المحرّرين.

المعلمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم المطلوب إزالته

الإرجاع

‫Folder: هذا Folder للسلاسل.

التفويض

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

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

revokePermissions(emailAddress)

يلغي هذا الإجراء إذن الوصول إلى Folder الممنوح للمستخدم المحدّد. لا تمنع هذه الطريقة المستخدمين من الوصول إلى Folder إذا كانوا ينتمون إلى فئة من المستخدمين لديهم إذن وصول عام، مثلاً، إذا تمت مشاركة Folder مع النطاق الكامل للمستخدم.

المعلمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم الذي يجب إبطال إذن الوصول إليه.

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

revokePermissions(user)

يلغي هذا الإجراء إذن الوصول إلى Folder الممنوح للمستخدم المحدّد. لا تمنع هذه الطريقة المستخدمين من الوصول إلى Folder إذا كانوا ينتمون إلى فئة من المستخدمين لديهم إذن وصول عام، مثلاً، إذا تمت مشاركة Folder مع النطاق الكامل للمستخدم.

المعلمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم الذي يجب إلغاء إذن الوصول الخاص به

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

searchFiles(params)

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

الوسيطة params هي سلسلة طلب بحث يمكن أن تحتوي على قيم سلسلة، لذا احرص على إلغاء علامات الاقتباس بشكل صحيح (على سبيل المثال "title contains 'Gulliver\\'s Travels'" أو 'title contains "Gulliver\'s Travels"'). 

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

المعلمات

الاسمالنوعالوصف
paramsStringمعايير البحث، كما هو موضّح بالتفصيل في مستندات Google Drive SDK

الإرجاع

FileIterator: مجموعة من جميع الملفات التابعة للمجلد الحالي والتي تتطابق مع معايير البحث.

التفويض

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

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

searchFolders(params)

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

الوسيطة params هي سلسلة طلب بحث يمكن أن تحتوي على قيم سلسلة، لذا احرص على إلغاء علامات الاقتباس بشكل صحيح (على سبيل المثال "title contains 'Gulliver\\'s Travels'" أو 'title contains "Gulliver\'s Travels"'). 

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

المعلمات

الاسمالنوعالوصف
paramsStringمعايير البحث، كما هو موضّح بالتفصيل في مستندات Google Drive SDK

الإرجاع

FolderIterator: مجموعة من جميع المجلدات الفرعية للمجلد الحالي والتي تتطابق مع معايير البحث

التفويض

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

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

setDescription(description)

تضبط هذه السمة وصف Folder.

المعلمات

الاسمالنوعالوصف
descriptionStringالوصف الجديد لـ "Folder"

الإرجاع

‫Folder — هذا Folder، للسلسلة

التفويض

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

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

setName(name)

تضبط هذه السمة اسم Folder.

المعلمات

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

الإرجاع

‫Folder — هذا Folder، للسلسلة

التفويض

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

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

setOwner(emailAddress)

تغيير مالك Folder تمنح هذه الطريقة أيضًا المالك السابق إذن تعديل صريحًا على Folder.

لا يتيح Drive تغيير ملكية الملفات المملوكة لحسابات gmail.com، ولكنّه يتيح ذلك لحسابات Workspace.

المعلمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم الذي يجب أن يصبح المالك الجديد

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

setOwner(user)

تغيير مالك Folder تمنح هذه الطريقة أيضًا المالك السابق إذن تعديل صريحًا على Folder.

لا يتيح Drive تغيير ملكية الملفات المملوكة لحسابات gmail.com، ولكنّه يتيح ذلك لحسابات Workspace.

المعلمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم الذي يجب أن يصبح المالك الجديد

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

setSecurityUpdateEnabled(enabled)

يحدّد هذا الإعداد ما إذا كانت السمة Folder تتطلّب مفتاح مصدر للوصول إليها عند مشاركتها باستخدام رابط. يتم تفعيل الملفات والمجلدات المؤهَّلة تلقائيًا.

مزيد من المعلومات حول تحديث الأمان لخدمة Google Drive

المعلمات

الاسمالنوعالوصف
enabledBooleanتحديد ما إذا كان سيتم تفعيل شرط مفتاح المورد لـ Folder

الإرجاع

Folder: هذا Folder، للسلسلة.

التفويض

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

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

setShareableByEditors(shareable)

تضبط هذه السمة ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل Folder بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات. القيمة التلقائية لـ Folder جديد هي true.

المعلمات

الاسمالنوعالوصف
shareableBooleantrue إذا كان يجب السماح للمستخدمين الذين لديهم أذونات التعديل بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات، false إذا لم يكن كذلك

الإرجاع

‫Folder — هذا Folder، للسلاسل

التفويض

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

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

setSharing(accessType, permissionType)

تحدّد هذه السمة فئة المستخدمين الذين يمكنهم الوصول إلى Folder والأذونات الممنوحة لهم، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكل صريح. 

// Creates a folder that anyone on the Internet can read from and write to.
// (Domain administrators can prohibit this setting for users of a Google
// Workspace domain.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

المعلمات

الاسمالنوعالوصف
accessTypeAccessفئة المستخدمين الذين يجب أن يتمكّنوا من الوصول إلى Folder
permissionTypePermissionالأذونات التي يجب منحها للمستخدمين الذين يمكنهم الوصول إلى Folder

الإرجاع

‫Folder — هذا Folder، للسلسلة

التفويض

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

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

setStarred(starred)

تضبط هذه السمة ما إذا كان Folder مميّزًا بنجمة في حساب Drive الخاص بالمستخدم. القيمة التلقائية للعناصر Folder الجديدة هي false.

المعلمات

الاسمالنوعالوصف
starredBooleantrue إذا كان يجب تمييز Folder بنجمة في Drive الخاص بالمستخدم، false إذا لم يكن كذلك

الإرجاع

‫Folder — هذا Folder، للسلسلة

التفويض

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

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

setTrashed(trashed)

يحدّد هذا الحقل ما إذا كان Folder في مهملات حساب المستخدم على Drive. يمكن للمالك فقط نقل Folder إلى المهملات. القيمة التلقائية لـ Folder الجديدة هي false.

المعلمات

الاسمالنوعالوصف
trashedBooleantrue إذا كان يجب نقل Folder إلى مهملات Drive الخاصة بالمستخدم، false إذا لم يكن ذلك ضروريًا

الإرجاع

‫Folder — هذا Folder، للسلسلة

التفويض

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

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

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