مجلد في 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 أو المستندات. |
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
. إذا كان المستخدم مدرجًا بالفعل
في قائمة المشاهدين، فإن هذه الطريقة تروّج للمستخدم خارج قائمة المشاهدين.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المراد إضافته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addEditor(user)
إضافة المستخدم المحدد إلى قائمة محرِّري Folder
. إذا كان المستخدم مدرجًا بالفعل
في قائمة المشاهدين، فإن هذه الطريقة تروّج للمستخدم خارج قائمة المشاهدين.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم لإضافته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addEditors(emailAddresses)
لإضافة الصفيف المحدد من المستخدمين إلى قائمة المحررين لـ Folder
. وإذا كان أي من المستخدمين مدرجًا في قائمة المشاهدين، ستنقلهم هذه الطريقة من قائمة المشاهدين.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتهم. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addViewer(emailAddress)
لإضافة المستخدم المحدد إلى قائمة مشاهدي Folder
. إذا كان المستخدم مدرجًا من قبل
في قائمة المحررين، فلن يكون لهذه الطريقة أي تأثير.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المراد إضافته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addViewer(user)
لإضافة المستخدم المحدد إلى قائمة مشاهدي Folder
. إذا كان المستخدم مدرجًا من قبل
في قائمة المحررين، فلن يكون لهذه الطريقة أي تأثير.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم لإضافته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addViewers(emailAddresses)
لإضافة الصفيف المحدد من المستخدمين إلى قائمة مشاهدي Folder
. إذا كان أي من المستخدمين مدرجًا من قبل في قائمة المحررين، فلن يكون لهذه الطريقة أي تأثير عليهم.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتهم. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
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!');
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
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);
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
name | String | اسم الملف الجديد. |
content | String | محتوى الملف الجديد. |
mimeType | String | نوع MIME للملف الجديد. |
تذكرة ذهاب وعودة
File
— الملف الجديد.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
createFolder(name)
createShortcut(targetId)
ينشئ اختصارًا لمعرّف عنصر Drive المُقدَّم ويعرضه.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
targetId | String | معرّف الملف أو المجلد الهدف. |
تذكرة ذهاب وعودة
File
— الاختصار الجديد.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey)
ينشئ اختصارًا لمعرّف عنصر Drive ومفتاح المورد المتوفّرَين ويعرضه. مفاتيح الموارد هي معلمة إضافية يجب تمريرها للوصول إلى الملف أو المجلد المستهدف الذي تمت مشاركته باستخدام رابط.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
targetId | String | رقم تعريف الملف أو المجلد الهدف. |
targetResourceKey | String | مفتاح المورد للملف أو المجلد الهدف. |
تذكرة ذهاب وعودة
File
— الاختصار الجديد.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
getAccess(email)
يحصل على الإذن الممنوح للمستخدم المُحدّد.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
email | String | عنوان البريد الإلكتروني للمستخدم الذي يجب التحقق من أذوناته |
تذكرة ذهاب وعودة
Permission
— الأذونات الممنوحة للمستخدم
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getAccess(user)
يحصل على الإذن الممنوح للمستخدم المُحدّد.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم يجب التحقّق من أذوناته |
تذكرة ذهاب وعودة
Permission
— الأذونات الممنوحة للمستخدم
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getDateCreated()
getDescription()
getEditors()
للحصول على قائمة بالمحررين لهذه Folder
. إذا كان المستخدم الذي نفّذ النص البرمجي ليس لديه الإذن بتعديل محتوى Folder
، ستعرض هذه الطريقة صفيفًا فارغًا.
تذكرة ذهاب وعودة
User[]
— مصفوفة من المستخدمين الذين لديهم إذن تعديل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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)
الحصول على مجموعة من جميع الملفات التي هي عناصر فرعية للمجلد الحالي وتحمل الاسم الأول.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
name | String | اسم الملفات المطلوب البحث عنها. |
تذكرة ذهاب وعودة
FileIterator
— مجموعة من جميع الملفات التي هي عناصر فرعية للمجلد الحالي وتحمل الاسم الأول.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getFilesByType(mimeType)
الحصول على مجموعة من جميع الملفات التي تكون تابعة للمجلد الحالي وحاصلة على نوع MIME المحدد.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
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)
للحصول على مجموعة من جميع المجلدات الفرعية في المجلد الحالي والتي تحمل الاسم نفسه.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
name | String | اسم المجلدات التي سيتم العثور عليها. |
تذكرة ذهاب وعودة
FolderIterator
— مجموعة من جميع المجلدات التي تكون تابعة للمجلد الحالي وتحمل الاسم الأول.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getId()
getLastUpdated()
getName()
getOwner()
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 أو المستندات.
تذكرة ذهاب وعودة
String
: عنوان URL الذي يمكن استخدامه لعرض هذا Folder
في أحد تطبيقات Google، مثل Drive أو "مستندات Google"
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getViewers()
لعرض قائمة المشاهدين والمعلقين على Folder
. إذا كان المستخدم الذي نفّذ النص البرمجي ليس لديه الإذن بتعديل محتوى Folder
، ستعرض هذه الطريقة صفيفًا فارغًا.
تذكرة ذهاب وعودة
User[]
— مصفوفة من المستخدمين الذين لديهم إذن بعرض أو تعليق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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)
لنقل هذا العنصر إلى مجلد الوجهة الذي تم تقديمه.
يجب أن يكون المستخدم الحالي هو مالك الملف أو يكون على الأقل لديه حق التعديل في المجلد الرئيسي الحالي للعنصر من أجل نقل العنصر إلى المجلد الوجهة.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
destination | Folder | المجلد الذي سيصبح المجلد الرئيسي الجديد. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeEditor(emailAddress)
إزالة المستخدم المحدد من قائمة المحررين لـ Folder
. لا تحظر هذه الطريقة المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم حق الوصول العام، مثلاً، إذا تمت مشاركة Folder
مع نطاق المستخدم بالكامل، أو إذا كانت Folder
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
وبالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeEditor(user)
إزالة المستخدم المحدد من قائمة المحررين لـ Folder
. لا تحظر هذه الطريقة المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم حق الوصول العام، مثلاً، إذا تمت مشاركة Folder
مع نطاق المستخدم بالكامل، أو إذا كانت Folder
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
وبالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم لإزالته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeViewer(emailAddress)
يزيل المستخدم المعين من قائمة المشاهدين والمعلقين في Folder
. ليس لهذه الطريقة أي تأثير إذا كان المستخدم محررًا، وليس مشاهدًا أو معلقًا. ولا تمنع هذه الطريقة أيضًا المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، مثلاً، إذا تمت مشاركة Folder
مع نطاق المستخدم بأكمله، أو إذا كانت Folder
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
وبالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المحررين.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeViewer(user)
يزيل المستخدم المعين من قائمة المشاهدين والمعلقين في Folder
. ليس لهذه الطريقة أي تأثير إذا كان المستخدم محررًا، وليس مشاهدًا. ولا تحظر هذه الطريقة أيضًا المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، مثلاً، إذا تمت مشاركة Folder
مع نطاق المستخدم بالكامل، أو إذا كانت Folder
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
وبالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المحررين.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم لإزالته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
revokePermissions(emailAddress)
يُبطِل حق الوصول إلى Folder
الممنوحة للمستخدم المُحدَّد. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، مثلاً، إذا تمت مشاركة Folder
مع نطاق المستخدم بأكمله.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم الذي يجب إبطال إمكانية وصوله. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
revokePermissions(user)
يُبطِل حق الوصول إلى Folder
الممنوحة للمستخدم المُحدَّد. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، مثلاً، إذا تمت مشاركة Folder
مع نطاق المستخدم بأكمله.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم الذي يجب إبطال إمكانية وصوله |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
searchFiles(params)
الحصول على مجموعة من جميع الملفات التي تكون عناصر فرعية للمجلد الحالي وتطابق معايير البحث المحددة. يتم شرح معايير البحث بالتفصيل في مستندات Google Drive SDK. لاحظ أن خدمة Drive تستخدم الإصدار 2 من Drive API وتختلف بعض حقول طلبات البحث عن الإصدار v3. راجع الاختلافات بين الحقول بين الإصدارين 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()); }
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
params | String | معايير البحث، كما هو موضح بالتفصيل في وثائق Google Drive SDK. |
تذكرة ذهاب وعودة
FileIterator
— مجموعة من جميع الملفات التي هي عناصر ثانوية للمجلد الحالي وتطابق معايير البحث.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
searchFolders(params)
للحصول على مجموعة من جميع المجلدات التي تكون عناصر فرعية للمجلد الحالي وتطابق معايير البحث المحددة. يتم شرح معايير البحث بالتفصيل في مستندات Google Drive SDK. لاحظ أن خدمة Drive تستخدم الإصدار 2 من Drive API وتختلف بعض حقول طلبات البحث عن الإصدار v3. راجع الاختلافات بين الحقول بين الإصدارين 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()); }
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
params | String | معايير البحث، كما هو موضح بالتفصيل في وثائق Google Drive SDK. |
تذكرة ذهاب وعودة
FolderIterator
- مجموعة من جميع المجلدات التي تكون عناصر ثانوية للمجلد الحالي وتطابق معايير البحث.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
setDescription(description)
setName(name)
setOwner(emailAddress)
يغيّر مالك Folder
. تمنح هذه الطريقة أيضًا المالك السابق
إذنًا صريحًا بتعديل محتوى Folder
.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم الذي يجب أن يصبح المالك الجديد |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setOwner(user)
يغيّر مالك Folder
. تمنح هذه الطريقة أيضًا المالك السابق
إذنًا صريحًا بتعديل محتوى Folder
.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
user | User | إقرار للمستخدم الذي يجب أن يصبح المالك الجديد |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setSecurityUpdateEnabled(enabled)
يحدِّد هذا الإعداد ما إذا كان Folder
يتطلّب مفتاح وصول للوصول عند مشاركته باستخدام رابط. يتم تمكين الملفات والمجلدات المؤهلة بشكل افتراضي.
مزيد من المعلومات حول تحديث الأمان في Google Drive.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
enabled | Boolean | يمكنك تفعيل شرط مفتاح المورد لـ 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);
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
accessType | Access | فئة المستخدمين الذين يجب أن يتمكنوا من الوصول إلى Folder |
permissionType | Permission | الأذونات التي يجب منحها للمستخدمين الذين يمكنهم الوصول إلى Folder |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setStarred(starred)
لتعيين ما إذا كان سيتم تمييز Folder
بنجمة في Drive للمستخدم أم لا. الإعداد التلقائي
للصفحات Folder
الجديدة هو false
.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
starred | Boolean | true إذا كان يجب تمييز Folder بنجمة في Drive للمستخدم، false إذا لم يكن مميزًا |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setTrashed(trashed)
لتعيين ما إذا كان Folder
في مهملات Drive للمستخدم أم لا. يمكن للمالك فقط نقل المهملات إلى Folder
. الإعداد التلقائي في Folder
الجديدة هو false
.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
trashed | Boolean | true إذا كان يجب نقل Folder إلى مهملات
Drive للمستخدم، false إذا لم يتم نقلها |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive