تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

الطرق المتوقّفة

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`addFile(child)`	`Folder`	تُضيف هذه الدالة الملف المحدَّد إلى المجلد الحالي.
`addFolder(child)`	`Folder`	تُضيف هذه الدالة المجلد المحدَّد إلى المجلد الحالي.
`removeFile(child)`	`Folder`	تزيل هذه الدالة الملف المحدَّد من المجلد الحالي.
`removeFolder(child)`	`Folder`	تزيل المجلد المحدَّد من المجلد الحالي.

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

`addEditor(emailAddress)`

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

المعلمات

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

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة.

التفويض

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

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

`addEditor(user)`

المعلمات

الاسم	النوع	الوصف
`user`	`User`	تمثيل للمستخدم المطلوب إضافته

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة.

التفويض

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

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

`addEditors(emailAddresses)`

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

المعلمات

الاسم	النوع	الوصف
`emailAddresses`	`String[]`	صفيف من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتهم

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة.

التفويض

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

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

`addViewer(emailAddress)`

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

المعلمات

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

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة.

التفويض

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

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

`addViewer(user)`

المعلمات

الاسم	النوع	الوصف
`user`	`User`	تمثيل للمستخدم المطلوب إضافته

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة.

التفويض

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

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

`addViewers(emailAddresses)`

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

المعلمات

الاسم	النوع	الوصف
`emailAddresses`	`String[]`	صفيف من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتهم

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة.

التفويض

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

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

`createFile(blob)`

لإنشاء ملف في المجلد الحالي من Blob معيّن من البيانات العشوائية

المعلمات

الاسم	النوع	الوصف
`blob`	`BlobSource`	بيانات الملف الجديد.

الإرجاع

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!');

المعلمات

الاسم	النوع	الوصف
`name`	`String`	اسم الملف الجديد
`content`	`String`	محتوى الملف الجديد.

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`name`	`String`	اسم الملف الجديد
`content`	`String`	محتوى الملف الجديد.
`mimeType`	`String`	نوع MIME للملف الجديد

الإرجاع

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

التفويض

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

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

`createFolder(name)`

يؤدي هذا الخيار إلى إنشاء مجلد في المجلد الحالي بالاسم المحدَّد.

المعلمات

الاسم	النوع	الوصف
`name`	`String`	اسم المجلد الجديد

الإرجاع

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

التفويض

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

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

`createShortcut(targetId)`

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

المعلمات

الاسم	النوع	الوصف
`targetId`	`String`	رقم تعريف الملف أو المجلد المستهدف

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`targetId`	`String`	رقم تعريف الملف أو المجلد المستهدف
`targetResourceKey`	`String`	مفتاح الموارد للملف أو المجلد المستهدف

الإرجاع

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

التفويض

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

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

`getAccess(email)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`getAccess(user)`

المعلمات

الاسم	النوع	الوصف
`user`	`User`	تمثيل للمستخدم الذي يجب التحقّق من أذوناته

الإرجاع

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

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

المعلمات

الاسم	النوع	الوصف
`name`	`String`	اسم الملفات المطلوب العثور عليها

الإرجاع

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

التفويض

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

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

`getFilesByType(mimeType)`

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

المعلمات

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

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

المعلمات

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

الإرجاع

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

الإرجاع

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. إذا لم يكن لدى المستخدم الذي executes the script إذن وصول للتعديل إلى 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)`

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

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

المعلمات

الاسم	النوع	الوصف
`destination`	`Folder`	المجلد الذي يصبح المجلد الرئيسي الجديد.

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة.

التفويض

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

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

`removeEditor(emailAddress)`

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

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

المعلمات

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

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة.

التفويض

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

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

`removeEditor(user)`

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

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

المعلمات

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

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة.

التفويض

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

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

`removeViewer(emailAddress)`

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

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

المعلمات

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

الإرجاع

Folder — هذا Folder لإنشاء سلسلة.

التفويض

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

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

`removeViewer(user)`

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

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

المعلمات

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

الإرجاع

Folder — هذا Folder لإنشاء سلسلة.

التفويض

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

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

`revokePermissions(emailAddress)`

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

المعلمات

الاسم	النوع	الوصف
`emailAddress`	`String`	عنوان البريد الإلكتروني للمستخدم الذي يجب إلغاء إذن وصوله.

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة.

التفويض

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

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

`revokePermissions(user)`

المعلمات

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

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`params`	`String`	معايير البحث، كما هو موضّح بالتفصيل في مستندات 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.

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`setDescription(description)`

لضبط وصف Folder.

المعلمات

الاسم	النوع	الوصف
`description`	`String`	الوصف الجديد لل`Folder`

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة

التفويض

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

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

`setName(name)`

لضبط اسم Folder.

المعلمات

الاسم	النوع	الوصف
`name`	`String`	الاسم الجديد لل`Folder`

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة

التفويض

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

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

`setOwner(emailAddress)`

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

المعلمات

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

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة

التفويض

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

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

`setOwner(user)`

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

المعلمات

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

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة

التفويض

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

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

`setSecurityUpdateEnabled(enabled)`

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

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

المعلمات

الاسم	النوع	الوصف
`enabled`	`Boolean`	ما إذا كان سيتم تفعيل متطلّبات مفتاح المورد في `Folder`

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة.

التفويض

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

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

`setShareableByEditors(shareable)`

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

المعلمات

الاسم	النوع	الوصف
`shareable`	`Boolean`	`true` إذا كان يجب السماح للمستخدمين الذين لديهم أذونات تعديل بالمشاركة مع المستخدمين الآخرين أو تغيير الأذونات `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);

المعلمات

الاسم	النوع	الوصف
`accessType`	`Access`	فئة المستخدمين الذين يجب أن يكون بإمكانهم الوصول إلى `Folder`
`permissionType`	`Permission`	الأذونات التي يجب منحها للمستخدمين الذين يمكنهم الوصول إلى `Folder`

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة

التفويض

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

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

`setStarred(starred)`

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

المعلمات

الاسم	النوع	الوصف
`starred`	`Boolean`	`true` إذا كان يجب وضع علامة النجمة على `Folder` في حساب المستخدم على Drive، `false` إذا لم يكن الأمر كذلك

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة

التفويض

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

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

`setTrashed(trashed)`

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

المعلمات

الاسم	النوع	الوصف
`trashed`	`Boolean`	`true` إذا كان يجب نقل `Folder` إلى المهملات في مساحة التخزين على Drive الخاصة بالمستخدم، `false` إذا لم يكن الأمر كذلك

الإرجاع

Folder — هذا الرمز Folder، لإنشاء سلسلة

التفويض

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

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

الطرق المتوقّفة

`addFile(child)`

تمّ إيقاف هذا العمود نهائيًا. بدلاً من ذلك، استخدِم File.moveTo(destination) أو createShortcut(targetId).

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

المعلمات

الاسم	النوع	الوصف
`child`	`File`	الملف الفرعي المطلوب إضافته

الإرجاع

Folder: الملف الرئيسي الجديد للملف الذي تمت إضافته كملف فرعي

التفويض

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

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

`addFolder(child)`

تمّ إيقاف هذا العمود نهائيًا. بدلاً من ذلك، استخدِم moveTo(destination) أو createShortcut(targetId).

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

المعلمات

الاسم	النوع	الوصف
`child`	`Folder`	المجلد الفرعي المطلوب إضافته

الإرجاع

Folder: المجلد الرئيسي الجديد للمجلد الذي تمت إضافته كمجلد فرعي.

التفويض

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

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

`removeFile(child)`

تمّ إيقاف هذا العمود نهائيًا. واستخدِم File.moveTo(destination) بدلاً من ذلك.

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

المعلمات

الاسم	النوع	الوصف
`child`	`File`	الملف الفرعي المطلوب إزالته

الإرجاع

Folder: العنصر الرئيسي السابق للعنصر الفرعي

التفويض

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

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

`removeFolder(child)`

تمّ إيقاف هذا العمود نهائيًا. واستخدِم moveTo(destination) بدلاً من ذلك.

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

المعلمات

الاسم	النوع	الوصف
`child`	`Folder`	المجلد الفرعي المطلوب إزالته

الإرجاع

Folder: العنصر الرئيسي السابق للعنصر الفرعي

التفويض

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

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