Class DriveApp

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

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

الخصائص

الموقع	النوع	الوصف
`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`	تفعيل أو إيقاف السلوك enforceSingleParent لجميع عمليات الاستدعاء التي تؤثر في العناصر الرئيسية
`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());
}

المعلمات

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

المعلمات

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

الإرجاع

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

`createFile(blob)`

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

المعلمات

الاسم	النوع	الوصف
`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!');

المعلمات

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`createFolder(name)`

ينشئ هذا الإجراء مجلدًا في جذر حساب المستخدم على Drive بالاسم المحدّد.

المعلمات

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

`enforceSingleParent(value)`

تفعيل أو إيقاف السلوك enforceSingleParent لجميع عمليات الاستدعاء التي تؤثر في العناصر الرئيسية

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

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

المعلمات

الاسم	النوع	الوصف
`value`	`Boolean`	الحالة الجديدة للعَلم enforceSingleParent.

التفويض

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

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

المعلمات

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

المعلمات

الاسم	النوع	الوصف
`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 الخاصة بالمستخدم والتي تحمل الاسم المحدّد.

المعلمات

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

الإرجاع

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

التفويض

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

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

`getFilesByType(mimeType)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`getFolderById(id)`

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

المعلمات

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

الإرجاع

استبدِل Folder بالمجلد الذي يحمل رقم التعريف المحدّد.

التفويض

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

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

`getFolderByIdAndResourceKey(id, resourceKey)`

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

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

المعلمات

الاسم	النوع	الوصف
`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 الخاص بالمستخدم والتي تحمل الاسم المحدّد.

المعلمات

الاسم	النوع	الوصف
`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 التي تتطابق مع معايير البحث المحدّدة. تتوفّر تفاصيل معايير البحث في مستندات 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 in the user's Drive that modified after February 28,
// 2022 whose name contains "untitled.""
const files = DriveApp.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: مجموعة من جميع الملفات في حساب Drive الخاص بالمستخدم التي تطابق معايير البحث.

التفويض

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

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

`searchFolders(params)`

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

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

`addFile(child)`

تمّت إزالة هذا العمود. يُرجى استخدام File.moveTo(destination) أو Folder.createShortcut(targetId) بدلاً من ذلك.

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`addFolder(child)`

تمّت إزالة هذا العمود. يُرجى استخدام Folder.moveTo(destination) أو Folder.createShortcut(targetId) بدلاً من ذلك.

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`removeFile(child)`

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

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

المعلمات

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

الإرجاع

‫Folder: العنصر الرئيسي السابق للعنصر الثانوي

التفويض

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

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

`removeFolder(child)`

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

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

المعلمات

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

الإرجاع

‫Folder: العنصر الرئيسي السابق للعنصر الثانوي

التفويض

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

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

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

الخصائص

الطُرق

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

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

continueFileIterator(continuationToken)

المعلمات

الإرجاع

continueFolderIterator(continuationToken)

المعلمات

الإرجاع

createFile(blob)

المعلمات

الإرجاع

التفويض

createFile(name, content)

المعلمات

الإرجاع

التفويض

createFile(name, content, mimeType)

المعلمات

الإرجاع

التفويض

createFolder(name)

المعلمات

الإرجاع

التفويض

createShortcut(targetId)

المعلمات

الإرجاع

التفويض

createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)

المعلمات

الإرجاع

التفويض

enforceSingleParent(value)

المعلمات

التفويض

getFileById(id)

المعلمات

الإرجاع

التفويض

getFileByIdAndResourceKey(id, resourceKey)

المعلمات

الإرجاع

التفويض

getFiles()

الإرجاع

التفويض

getFilesByName(name)

المعلمات

الإرجاع

التفويض

getFilesByType(mimeType)

المعلمات

الإرجاع

التفويض

getFolderById(id)

المعلمات

الإرجاع

التفويض

getFolderByIdAndResourceKey(id, resourceKey)

المعلمات

الإرجاع

التفويض

getFolders()

الإرجاع

التفويض

getFoldersByName(name)

المعلمات

الإرجاع

التفويض

getRootFolder()

الإرجاع

التفويض

getStorageLimit()

الإرجاع

التفويض

getStorageUsed()

الإرجاع

Class DriveApp

`continueFileIterator(continuationToken)`

`continueFolderIterator(continuationToken)`

`createFile(blob)`

`createFile(name, content)`

`createFile(name, content, mimeType)`

`createFolder(name)`

`createShortcut(targetId)`

`createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)`

`enforceSingleParent(value)`

`getFileById(id)`

`getFileByIdAndResourceKey(id, resourceKey)`

`getFiles()`

`getFilesByName(name)`

`getFilesByType(mimeType)`

`getFolderById(id)`

`getFolderByIdAndResourceKey(id, resourceKey)`

`getFolders()`

`getFoldersByName(name)`

`getRootFolder()`

`getStorageLimit()`

`getStorageUsed()`

`getTrashedFiles()`

`getTrashedFolders()`

`searchFiles(params)`

`searchFolders(params)`

`addFile(child)`

`addFolder(child)`

`removeFile(child)`

`removeFolder(child)`