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

Class DriveApp

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

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

أماكن إقامة

الموقع	Type	الوصف
`Access`	`Access`	تعداد يمثل فئات المستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، إلى جانب أي مستخدمين فرديين تم منحهم حق الوصول بشكلٍ صريح.
`Permission`	`Permission`	تعداد يمثّل الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكلٍ صريح.

الطُرق

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

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

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

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

`continueFileIterator(continuationToken)`

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

// Continues getting a list of all 'Untitled document' files in the user's Drive.
// Creates a file iterator named 'previousIterator'.
const previousIterator = DriveApp.getFilesByName('Untitled document');

// Gets continuation token from the previous file iterator.
const continuationToken = previousIterator.getContinuationToken();

// Creates a new iterator using the continuation token from the previous file iterator.
const newIterator = DriveApp.continueFileIterator(continuationToken);

// Resumes the file iteration using a continuation token from 'firstIterator' and
// logs the file name.
if (newIterator.hasNext()) {
  const file = newIterator.next();
  console.log(file.getName());
}

المَعلمات

الاسم	Type	الوصف
`continuationToken`	`String`	رمز مميز للمتابعة من مُكرّر ملف سابق.

استرجاع الكرة

FileIterator: مجموعة من الملفات التي بقيت في مُكرّر سابق عند إنشاء الرمز المميّز للمتابعة.

`continueFolderIterator(continuationToken)`

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

// Continues getting a list of all folders in user's Drive.
// Creates a folder iterator named 'previousIterator'.
const previousIterator = DriveApp.getFolders();

// Gets continuation token from the previous folder iterator.
const continuationToken = previousIterator.getContinuationToken();

// Creates a new iterator using the continuation token from the previous folder iterator.
const newIterator = DriveApp.continueFolderIterator(continuationToken);

// Resumes the folder iteration using a continuation token from the previous iterator and logs
// the folder name.
if (newIterator.hasNext()) {
  const folder = newIterator.next();
  console.log(folder.getName());
}

المَعلمات

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

استرجاع الكرة

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

`createFile(blob)`

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

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

`createFile(name, content)`

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

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

`createFile(name, content, mimeType)`

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

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

المَعلمات

الاسم	Type	الوصف
`name`	`String`	اسم الملف الجديد
`content`	`String`	محتوى الملف الجديد.
`mimeType`	`String`	تمثّل هذه السمة نوع MIME للملف الجديد.

استرجاع الكرة

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

التفويض

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

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

`createFolder(name)`

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

المَعلمات

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

استرجاع الكرة

Folder — المجلد الجديد

التفويض

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

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

`createShortcut(targetId)`

إنشاء اختصار لمعرّف عنصر Drive المقدَّم، وإرجاعه

المَعلمات

الاسم	Type	الوصف
`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());
}

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

`enforceSingleParent(value)`

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

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

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

المَعلمات

الاسم	Type	الوصف
`value`	`Boolean`	الحالة الجديدة لعلامة forceSingleParent.

التفويض

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

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

`getFileById(id)`

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace 'Test' with your file name.
const files = DriveApp.getFilesByName('Test');

if (files.hasNext()) {
  // Gets the ID of each file in the list.
  const fileId = files.next().getId();

  // Gets the file name using its ID and logs it to the console.
  console.log(DriveApp.getFileById(fileId).getName());
}

المَعلمات

الاسم	Type	الوصف
`id`	`String`	رقم تعريف الملف.

استرجاع الكرة

File — الملف الذي يتضمن المعرّف المحدّد

التفويض

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

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

`getFileByIdAndResourceKey(id, resourceKey)`

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

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

// Gets a list of all files in Drive with the given name.
// TODO(developer): Replace 'Test' with your file name.
const files = DriveApp.getFilesByName('Test');
if (files.hasNext()) {

  // Gets the first file in the list.
  const file = files.next();

  // Gets the ID and resource key.
  const key = file.getResourceKey();
  const id = file.getId();

  // Logs the file name to the console using its ID and resource key.
  console.log(DriveApp.getFileByIdAndResourceKey(id, key).getName());
}

المَعلمات

الاسم	Type	الوصف
`id`	`String`	رقم تعريف الملف.
`resourceKey`	`String`	مفتاح المصدر للمجلد.

استرجاع الكرة

File — الملف الذي يتضمن المعرّف المحدّد

التفويض

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

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

`getFiles()`

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

استرجاع الكرة

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

التفويض

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

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

`getFilesByName(name)`

تحصل على مجموعة من جميع الملفات في Drive للمستخدم والتي تحمل الاسم الأول.

المَعلمات

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

استرجاع الكرة

FileIterator - مجموعة من كل الملفات في حساب المستخدم على Drive والتي تحمل الاسم الأول.

التفويض

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

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

`getFilesByType(mimeType)`

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

المَعلمات

الاسم	Type	الوصف
`mimeType`	`String`	تمثّل هذه السمة نوع MIME للملفات المطلوب البحث عنها.

استرجاع الكرة

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

التفويض

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

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

`getFolderById(id)`

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

المَعلمات

الاسم	Type	الوصف
`id`	`String`	رقم تعريف المجلد.

استرجاع الكرة

Folder — المجلد الذي يحمل المعرّف المحدّد

التفويض

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

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

`getFolderByIdAndResourceKey(id, resourceKey)`

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

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

المَعلمات

الاسم	Type	الوصف
`id`	`String`	رقم تعريف المجلد.
`resourceKey`	`String`	مفتاح المصدر للمجلد.

استرجاع الكرة

Folder — المجلد الذي يحمل المعرّف المحدّد

التفويض

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

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

`getFolders()`

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

استرجاع الكرة

FolderIterator - مجموعة من كل المجلدات في حساب المستخدم على Drive

التفويض

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

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

`getFoldersByName(name)`

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

المَعلمات

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

استرجاع الكرة

FolderIterator — مجموعة من كل المجلدات في حساب المستخدم على Drive والتي تحمل الاسم الأول.

التفويض

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

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

`getRootFolder()`

يحصل على المجلد في جذر حساب Drive للمستخدم.

// Gets the user's My Drive folder and logs its name to the console.
console.log(DriveApp.getRootFolder().getName());

// Logs the Drive owner's name to the console.
console.log(DriveApp.getRootFolder().getOwner().getName());

استرجاع الكرة

Folder - المجلد الجذر في حساب Drive للمستخدم.

التفويض

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

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

`getStorageLimit()`

الحصول على عدد وحدات البايت المسموح للمستخدم بتخزينها في Drive.

// Gets the number of bytes the user can store in Drive and logs it to the console.
console.log(DriveApp.getStorageLimit());

استرجاع الكرة

Integer — عدد وحدات البايت التي يُسمح للمستخدم بتخزينها في Drive.

التفويض

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

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

`getStorageUsed()`

الحصول على عدد وحدات البايت التي يخزّنها المستخدم حاليًا في Drive.

// Gets the number of bytes the user is currently storing in Drive and logs it to the console.
console.log(DriveApp.getStorageUsed());

استرجاع الكرة

Integer — عدد وحدات البايت التي يخزِّنها المستخدم حاليًا في Drive.

التفويض

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

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

`getTrashedFiles()`

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

// Gets a list of all the files in the trash of the user's Drive.
const trashFiles = DriveApp.getTrashedFiles();

// Logs the trash file names to the console.
while (trashFiles.hasNext()) {
  const file = trashFiles.next();
  console.log(file.getName());
}

استرجاع الكرة

FileIterator - مجموعة من الملفات في المهملات.

التفويض

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

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

`getTrashedFolders()`

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

// Gets a collection of all the folders in the trash of the user's Drive.
const trashFolders = DriveApp.getTrashedFolders();

// Logs the trash folder names to the console.
while (trashFolders.hasNext()) {
  const folder = trashFolders.next();
  console.log(folder.getName());
}

استرجاع الكرة

FolderIterator — مجموعة من المجلدات في المهملات.

التفويض

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

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

`searchFiles(params)`

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

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

// Logs the name of every file in the user's Drive that modified after February 28,
// 2022 whose name contains "untitled.""
var files = DriveApp.searchFiles(
    'modifiedDate > "2022-02-28" and title contains "untitled"');
while (files.hasNext()) {
  var file = files.next();
  console.log(file.getName());
}

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

`searchFolders(params)`

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

// Logs the name of every folder in the user's Drive that you own and is starred.
var folders = DriveApp.searchFolders('starred = true and "me" in owners');
while (folders.hasNext()) {
  var folder = folders.next();
  console.log(folder.getName());
}

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

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

`addFile(child)`

تمت إزالة هذا العمود. وبدلاً من ذلك، استخدِم File.moveTo(destination) أو Folder.createShortcut(targetId).

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

المَعلمات

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

استرجاع الكرة

Folder: العنصر الرئيسي الجديد للملف الذي تمت إضافته كطفل ثانوي

التفويض

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

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

`addFolder(child)`

تمت إزالة هذا العمود. وبدلاً من ذلك، استخدِم Folder.moveTo(destination) أو Folder.createShortcut(targetId).

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

`removeFile(child)`

تمت إزالة هذا العمود. واستخدِم File.moveTo(destination) بدلاً من ذلك.

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

المَعلمات

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

استرجاع الكرة

Folder - حساب الوالد السابق للطفل

التفويض

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

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

`removeFolder(child)`

تمت إزالة هذا العمود. واستخدِم Folder.moveTo(destination) بدلاً من ذلك.

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

المَعلمات

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

استرجاع الكرة

Folder - حساب الوالد السابق للطفل

التفويض

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

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