Class Folder

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

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

// Log the name of every folder in the user's Drive.
var folders = DriveApp.getFolders();
while (folders.hasNext()) {
  var 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(user)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 لبيانات عشوائية.

// Create an image file in Google Drive using the Maps service.
var blob = Maps.newStaticMap().setCenter('76 9th Avenue, New York NY').getBlob();
DriveApp.getRootFolder().createFile(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 ومفتاح المورد المتوفّرين، ويتم عرضه. مفاتيح الموارد هي معلّمة إضافية يجب تمريرها للوصول إلى الملف أو المجلد المستهدف الذي تمت مشاركته باستخدام رابط.

المعلّمات

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

تذكرة ذهاب وعودة

File — الاختصار الجديد.

التفويض

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

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

getAccess(email)

يحصل المستخدم على الإذن الذي تم منحه للمستخدم.

المعلّمات

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

تذكرة ذهاب وعودة

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

التفويض

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

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

getAccess(user)

يحصل المستخدم على الإذن الذي تم منحه للمستخدم.

المعلّمات

الاسمالنوعالوصف
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، ستعرض هذه الطريقة مصفوفة فارغة.

تذكرة ذهاب وعودة

User[]: مصفوفة من المستخدمين لديهم إذن تعديل.

التفويض

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

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

تذكرة ذهاب وعودة

User: عنصر User يمثّل المالك

التفويض

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

  • 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 أو "مستندات Google"

التفويض

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

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

getViewers()

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

تذكرة ذهاب وعودة

User[]: مصفوفة من المستخدمين الذين لديهم إذن عرض أو تعليق.

التفويض

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

  • 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 على جهاز المستخدم.

تذكرة ذهاب وعودة

Booleantrue إذا كان Folder مميزًا بنجمة في Drive الخاص بالمستخدم، false إذا لم يكن مميّزًا.

التفويض

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

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

isTrashed()

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

تذكرة ذهاب وعودة

Booleantrue إذا كان Folder موضوعًا في مهملات المستخدم's 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(user)

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

المعلّمات

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

تذكرة ذهاب وعودة

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. يُرجى العِلم أنّ وسيطة params هي سلسلة طلب بحث قد تحتوي على قيم سلسلة، لذا يجب الحرص على تجنّب علامات الاقتباس ذات الصلة بشكل صحيح (على سبيل المثال "title contains 'Gulliver\\'s Travels'" أو 'title contains "Gulliver\'s Travels"').

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

المعلّمات

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

تذكرة ذهاب وعودة

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

التفويض

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

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

searchFolders(params)

يحصل على مجموعة من جميع المجلدات الفرعية من المجلد الحالي وتتطابق مع معايير البحث. يتم شرح معايير البحث بالتفصيل في مستندات Google Drive SDK. يُرجى العِلم أنّ وسيطة params هي سلسلة طلب بحث قد تحتوي على قيم سلسلة، لذا يجب الحرص على تجنّب علامات الاقتباس ذات الصلة بشكل صحيح (على سبيل المثال "title contains 'Gulliver\\'s Travels'" أو 'title contains "Gulliver\'s Travels"').

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

المعلّمات

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

تذكرة ذهاب وعودة

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.

المعلّمات

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

تذكرة ذهاب وعودة

Folder - هذا Folder، للسلاسل

التفويض

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

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

setOwner(user)

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

المعلّمات

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

الطرق التي تم إيقافها نهائيًا