مجلد في Google Drive يمكن الوصول إلى المجلدات أو إنشاؤها من Drive
.
// Log the name of every folder in the user's Drive. const folders = DriveApp.getFolders(); while (folders.hasNext()) { const folder = folders.next(); Logger.log(folder.getName()); }
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
add | Folder | تُضيف هذه السمة المستخدم المحدَّد إلى قائمة المحرِّرين في Folder . |
add | Folder | تُضيف هذه السمة المستخدم المحدَّد إلى قائمة المحرِّرين في Folder . |
add | Folder | تُضيف الصفيف المحدَّد من المستخدمين إلى قائمة المحرِّرين في Folder . |
add | Folder | تُضيف هذه السمة المستخدم المحدّد إلى قائمة المشاهدين في Folder . |
add | Folder | تُضيف هذه السمة المستخدم المحدّد إلى قائمة المشاهدين في Folder . |
add | Folder | تُضيف الصفيف المحدّد من المستخدِمين إلى قائمة المشاهدين في Folder . |
create | File | لإنشاء ملف في المجلد الحالي من Blob معيّن من البيانات العشوائية |
create | File | لإنشاء ملف نصي في المجلد الحالي بالاسم والمحتوى المحدَّدين |
create | File | لإنشاء ملف في المجلد الحالي بالاسم والمحتوى ونوع MIME المحدَّدَين |
create | Folder | يؤدي هذا الخيار إلى إنشاء مجلد في المجلد الحالي بالاسم المحدَّد. |
create | File | تُنشئ هذه الوظيفة اختصارًا لرقم تعريف عنصر Drive المقدَّم، وتُعيده. |
create | File | تُنشئ هذه الدالة اختصارًا لمعرّف عنصر Drive ومفتاح المورد المقدَّمين، وتُعيده. |
get | Permission | الحصول على الإذن الممنوح لمستخدم معيّن |
get | Permission | الحصول على الإذن الممنوح لمستخدم معيّن |
get | Date | تحصل على تاريخ إنشاء Folder . |
get | String | تحصل على وصف Folder . |
get | User[] | تحصل على قائمة بالمحرِّرين لهذا Folder . |
get | File | تحصل على مجموعة من جميع الملفات الفرعية للمجلد الحالي. |
get | File | تحصل على مجموعة من جميع الملفات الفرعية للمجلد الحالي التي تحمل الاسم المحدَّد. |
get | File | تحصل على مجموعة من جميع الملفات الفرعية للمجلد الحالي التي لها نوع MIME المحدَّد. |
get | Folder | تحصل على مجموعة من جميع المجلدات الفرعية للمجلد الحالي. |
get | Folder | تحصل على مجموعة من جميع المجلدات الفرعية للمجلد الحالي والتي تحمل الاسم المحدَّد. |
get | String | تحصل على معرّف Folder . |
get | Date | تحصل على تاريخ آخر تعديل على Folder . |
get | String | تحصل على اسم Folder . |
get | User | الحصول على مالك هذا Folder |
get | Folder | تحصل على مجموعة من المجلدات التي هي مجلدات رئيسية فورية للعنصر Folder . |
get | String | تحصل على مفتاح المورد الخاص بـ Folder المطلوب للوصول إلى العناصر التي
تمّت مشاركتها باستخدام رابط. |
get | Boolean | تحصل على ما إذا كان هذا Folder مؤهلاً لتطبيق تحديث الأمان الذي
يتطلب مفتاح مصدر للوصول عند مشاركته باستخدام رابط. |
get | Boolean | تحصل على ما إذا كان هذا Folder يتطلّب مفتاح مورد للوصول إليه عند
مشاركته باستخدام رابط. |
get | Access | تحصل على فئة المستخدمين الذين يمكنهم الوصول إلى Folder ، بالإضافة إلى أي مستخدمين individual
تم منحهم إذن الوصول بشكل صريح. |
get | Permission | الحصول على الإذن الممنوح للمستخدمين الذين يمكنهم الوصول إلى Folder ،
بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً |
get | Integer | تحصل على عدد وحدات البايت المستخدَمة لتخزين Folder في Drive. |
get | String | تحصل على عنوان URL الذي يمكن استخدامه لفتح Folder في أحد تطبيقات Google، مثل
Drive أو "مستندات Google". |
get | User[] | تحصل على قائمة بالمشاهدين والمعلقين لهذا Folder . |
is | Boolean | لتحديد ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل على Folder
بمشاركتها مع مستخدمين آخرين أو تغيير الأذونات |
is | Boolean | لتحديد ما إذا تم وضع علامة "تمييز بعلامة النجمة" على Folder في Drive الخاص بالمستخدم. |
is | Boolean | يحدِّد ما إذا كان Folder في المهملات في Drive الخاص بالمستخدم. |
move | Folder | تنقل هذه العملية هذا العنصر إلى المجلد الوجهة المقدَّم. |
remove | Folder | تزيل هذه الدالة المستخدم المحدَّد من قائمة المحرِّرين في Folder . |
remove | Folder | تزيل هذه الدالة المستخدم المحدَّد من قائمة المحرِّرين في Folder . |
remove | Folder | تؤدي هذه العملية إلى إزالة المستخدم المحدّد من قائمة المشاهدين والمعلّقين في Folder . |
remove | Folder | تؤدي هذه العملية إلى إزالة المستخدم المحدّد من قائمة المشاهدين والمعلّقين في Folder . |
revoke | Folder | تؤدي هذه العملية إلى إبطال إذن الوصول إلى Folder الذي تم منحه للمستخدم المحدّد. |
revoke | Folder | تؤدي هذه العملية إلى إبطال إذن الوصول إلى Folder الذي تم منحه للمستخدم المحدّد. |
search | File | تحصل على مجموعة من جميع الملفات الفرعية للمجلد الحالي والتي تتطابق مع معايير البحث المقدَّمة. |
search | Folder | تحصل على مجموعة من جميع المجلدات الفرعية للمجلد الحالي والتي تتطابق مع معايير البحث المُقدَّمة. |
set | Folder | لضبط وصف Folder . |
set | Folder | تُستخدَم لضبط اسم Folder . |
set | Folder | تغيير مالك Folder |
set | Folder | تغيير مالك Folder |
set | Folder | لتحديد ما إذا كان Folder يتطلّب مفتاح مورد للوصول إليه عند مشاركته باستخدام رابط |
set | Folder | لتحديد ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل على Folder بمشاركة
مع مستخدمين آخرين أو تغيير الأذونات |
set | Folder | لتحديد فئة المستخدمين الذين يمكنهم الوصول إلى Folder والأذونات التي يتم منحها لهؤلاء المستخدمين، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً. |
set | Folder | لضبط ما إذا كان Folder مميّزًا بنجمة في Drive الخاص بالمستخدم. |
set | Folder | لتحديد ما إذا كان Folder في المهملات في مساحة التخزين السحابي Drive الخاصة بالمستخدم. |
مستندات تفصيلية
add Editor(emailAddress)
تُضيف هذه السمة المستخدم المحدَّد إلى قائمة المحرِّرين في Folder
. إذا كان المستخدم مُدرَجًا في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
email | String | عنوان البريد الإلكتروني للمستخدم الذي تريد إضافته |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
add Editor(user)
تُضيف هذه السمة المستخدم المحدَّد إلى قائمة المحرِّرين في Folder
. إذا كان المستخدم مُدرَجًا في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم المطلوب إضافته |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
add Editors(emailAddresses)
تُضيف الصفيف المحدَّد من المستخدمين إلى قائمة المحرِّرين في Folder
. إذا كان أيّ من
المستخدِمين مدرَجًا في قائمة المشاهدين، ستؤدي هذه الطريقة إلى إزالته من قائمة
المشاهدين.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
email | String[] | صفيف من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتهم |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
add Viewer(emailAddress)
تُضيف هذه السمة المستخدم المحدّد إلى قائمة المشاهدين في Folder
. إذا كان المستخدم مُدرَجًا في قائمة المحرِّرين، لن يكون لهذه الطريقة أي تأثير.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
email | String | عنوان البريد الإلكتروني للمستخدم الذي تريد إضافته |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
add Viewer(user)
تُضيف هذه السمة المستخدم المحدّد إلى قائمة المشاهدين في Folder
. إذا كان المستخدم مُدرَجًا في قائمة المحرِّرين، لن يكون لهذه الطريقة أي تأثير.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم المطلوب إضافته |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
add Viewers(emailAddresses)
تُضيف الصفيف المحدّد من المستخدِمين إلى قائمة المشاهدين في Folder
. إذا كان أي من
المستخدِمين مدرَجًا في قائمة المحرِّرين، لن يكون لهذه الطريقة أي تأثير عليه.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
email | String[] | صفيف من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتهم |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
create File(blob)
لإنشاء ملف في المجلد الحالي من Blob
معيّن من البيانات العشوائية
المعلمات
الاسم | النوع | الوصف |
---|---|---|
blob | Blob | بيانات الملف الجديد. |
الإرجاع
File
: الملف الجديد
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
create File(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
create File(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 | محتوى الملف الجديد. |
mime | String | نوع MIME للملف الجديد |
الإرجاع
File
: الملف الجديد
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
create Folder(name)
create Shortcut(targetId)
تُنشئ هذه الوظيفة اختصارًا لرقم تعريف عنصر Drive المقدَّم، وتُعيده.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
target | String | رقم تعريف الملف أو المجلد المستهدف |
الإرجاع
File
: الاختصار الجديد.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
create Shortcut For Target Id And Resource Key(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(), ); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
target | String | رقم تعريف الملف أو المجلد المستهدف |
target | String | مفتاح الموارد للملف أو المجلد المستهدف |
الإرجاع
File
: الاختصار الجديد.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
get Access(email)
الحصول على الإذن الممنوح لمستخدم معيّن لا تتيح الطريقة عرض أذونات "مجموعة Google" أو الأذونات المُكتسَبة من خلال "مجموعات Google".
المعلمات
الاسم | النوع | الوصف |
---|---|---|
email | String | عنوان البريد الإلكتروني للمستخدم الذي يجب التحقّق من أذوناته لا يمكن استخدام "مجموعات Google" . |
الإرجاع
Permission
: الأذونات الممنوحة للمستخدم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Access(user)
الحصول على الإذن الممنوح لمستخدم معيّن لا تتيح الطريقة عرض أذونات "مجموعة Google" أو الأذونات المُكتسَبة من خلال "مجموعات Google".
المعلمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم الذي يجب التحقّق من أذوناته |
الإرجاع
Permission
: الأذونات الممنوحة للمستخدم
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Date Created()
get Description()
get Editors()
تحصل على قائمة بالمحرِّرين لهذا 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 (const editor of editors) { console.log(editor.getName()); }
الإرجاع
User[]
: قائمة المحرِّرين لهذا Folder
إذا كان لدى المستخدم إذن وصول للتعديل أو صفيف خالٍ في حال عدم توفّر إذن وصول
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Files()
تحصل على مجموعة من جميع الملفات الفرعية للمجلد الحالي.
الإرجاع
File
: مجموعة من جميع الملفات الفرعية للمجلد الحالي
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Files By Name(name)
تحصل على مجموعة من جميع الملفات الفرعية للمجلد الحالي التي تحمل الاسم المحدَّد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
name | String | اسم الملفات المطلوب العثور عليها |
الإرجاع
File
: مجموعة من جميع الملفات الفرعية للمجلد الحالي والتي تحمل الاسم المحدّد
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Files By Type(mimeType)
تحصل على مجموعة من جميع الملفات الفرعية للمجلد الحالي التي لها نوع MIME المحدَّد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
mime | String | نوع MIME للملفات المطلوب العثور عليها |
الإرجاع
File
: مجموعة من جميع الملفات الفرعية للمجلد الحالي التي لها نوع MIME
محدد
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Folders()
تحصل على مجموعة من جميع المجلدات الفرعية للمجلد الحالي.
الإرجاع
Folder
: مجموعة من جميع المجلدات الفرعية للمجلد الحالي
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Folders By Name(name)
تحصل على مجموعة من جميع المجلدات الفرعية للمجلد الحالي والتي تحمل الاسم المحدَّد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
name | String | اسم المجلدات المطلوب العثور عليها |
الإرجاع
Folder
: مجموعة من جميع المجلدات الفرعية للمجلد الحالي التي تحمل الاسم المحدّد
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Id()
get Last Updated()
get Name()
get Owner()
الحصول على مالك هذا 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
get Parents()
تحصل على مجموعة من المجلدات التي هي مجلدات رئيسية فورية للعنصر Folder
.
الإرجاع
Folder
: مجموعة من المجلدات التي هي مجلدات رئيسية مباشرةً للFolder
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Resource Key()
تحصل على مفتاح المورد الخاص بـ Folder
المطلوب للوصول إلى العناصر التي
تمّت مشاركتها باستخدام رابط.
الإرجاع
String
: مفتاح المورد الخاص بـ Folder
.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Security Update Eligible()
تحصل على ما إذا كان هذا Folder
مؤهلاً لتطبيق تحديث الأمان الذي
يتطلب مفتاح مصدر للوصول عند مشاركته باستخدام رابط.
يتطلّب Drive مفتاح مورد للوصول إلى بعض الملفات أو المجلدات التي تمت مشاركتها باستخدام
رابط. هذا التغيير هو جزء من تحديث أمان. يتم تفعيل ميزة التعديل تلقائيًا في
الملفات والمجلدات المؤهَّلة. لتفعيل متطلبات مفتاح المرجع أو إيقافها للملفّات المؤهّلة، استخدِم رمز
set
.
مزيد من المعلومات حول تحديث الأمان لخدمة Google Drive
الإرجاع
Boolean
— ما إذا كان يمكن تطبيق متطلّبات مفتاح المورد على Folder
.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Security Update Enabled()
تحصل على ما إذا كان هذا Folder
يتطلّب مفتاح مورد للوصول إليه عند
مشاركته باستخدام رابط. يكون هذا الشرط مفعّلاً تلقائيًا للملفات والمجلدات المؤهَّلة.
لتفعيل متطلبات مفتاح المرجع أو إيقافها للملفّات المؤهّلة، استخدِم
setSecurityUpdateEnabled
.
مزيد من المعلومات حول تحديث الأمان لخدمة Google Drive
الإرجاع
Boolean
: ما إذا كان متطلّب مفتاح المورد مفعّلاً لهذا Folder
.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Sharing Access()
تحصل على فئة المستخدمين الذين يمكنهم الوصول إلى Folder
، بالإضافة إلى أي مستخدمين individual
تم منحهم إذن الوصول بشكل صريح.
الإرجاع
Access
- فئة المستخدمين الذين يمكنهم الوصول إلى Folder
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Sharing Permission()
الحصول على الإذن الممنوح للمستخدمين الذين يمكنهم الوصول إلى Folder
،
بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً
الإرجاع
Permission
: الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى Folder
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Size()
تحصل على عدد وحدات البايت المستخدَمة لتخزين Folder
في Drive. يُرجى العِلم أنّه
لا يتم احتساب ملفات تطبيقات Google Workspace ضمن حدود مساحة التخزين في Drive، وبالتالي يتم عرض قيمة 0
بايت.
الإرجاع
Integer
: عدد وحدات البايت المستخدَمة لتخزين Folder
في Drive
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Url()
تحصل على عنوان URL الذي يمكن استخدامه لفتح Folder
في أحد تطبيقات Google، مثل
Drive أو "مستندات Google".
الإرجاع
String
: عنوان URL الذي يمكن استخدامه لعرض هذا Folder
في أحد تطبيقات Google، مثل
Drive أو "مستندات Google"
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
get Viewers()
تحصل على قائمة بالمشاهدين والمعلقين لهذا Folder
. إذا لم يكن لدى المستخدم الذي executes the script إذن وصول للتعديل إلى 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 (const viewer of viewers) { console.log(viewer.getName()); }
الإرجاع
User[]
: قائمة المشاهدين والمعلّقين لهذا Folder
إذا كان لدى المستخدم إذن تعديل
أو صفيف فارغ في حال عدم توفّر هذا الإذن
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
is Starred()
لتحديد ما إذا تم وضع علامة "تمييز بعلامة النجمة" على Folder
في Drive الخاص بالمستخدم.
الإرجاع
Boolean
: true
إذا تم وضع علامة النجمة على Folder
في Drive الخاص بالمستخدم، false
إذا لم يتم ذلك
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
is Trashed()
يحدِّد ما إذا كان Folder
في المهملات في Drive الخاص بالمستخدم.
الإرجاع
Boolean
— true
إذا كان Folder
في المهملات في حساب المستخدم على Drive
false
إذا لم يكن الأمر كذلك
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
move To(destination)
تنقل هذه العملية هذا العنصر إلى المجلد الوجهة المقدَّم.
يجب أن يكون المستخدم الحالي مالك الملف أو أن يكون لديه إذن وصول للتعديل على المجلد الرئيسي الحالي للعنصر على الأقل من أجل نقل العنصر إلى المجلد الوجهة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
destination | Folder | المجلد الذي يصبح المجلد الرئيسي الجديد. |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
remove Editor(emailAddress)
تزيل هذه الدالة المستخدم المحدَّد من قائمة المحرِّرين في Folder
. لا تؤدي هذه الطريقة إلى منع المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، على سبيل المثال، إذا تمت مشاركة Folder
مع Folder
للمستخدم بالكامل، أو إذا كان Folder
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
email | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
remove Editor(user)
تزيل هذه الدالة المستخدم المحدَّد من قائمة المحرِّرين في Folder
. لا تؤدي هذه الطريقة إلى منع المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، على سبيل المثال، إذا تمت مشاركة Folder
مع Folder
للمستخدم بالكامل، أو إذا كان Folder
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم المطلوب إزالته |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
remove Viewer(emailAddress)
تؤدي هذه العملية إلى إزالة المستخدم المحدّد من قائمة المشاهدين والمعلّقين في Folder
. لا تؤثّر هذه المحاولة في حال كان المستخدم محرِّرًا وليس مشاهدًا أو معلِقًا. لا تحظر هذه الطريقة أيضًا
المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم
إذن وصول عام، على سبيل المثال، إذا تمت مشاركة Folder
مع
نطاق المستخدم بالكامل، أو إذا كان Folder
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.Folder
بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المحرِّرين.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
email | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته |
الإرجاع
Folder
— هذا Folder
لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
remove Viewer(user)
تؤدي هذه العملية إلى إزالة المستخدم المحدّد من قائمة المشاهدين والمعلّقين في Folder
. لا تؤثر هذه المحاولة في حال كان المستخدم محرِّرًا وليس مشاهدًا. لا تحظر هذه الطريقة أيضًا
المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم
إذن وصول عام، على سبيل المثال، إذا تمت مشاركة Folder
مع نطاق المستخدم بالكامل، أو
إذا كان Folder
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المحرِّرين.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم المطلوب إزالته |
الإرجاع
Folder
— هذا Folder
لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
revoke Permissions(emailAddress)
تؤدي هذه العملية إلى إبطال إذن الوصول إلى Folder
الذي تم منحه للمستخدم المحدّد. لا تؤدي هذه الطريقة إلى منع المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، على سبيل المثال، إذا تمت مشاركة Folder
مع نطاق المستخدم بالكامل.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
email | String | عنوان البريد الإلكتروني للمستخدم الذي يجب إلغاء إذن وصوله. |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
revoke Permissions(user)
تؤدي هذه العملية إلى إبطال إذن الوصول إلى Folder
الذي تم منحه للمستخدم المحدّد. لا تؤدي هذه الطريقة إلى منع المستخدمين من الوصول إلى Folder
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، على سبيل المثال، إذا تمت مشاركة Folder
مع نطاق المستخدم بالكامل.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم الذي يجب إلغاء إذن وصوله |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
search Files(params)
تحصل على مجموعة من جميع الملفات الفرعية للمجلد الحالي والتي تتطابق مع معايير البحث المقدَّمة. يمكنك الاطّلاع على تفاصيل معايير البحث في مستندات Google Drive SDK. يُرجى العِلم أنّ خدمة 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."" const files = DriveApp.getRootFolder().searchFiles( 'modifiedDate > "2022-02-28" and title contains "untitled"'); while (files.hasNext()) { const file = files.next(); console.log(file.getName()); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
params | String | معايير البحث، كما هو موضّح بالتفصيل في مستندات Google Drive SDK |
الإرجاع
File
: مجموعة من جميع الملفات الفرعية للمجلد الحالي والتي تتطابق مع معايير
البحث
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
search Folders(params)
تحصل على مجموعة من جميع المجلدات الفرعية للمجلد الحالي والتي تتطابق مع معايير البحث المُقدَّمة. يمكنك الاطّلاع على تفاصيل معايير البحث في مستندات Google Drive SDK. يُرجى العِلم أنّ خدمة 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. const folders = DriveApp.getRootFolder().searchFolders('starred = true and "me" in owners'); while (folders.hasNext()) { const folder = folders.next(); console.log(folder.getName()); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
params | String | معايير البحث، كما هو موضّح بالتفصيل في مستندات Google Drive SDK |
الإرجاع
Folder
: مجموعة من جميع المجلدات الفرعية للمجلد الحالي والتي تطابق معايير
البحث
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
set Description(description)
set Name(name)
set Owner(emailAddress)
تغيير مالك Folder
وتمنح هذه الطريقة أيضًا للمالك السابق
إذن تعديل صريحًا على Folder
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
email | String | عنوان البريد الإلكتروني للمستخدم الذي يجب أن يصبح المالك الجديد |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
set Owner(user)
تغيير مالك Folder
وتمنح هذه الطريقة أيضًا للمالك السابق
إذن تعديل صريحًا على Folder
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم الذي يجب أن يصبح المالك الجديد |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
set Security Update Enabled(enabled)
لتحديد ما إذا كان Folder
يتطلّب مفتاح مورد للوصول إليه عند مشاركته باستخدام رابط تكون الملفات والمجلدات المؤهَّلة مفعَّلة تلقائيًا.
مزيد من المعلومات حول تحديث الأمان لخدمة Google Drive
المعلمات
الاسم | النوع | الوصف |
---|---|---|
enabled | Boolean | ما إذا كان سيتم تفعيل متطلّبات مفتاح المورد في Folder |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
set Sharing(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.) const folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
access | Access | فئة المستخدمين التي يجب أن تكون قادرة على الوصول إلى Folder |
permission | Permission | الأذونات التي يجب منحها للمستخدمين الذين يمكنهم الوصول إلى Folder |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
set Starred(starred)
لضبط ما إذا كان Folder
مميّزًا بنجمة في Drive الخاص بالمستخدم. القيمة التلقائية ل
Folder
الجديدة هي false
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
starred | Boolean | true إذا كان يجب وضع علامة النجمة على Folder في حساب المستخدم على
Drive، false إذا لم يكن الأمر كذلك |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
set Trashed(trashed)
لتحديد ما إذا كان Folder
في المهملات في مساحة التخزين السحابي Drive الخاصة بالمستخدم. يمكن فقط
للمالك وضع Folder
في المهملات. القيمة التلقائية لعناصر Folder
الجديدة هي false
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
trashed | Boolean | true إذا كان يجب نقل Folder إلى المهملات في
مساحة التخزين على Drive الخاصة بالمستخدم، false إذا لم يكن الأمر كذلك |
الإرجاع
Folder
— هذا الرمز Folder
، لإنشاء سلسلة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive