تمت ترجمة هذه الصفحة بواسطة 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());
}

أماكن إقامة

الموقع	النوع	الوصف
`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`	تفعيل أو إيقاف فرض سلوك الأهل الوحيد لجميع المكالمات التي تؤثر في العناصر الرئيسية للعناصر.
`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 معيّنة من البيانات العشوائية.

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

المعلمات

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

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

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

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

المعلمات

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

المعلمات

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

المعلمات

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

المعلمات

الاسم	النوع	الوصف
`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 للمستخدم. لا تؤدي هذه الطريقة إلى نقل الملف خارج المجلد الرئيسي الحالي يمكن أن يكون للملف أكثر من أصل في وقت واحد.

المعلمات

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