مجلد في 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
. إذا كان المستخدم قد
في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
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)
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
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
، ستعرض هذه الطريقة صفيفًا فارغًا.
// 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)
توفر مجموعة تضم كل الملفات الثانوية للمجلد الحالي والتي تحمل الاسم المحدّد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
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()
الحصول على مالك هذا 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)
لنقل هذا العنصر إلى مجلد الوجهة المتوفر.
يجب أن يكون المستخدم الحالي مالك الملف أو على الأقل يملك الإذن بتعديل العنصر المجلد الرئيسي الحالي لنقل العنصر إلى المجلد الوجهة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
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
مع عنوان URL للمستخدم
النطاق بالكامل، أو إذا كان 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
مع عنوان URL
المجال بأكمله.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم الذي يجب إبطال إذن وصوله |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
revokePermissions(user)
لإلغاء إذن الوصول إلى Folder
الممنوح للمستخدم المحدّد. هذه الطريقة لا
منع المستخدمين من الوصول إلى "Folder
" إذا كانوا ينتمون إلى فئة من المستخدمين
إذن الوصول العام، على سبيل المثال، إذا تمت مشاركة Folder
مع عنوان URL
المجال بأكمله.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم الذي يجب إبطال وصوله |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
searchFiles(params)
جلب مجموعة من كل الملفات الثانوية للمجلد الحالي والتي تتطابق مع عملية البحث المحدّدة المعايير. يمكنك الاطّلاع على معايير البحث بالتفصيل في مستندات حزمة تطوير البرامج (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 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 | معايير البحث، كما هو موضَّح في مستندات حزمة تطوير البرامج (SDK) لخدمة Google Drive |
الإرجاع
FileIterator
— مجموعة من كل الملفات الثانوية للمجلد الحالي والتي تتطابق مع البحث
المعايير.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
searchFolders(params)
جلب مجموعة من كل المجلدات الثانوية للمجلد الحالي والتي تتطابق مع عملية البحث المحدّدة المعايير. يمكنك الاطّلاع على معايير البحث بالتفصيل في مستندات حزمة تطوير البرامج (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 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 | معايير البحث، كما هو موضَّح في مستندات حزمة تطوير البرامج (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
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
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 بنجمة في حساب المستخدم
القيادة؛ 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