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(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 معيّن من البيانات العشوائية.

// 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 ومفتاح المصدر المقدمين، ويعرضه. مورد هو معلمة إضافية يلزم تمريرها للوصول إلى الملف أو المجلد المستهدف الذي تمت مشاركة باستخدام رابط.

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

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

المعلمات

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

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

التفويض

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

  • 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 (viewer of viewers) {
  console.log(viewer.getName());
}

الإرجاع

User[] — قائمة المشاهدين والمعلِّقين على Folder هذا إذا أجرى المستخدم تعديلاً وصول أو صفيفة فارغة في الحالات الأخرى.

التفويض

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

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

isShareableByEditors()

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

الإرجاع

Booleantrue إذا تم السماح للمستخدمين الذين لديهم أذونات تعديل بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات 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 في مهملات حساب المستخدم على 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 مع عنوان URL للمستخدم النطاق بالكامل، أو إذا كان Folder في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

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

المعلمات

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

الإرجاع

FolderFolder هذا للسلسلة.

التفويض

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

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

removeViewer(user)

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

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

المعلمات

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

الإرجاع

FolderFolder هذا للسلسلة.

التفويض

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

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

revokePermissions(emailAddress)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

revokePermissions(user)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

searchFiles(params)

جلب مجموعة من كل الملفات الثانوية للمجلد الحالي والتي تتطابق مع عملية البحث المحدّدة المعايير. يمكنك الاطّلاع على معايير البحث بالتفصيل في مستندات حزمة تطوير البرامج (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 that are children of the current folder and modified after February 28,
// 2022 whose name contains "untitled.""
var files = DriveApp.getRootFolder().searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var 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)

جلب مجموعة من كل المجلدات الثانوية للمجلد الحالي والتي تتطابق مع عملية البحث المحدّدة المعايير. يمكنك الاطّلاع على معايير البحث بالتفصيل في مستندات حزمة تطوير البرامج (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 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();
  console.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

الإرجاع

FolderFolder هذا، للسلسلة

التفويض

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

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

setName(name)

لضبط اسم Folder.

المعلمات

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

الإرجاع

FolderFolder هذا، للسلسلة

التفويض

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

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

setOwner(emailAddress)

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

المعلمات

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

الإرجاع

FolderFolder هذا، للسلسلة

التفويض

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

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

setOwner(user)

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

المعلمات

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

الإرجاع

FolderFolder هذا، للسلسلة

التفويض

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

  • 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 إذا لم يكن كذلك

الإرجاع

FolderFolder هذا، للسلسلة

التفويض

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

  • 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

الإرجاع

FolderFolder هذا، للسلسلة

التفويض

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

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

setStarred(starred)

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

المعلمات

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

الإرجاع

FolderFolder هذا، للسلسلة

التفويض

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

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

setTrashed(trashed)

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

المعلمات

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

الإرجاع

FolderFolder هذا، للسلسلة

التفويض

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

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

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