مجلد في Google Drive يمكن الوصول إلى المجلدات أو إنشاؤها من "DriveApp
".
// Log the name of every folder in the user's Drive. var folders = DriveApp.getFolders(); while (folders.hasNext()) { var folder = folders.next(); Logger.log(folder.getName()); }
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
addEditor(emailAddress) | Folder | لإضافة المستخدم المحدّد إلى قائمة المحرِّرين في Folder . |
addEditor(user) | Folder | لإضافة المستخدم المحدّد إلى قائمة المحرِّرين في Folder . |
addEditors(emailAddresses) | Folder | لإضافة مجموعة المستخدمين المحدّدة إلى قائمة المحرِّرين في Folder . |
addViewer(emailAddress) | Folder | لإضافة المستخدم المحدّد إلى قائمة المشاهدين في Folder . |
addViewer(user) | Folder | لإضافة المستخدم المحدّد إلى قائمة المشاهدين في Folder . |
addViewers(emailAddresses) | Folder | لإضافة مصفوفة المستخدمين المحددة إلى قائمة العارضين لـ Folder . |
createFile(blob) | File | تنشئ هذه الدالة ملفًا في المجلد الحالي من Blob محدّد من البيانات العشوائية. |
createFile(name, content) | File | لإنشاء ملف نصي في المجلد الحالي بالاسم ومحتوياته. |
createFile(name, content, mimeType) | File | ينشئ ملفًا في المجلد الحالي بالاسم والمحتويات ونوع MIME. |
createFolder(name) | Folder | لإنشاء مجلد في المجلد الحالي بالاسم الذي أدخلته. |
createShortcut(targetId) | File | إنشاء اختصار لمعرّف عنصر Drive المقدَّم، وإرجاعه |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | ينشئ اختصارًا لمعرّف عنصر Drive ومفتاح المصدر اللذين تم تقديمهما، ويعرضهما. |
getAccess(email) | Permission | يحصل على الإذن الذي تم منحه للمستخدم المحدّد. |
getAccess(user) | Permission | يحصل على الإذن الذي تم منحه للمستخدم المحدّد. |
getDateCreated() | Date | يعرض هذا الحقل تاريخ إنشاء Folder . |
getDescription() | String | للحصول على وصف Folder . |
getEditors() | User[] | يمكنك الحصول على قائمة بالمحرِّرين في Folder . |
getFiles() | FileIterator | تحصل على مجموعة من جميع الملفات الثانوية للمجلد الحالي. |
getFilesByName(name) | FileIterator | تحصل على مجموعة من جميع الملفات الثانوية للمجلد الحالي والتي تحمل الاسم المعني. |
getFilesByType(mimeType) | FileIterator | الحصول على مجموعة من جميع الملفات الثانوية للمجلد الحالي والتي تحتوي على نوع MIME المحدّد. |
getFolders() | FolderIterator | تحصل على مجموعة من كل المجلدات الثانوية للمجلد الحالي. |
getFoldersByName(name) | FolderIterator | للحصول على مجموعة من كل المجلدات الثانوية للمجلد الحالي والتي تحمل الاسم المعني. |
getId() | String | الحصول على رقم تعريف Folder |
getLastUpdated() | Date | يمكنك الحصول على تاريخ آخر تعديل لـ Folder . |
getName() | String | يحصل على اسم Folder . |
getOwner() | User | الحصول على مالك جهاز "Folder " هذا |
getParents() | FolderIterator | للحصول على مجموعة من المجلدات التي تمثّل عناصر رئيسية مباشرة لـ Folder . |
getResourceKey() | String | الحصول على مفتاح المورد الخاص بـ Folder المطلوب للوصول إلى العناصر التي تمت مشاركتها باستخدام رابط |
getSecurityUpdateEligible() | Boolean | معرفة ما إذا كان Folder هذا مؤهَّلاً لتطبيق تحديث الأمان الذي
يتطلب مفتاح مورد للوصول إليه عند مشاركته باستخدام رابط. |
getSecurityUpdateEnabled() | Boolean | تتيح لك معرفة ما إذا كان Folder هذا يتطلّب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط. |
getSharingAccess() | Access | لمعرفة فئة المستخدمين الذين يمكنهم الوصول إلى Folder ، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكلٍ صريح. |
getSharingPermission() | Permission | يحصل على الإذن الممنوح لهؤلاء المستخدمين الذين يمكنهم الوصول إلى Folder ،
بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً. |
getSize() | Integer | الحصول على عدد وحدات البايت المستخدمة لتخزين Folder في Drive. |
getUrl() | String | الحصول على عنوان URL يمكن استخدامه لفتح Folder في أحد تطبيقات Google، مثل
Drive أو "مستندات Google". |
getViewers() | User[] | للحصول على قائمة المشاهدين والمعلقين على Folder هذا. |
isShareableByEditors() | Boolean | تحدِّد هذه السياسة ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل سياسة Folder
بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات. |
isStarred() | Boolean | تحدِّد هذه السياسة ما إذا كان قد تم تمييز Folder بنجمة في حساب Drive للمستخدم. |
isTrashed() | Boolean | تحدِّد هذه السياسة ما إذا كان ملف "Folder " في مهملات حساب Drive الخاص بالمستخدم. |
moveTo(destination) | Folder | ينقل هذا العنصر إلى مجلد الوجهة المحدَّد. |
removeEditor(emailAddress) | Folder | لإزالة المستخدم المحدّد من قائمة المحرِّرين في Folder . |
removeEditor(user) | Folder | لإزالة المستخدم المحدّد من قائمة المحرِّرين في Folder . |
removeViewer(emailAddress) | Folder | لإزالة المستخدم المحدّد من قائمة المشاهدين والمعلقين في Folder . |
removeViewer(user) | Folder | لإزالة المستخدم المحدّد من قائمة المشاهدين والمعلقين في Folder . |
revokePermissions(emailAddress) | Folder | لإلغاء إمكانية الوصول إلى Folder التي تم منحها للمستخدم المحدّد. |
revokePermissions(user) | Folder | لإلغاء إمكانية الوصول إلى Folder التي تم منحها للمستخدم المحدّد. |
searchFiles(params) | FileIterator | الحصول على مجموعة من جميع الملفات الثانوية للمجلد الحالي والتي تطابق معايير البحث المحددة. |
searchFolders(params) | FolderIterator | للحصول على مجموعة من كل المجلدات التي تمثّل عناصر ثانوية للمجلد الحالي والتي تتطابق مع معايير البحث المحدّدة. |
setDescription(description) | Folder | لضبط وصف Folder . |
setName(name) | Folder | لضبط اسم Folder . |
setOwner(emailAddress) | Folder | تغيير مالك Folder . |
setOwner(user) | Folder | تغيير مالك Folder . |
setSecurityUpdateEnabled(enabled) | Folder | تحدّد هذه السياسة ما إذا كان Folder يتطلّب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط. |
setShareableByEditors(shareable) | Folder | يحدّد هذا الإعداد ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل Folder بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات. |
setSharing(accessType, permissionType) | Folder | تحدّد فئة المستخدمين الذين يمكنهم الوصول إلى Folder والأذونات التي يمنحها هؤلاء المستخدمون، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً. |
setStarred(starred) | Folder | تحدِّد هذه السياسة ما إذا كان سيتم تمييز Folder بنجمة في حساب Drive للمستخدم. |
setTrashed(trashed) | Folder | تحدِّد هذه السياسة ما إذا كان Folder في مهملات حساب Drive للمستخدم. |
الوثائق التفصيلية
addEditor(emailAddress)
لإضافة المستخدم المحدّد إلى قائمة المحرِّرين في Folder
. إذا كان المستخدم مدرجًا في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إضافته. |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addEditor(user)
لإضافة المستخدم المحدّد إلى قائمة المحرِّرين في Folder
. إذا كان المستخدم مدرجًا في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم تتم إضافته. |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addEditors(emailAddresses)
لإضافة مجموعة المستخدمين المحدّدة إلى قائمة المحرِّرين في Folder
. إذا كان أيٌّ من المستخدمين مدرجًا في قائمة المشاهدين، تعمل هذه الطريقة على الترويج له خارج قائمة المشاهدين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المراد إضافتها. |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addViewer(emailAddress)
لإضافة المستخدم المحدّد إلى قائمة المشاهدين في Folder
. إذا كان المستخدم بالفعل في قائمة
المحررين، فلن يكون لهذه الطريقة أي تأثير.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إضافته. |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addViewer(user)
لإضافة المستخدم المحدّد إلى قائمة المشاهدين في Folder
. إذا كان المستخدم بالفعل في قائمة
المحررين، فلن يكون لهذه الطريقة أي تأثير.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم تتم إضافته. |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addViewers(emailAddresses)
لإضافة مصفوفة المستخدمين المحددة إلى قائمة العارضين لـ Folder
. إذا كان أي من المستخدمين مدرجًا بالفعل في قائمة المحررين، فلن يكون لهذه الطريقة أي تأثير عليهم.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المراد إضافتها. |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
createFile(blob)
تنشئ هذه الدالة ملفًا في المجلد الحالي من 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.getRootFolder().createFile(blob);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
blob | BlobSource | بيانات الملف الجديد. |
استرجاع الكرة
File
— الملف الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
createFile(name, content)
لإنشاء ملف نصي في المجلد الحالي بالاسم ومحتوياته. يضع استثناءً
إذا كان حجم content
أكبر من 50 ميغابايت.
// Create a text file with the content "Hello, world!" DriveApp.getRootFolder().createFile('New Text File', 'Hello, world!');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
name | String | اسم الملف الجديد |
content | String | محتوى الملف الجديد. |
استرجاع الكرة
File
— الملف الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
createFile(name, content, mimeType)
ينشئ ملفًا في المجلد الحالي بالاسم والمحتويات ونوع MIME. يتم طرح استثناء
إذا كان حجم content
أكبر من 10 ميغابايت.
// Create an HTML file with the content "Hello, world!" DriveApp.getRootFolder().createFile('New HTML File', '<b>Hello, world!</b>', MimeType.HTML);
المَعلمات
الاسم | 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
getAccess(email)
يحصل على الإذن الذي تم منحه للمستخدم المحدّد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
email | String | عنوان البريد الإلكتروني للمستخدم الذي يجب التحقق من أذوناته |
استرجاع الكرة
Permission
- الأذونات الممنوحة للمستخدم
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getAccess(user)
يحصل على الإذن الذي تم منحه للمستخدم المحدّد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم الذي يجب التحقق من أذوناته |
استرجاع الكرة
Permission
- الأذونات الممنوحة للمستخدم
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getDateCreated()
getDescription()
getEditors()
يمكنك الحصول على قائمة بالمحرِّرين في Folder
. وإذا لم يكن لدى المستخدم الذي ينفّذ النص البرمجي الإذن بتعديل المحتوى في Folder
، تعرض هذه الطريقة صفيفًا فارغًا.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the list of editors and logs their names to the console. const editors = folder.getEditors(); for (editor of editors) { console.log(editor.getName()); }
استرجاع الكرة
User[]
: قائمة بالمحرّرين في عنصر Folder
هذا إذا كان لدى المستخدم الإذن بتعديل المحتوى أو إذا كان لدى المستخدم مصفوفة فارغة بخلاف ذلك.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFiles()
تحصل على مجموعة من جميع الملفات الثانوية للمجلد الحالي.
استرجاع الكرة
FileIterator
- مجموعة من كل الملفات الثانوية للمجلد الحالي.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFilesByName(name)
تحصل على مجموعة من جميع الملفات الثانوية للمجلد الحالي والتي تحمل الاسم المعني.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
name | String | اسم الملفات المطلوب البحث عنها |
استرجاع الكرة
FileIterator
: مجموعة من كل الملفات الثانوية للمجلد الحالي والتي تحمل الاسم الأول
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFilesByType(mimeType)
الحصول على مجموعة من جميع الملفات الثانوية للمجلد الحالي والتي تحتوي على نوع MIME المحدّد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
mimeType | String | تمثّل هذه السمة نوع MIME للملفات المطلوب البحث عنها. |
استرجاع الكرة
FileIterator
- مجموعة من كل الملفات الثانوية للمجلد الحالي والتي تحتوي على نوع MIME المحدّد.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFolders()
تحصل على مجموعة من كل المجلدات الثانوية للمجلد الحالي.
استرجاع الكرة
FolderIterator
: مجموعة من كل المجلدات الثانوية للمجلد الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFoldersByName(name)
للحصول على مجموعة من كل المجلدات الثانوية للمجلد الحالي والتي تحمل الاسم المعني.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
name | String | اسم المجلدات التي تريد البحث عنها |
استرجاع الكرة
FolderIterator
- مجموعة من كل المجلدات الفرعية للمجلد الحالي والتي تحمل الاسم الأول.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getId()
getLastUpdated()
getName()
getOwner()
الحصول على مالك جهاز "Folder
" هذا
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the owner of the folder and logs the name to the console. const folderOwner = folder.getOwner(); console.log(folderOwner.getName());
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getParents()
للحصول على مجموعة من المجلدات التي تمثّل عناصر رئيسية مباشرة لـ Folder
.
استرجاع الكرة
FolderIterator
- مجموعة من المجلدات التي تمثّل عناصر رئيسية مباشرة لـ Folder
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getResourceKey()
الحصول على مفتاح المورد الخاص بـ Folder
المطلوب للوصول إلى العناصر التي تمت مشاركتها باستخدام رابط
استرجاع الكرة
String
: مفتاح المصدر لـ Folder
.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEligible()
معرفة ما إذا كان Folder
هذا مؤهَّلاً لتطبيق تحديث الأمان الذي
يتطلب مفتاح مورد للوصول إليه عند مشاركته باستخدام رابط.
يتطلب Drive مفتاح مورد للوصول إلى بعض الملفات أو المجلدات التي تمت مشاركتها باستخدام
رابط. هذا التغيير جزء من تحديث أمان. يتم تفعيل التحديث تلقائيًا للملفات
والمجلدات المؤهَّلة. لتفعيل متطلبات مفتاح المورد أو إيقافها للملفات المؤهَّلة، استخدِم
setSecurityUpdateEnabled
.
تعرّف على مزيد من المعلومات حول تحديث الأمان في Google Drive.
استرجاع الكرة
Boolean
: لتحديد ما إذا كان من الممكن تطبيق شرط مفتاح المورد على Folder
.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEnabled()
تتيح لك معرفة ما إذا كان Folder
هذا يتطلّب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط. يتم تفعيل هذه المتطلبات تلقائيًا للملفات والمجلدات المؤهَّلة.
لتفعيل متطلبات مفتاح المورد أو إيقافها للملفات المؤهَّلة، استخدِم
setSecurityUpdateEnabled
.
تعرّف على مزيد من المعلومات حول تحديث الأمان في Google Drive.
استرجاع الكرة
Boolean
: يشير ذلك إلى ما إذا تم تفعيل متطلبات مفتاح المورد لجهاز Folder
هذا.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingAccess()
لمعرفة فئة المستخدمين الذين يمكنهم الوصول إلى Folder
، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكلٍ صريح.
استرجاع الكرة
Access
: فئة المستخدمين الذين يمكنهم الوصول إلى Folder
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingPermission()
يحصل على الإذن الممنوح لهؤلاء المستخدمين الذين يمكنهم الوصول إلى Folder
،
بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً.
استرجاع الكرة
Permission
: الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى Folder
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSize()
الحصول على عدد وحدات البايت المستخدمة لتخزين Folder
في Drive. يُرجى ملاحظة أنّه
لا يتم احتساب ملفات تطبيق Google Workspace ضمن حدود مساحة التخزين في Drive، وبالتالي يتم عرض 0
بايت من مساحة التخزين.
استرجاع الكرة
Integer
: عدد وحدات البايت المستخدمة لتخزين Folder
في Drive
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getUrl()
الحصول على عنوان URL يمكن استخدامه لفتح Folder
في أحد تطبيقات Google، مثل
Drive أو "مستندات Google".
استرجاع الكرة
String
- عنوان URL الذي يمكن استخدامه لعرض Folder
في أحد تطبيقات Google، مثل Drive أو "مستندات Google"
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getViewers()
للحصول على قائمة المشاهدين والمعلقين على Folder
هذا. إذا لم يكن لدى المستخدم الذي ينفّذ النص البرمجي إذن تعديل Folder
، ستعرض هذه الطريقة مصفوفة فارغة.
// Gets a folder by its ID. // TODO(developer): Replace the folder ID with your own. const folder = DriveApp.getFolderById('1234567890abcdefghijklmnopqrstuvwxyz'); // Gets the list of viewers and logs their names to the console. const viewers = folder.getViewers(); for (viewer of viewers) { console.log(viewer.getName()); }
استرجاع الكرة
User[]
: قائمة بالمشاهدين والمعلِّقين على Folder
هذا إذا كان لدى المستخدم الإذن بتعديل المحتوى أو مصفوفة فارغة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isStarred()
تحدِّد هذه السياسة ما إذا كان قد تم تمييز Folder
بنجمة في حساب Drive للمستخدم.
استرجاع الكرة
Boolean
- true
إذا تم تمييز Folder
بنجمة في حساب Drive للمستخدم، وfalse
إذا لم يكن كذلك
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isTrashed()
تحدِّد هذه السياسة ما إذا كان ملف "Folder
" في مهملات حساب Drive الخاص بالمستخدم.
استرجاع الكرة
من Boolean
إلى true
إذا كانت Folder
في مهملات Drive للمستخدم، وfalse
إذا لم تكن كذلك
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
moveTo(destination)
ينقل هذا العنصر إلى مجلد الوجهة المحدَّد.
يجب أن يكون المستخدم الحالي مالك الملف أو أن يكون لديه على الأقل الإذن بتعديل المجلد الرئيسي الحالي للعنصر من أجل نقل العنصر إلى مجلد الوجهة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
destination | Folder | المجلد الذي سيصبح المجلد الرئيسي الجديد |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeEditor(emailAddress)
لإزالة المستخدم المحدّد من قائمة المحرِّرين في Folder
. ولا تحظر هذه الطريقة المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة Folder
مع نطاق المستخدم بأكمله، أو إذا كانت Folder
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، سيؤدي هذا أيضًا إلى إزالة المستخدم من قائمة العارضين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeEditor(user)
لإزالة المستخدم المحدّد من قائمة المحرِّرين في Folder
. ولا تحظر هذه الطريقة المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة Folder
مع نطاق المستخدم بأكمله، أو إذا كانت Folder
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، سيؤدي هذا أيضًا إلى إزالة المستخدم من قائمة العارضين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم المطلوب إزالته. |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeViewer(emailAddress)
لإزالة المستخدم المحدّد من قائمة المشاهدين والمعلقين في Folder
. ليس لهذه الطريقة تأثير إذا كان المستخدم محررًا، وليس مشاهدًا أو معلقًا. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة Folder
مع نطاق المستخدم بالكامل أو إذا كانت Folder
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، سيؤدي هذا أيضًا إلى إزالة المستخدم من قائمة المحرِّرين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeViewer(user)
لإزالة المستخدم المحدّد من قائمة المشاهدين والمعلقين في Folder
. ليس لهذه الطريقة أي تأثير إذا كان المستخدم محررًا وليس عارضًا. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون لفئة معيّنة من المستخدمين يمكنهم الوصول بشكل عام، مثلاً إذا تمت مشاركة Folder
مع النطاق الكامل للمستخدم، أو إذا كانت Folder
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، سيؤدي هذا أيضًا إلى إزالة المستخدم من قائمة المحرِّرين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم المطلوب إزالته. |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
revokePermissions(emailAddress)
لإلغاء إمكانية الوصول إلى Folder
التي تم منحها للمستخدم المحدّد. ولا تحظر هذه الطريقة المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة Folder
مع النطاق الكامل للمستخدم.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم الذي يجب إبطال إذن وصوله |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
revokePermissions(user)
لإلغاء إمكانية الوصول إلى Folder
التي تم منحها للمستخدم المحدّد. ولا تحظر هذه الطريقة المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة Folder
مع النطاق الكامل للمستخدم.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم الذي يجب إبطال إذن وصوله. |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
searchFiles(params)
الحصول على مجموعة من جميع الملفات الثانوية للمجلد الحالي والتي تطابق معايير البحث المحددة. ويتم عرض معايير البحث بالتفصيل في مستندات حزمة تطوير البرامج (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 that are children of the current folder and modified after February 28, // 2022 whose name contains "untitled."" var files = DriveApp.getRootFolder().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
: مجموعة من كل الملفات الثانوية للمجلد الحالي والتي تتطابق مع معايير
البحث
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
searchFolders(params)
للحصول على مجموعة من كل المجلدات التي تمثّل عناصر ثانوية للمجلد الحالي والتي تتطابق مع معايير البحث المحدّدة. ويتم عرض معايير البحث بالتفصيل في مستندات حزمة تطوير البرامج (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 that are children of the current folder and you own and is starred. var folders = DriveApp.getRootFolder().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
: مجموعة من كل المجلدات الثانوية للمجلد الحالي والتي تتطابق مع معايير البحث
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
setDescription(description)
setName(name)
setOwner(emailAddress)
تغيير مالك Folder
. تمنح هذه الطريقة أيضًا المالك السابق
إذنًا صريحًا لتعديل Folder
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم الذي يجب أن يصبح المالك الجديد |
استرجاع الكرة
Folder
— جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setOwner(user)
تغيير مالك Folder
. تمنح هذه الطريقة أيضًا المالك السابق
إذنًا صريحًا لتعديل Folder
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم الذي يجب أن يصبح المالك الجديد |
استرجاع الكرة
Folder
— جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setSecurityUpdateEnabled(enabled)
تحدّد هذه السياسة ما إذا كان Folder
يتطلّب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط. يتم تفعيل الملفات والمجلدات المؤهَّلة تلقائيًا.
تعرّف على مزيد من المعلومات حول تحديث الأمان في Google Drive.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
enabled | Boolean | يمكنك اختيار ما إذا كان سيتم تفعيل متطلبات مفتاح المورد لـ Folder . |
استرجاع الكرة
Folder
- جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setSharing(accessType, permissionType)
تحدّد فئة المستخدمين الذين يمكنهم الوصول إلى Folder
والأذونات التي يمنحها هؤلاء المستخدمون، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً.
// Creates a folder that anyone on the Internet can read from and write to. (Domain // administrators can prohibit this setting for users of a Google Workspace domain.) var folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
accessType | Access | فئة المستخدمين التي يجب أن تكون لديهم إمكانية الوصول إلى Folder |
permissionType | Permission | الأذونات التي يجب منحها للمستخدمين الذين يمكنهم الوصول إلى Folder |
استرجاع الكرة
Folder
— جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setStarred(starred)
تحدِّد هذه السياسة ما إذا كان سيتم تمييز Folder
بنجمة في حساب Drive للمستخدم. الإعداد التلقائي
لإعدادات Folder
الجديدة هو false
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
starred | Boolean | true إذا كان يجب تمييز Folder بنجمة في Drive للمستخدم، وfalse إذا لم يكن الأمر كذلك |
استرجاع الكرة
Folder
— جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setTrashed(trashed)
تحدِّد هذه السياسة ما إذا كان Folder
في مهملات حساب Drive للمستخدم. ولا يجوز لأحد سوى
المالك نقل Folder
إلى المهملات. الإعداد التلقائي لـ Folder
الجديدة هو false
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
trashed | Boolean | true إذا كان يجب نقل Folder إلى مهملات
Drive للمستخدم، وfalse إذا لم يكن الأمر كذلك |
استرجاع الكرة
Folder
— جهاز Folder
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive