يسمح هذا الإعداد للنصوص البرمجية بإنشاء الملفات والمجلدات والبحث عنها وتعديلها في 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 للمستخدم التي تتطابق مع معايير البحث المحددة. |
الوثائق التفصيلية
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)
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.
الوسيطة params
هي سلسلة طلب بحث يمكن أن تحتوي على قيم سلسلة، لذا احرص على
تجنّب علامات الاقتباس بشكل صحيح (على سبيل المثال "title contains 'Gulliver\\'s
Travels'"
أو 'title contains "Gulliver\'s Travels"'
).
// 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