ملف في Google Drive. يمكن الوصول إلى الملفات أو إنشاؤها من DriveApp
.
// Trash every untitled spreadsheet that hasn't been updated in a week. var files = DriveApp.getFilesByName('Untitled spreadsheet'); while (files.hasNext()) { var file = files.next(); if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) { file.setTrashed(true); } }
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
addCommenter(emailAddress) | File | أضِف المستخدم المحدّد إلى قائمة المعلِّقين للحساب File . |
addCommenter(user) | File | أضِف المستخدم المحدّد إلى قائمة المعلِّقين للحساب File . |
addCommenters(emailAddresses) | File | أضِف صفيف المستخدمين المحدّد إلى قائمة المعلّقين في File . |
addEditor(emailAddress) | File | إضافة المستخدم المحدد إلى قائمة محررات File . |
addEditor(user) | File | إضافة المستخدم المحدد إلى قائمة محررات File . |
addEditors(emailAddresses) | File | لإضافة صفيف معيّن من المستخدمين إلى قائمة محرّري File . |
addViewer(emailAddress) | File | تعمل على إضافة المستخدم المحدد إلى قائمة مشاهدي File . |
addViewer(user) | File | تعمل على إضافة المستخدم المحدد إلى قائمة مشاهدي File . |
addViewers(emailAddresses) | File | تعمل هذه السياسة على إضافة المصفوفة المحدّدة من المستخدمين إلى قائمة المشاهدين للوحدة التنظيمية File . |
getAccess(email) | Permission | يحصل المستخدم على الإذن الذي تم منحه للمستخدم. |
getAccess(user) | Permission | يحصل المستخدم على الإذن الذي تم منحه للمستخدم. |
getAs(contentType) | Blob | عرض البيانات داخل هذا العنصر ككائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد. |
getBlob() | Blob | عرض البيانات داخل هذا الكائن كائن ثنائي كبير. |
getDateCreated() | Date | يعرض هذا العمود تاريخ إنشاء File . |
getDescription() | String | الحصول على وصف File |
getDownloadUrl() | String | يحصل على عنوان URL الذي يمكن استخدامه لتنزيل الملف. |
getEditors() | User[] | الحصول على قائمة المحرِّرين لجهاز File هذا. |
getId() | String | تحصل على رقم تعريف File . |
getLastUpdated() | Date | يحدّد هذا الحقل تاريخ آخر تعديل لـ File . |
getMimeType() | String | الحصول على نوع MIME للملف. |
getName() | String | تحصل على اسم File . |
getOwner() | User | الحصول على مالك File . |
getParents() | FolderIterator | يحصل على مجموعة من المجلدات التي تمثّل عناصر مباشرة من File . |
getResourceKey() | String | يحصل على مفتاح المصدر من File المطلوب للوصول إلى العناصر التي تمت مشاركتها باستخدام رابط. |
getSecurityUpdateEligible() | Boolean | لمعرفة ما إذا كانت File هذه مؤهّلة لتطبيق تحديث الأمان الذي يتطلب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط. |
getSecurityUpdateEnabled() | Boolean | يحدِّد هذا الإعداد ما إذا كان File يتطلب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط. |
getSharingAccess() | Access | تحدد فئة المستخدمين التي يمكنها الوصول إلى File ، بجانب أي مستخدمين فرديين تم منحهم حق الوصول بشكل صريح. |
getSharingPermission() | Permission | يحصل على الإذن الممنوح لهؤلاء المستخدمين الذين يمكنهم الوصول إلى File ،
إلى جانب أي مستخدمين فرديين تم منحهم إذنًا صريحًا بالوصول. |
getSize() | Integer | يحصل على عدد وحدات البايت المُستخدَمة لتخزين File في Drive. |
getTargetId() | String | إذا كان هذا اختصارًا، سيتم عرض رقم تعريف العنصر الذي يشير إليه. |
getTargetMimeType() | String | إذا كان هذا اختصارًا، سيتم عرض نوع MIME من العنصر الذي يشير إليه. |
getTargetResourceKey() | String | إذا كان الملف اختصارًا، سيتم عرض مفتاح المصدر للعنصر الذي يشير إليه. |
getThumbnail() | Blob | الحصول على صورة مصغّرة للملف أو null إذا لم تكن هناك صورة مصغّرة. |
getUrl() | String | يحصل على عنوان URL الذي يمكن استخدامه لفتح File في أحد تطبيقات Google، مثل
Drive أو "مستندات Google". |
getViewers() | User[] | يحصل على قائمة المشاهدين والمعلقين لجهاز File هذا. |
isShareableByEditors() | Boolean | تُحدِّد هذه السياسة ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات بتعديل File بمشاركة الملفات مع مستخدمين آخرين أو تغيير الأذونات. |
isStarred() | Boolean | تحدِّد هذه السياسة ما إذا كانت File قد تم تمييزها بنجمة في Drive على جهاز المستخدم. |
isTrashed() | Boolean | يتم تحديد ما إذا كان File في مهملات المستخدم على Drive. |
makeCopy() | File | يُنشئ نسخة من الملف. |
makeCopy(destination) | File | تنشئ نسخة من الملف في الدليل الوجهة. |
makeCopy(name) | File | إنشاء نسخة من الملف وتسميتها بالاسم الذي تم تقديمه. |
makeCopy(name, destination) | File | تنشئ نسخة من الملف في الدليل الوجهة وتسمّيها بالاسم المقدّم. |
moveTo(destination) | File | تنقل هذا العنصر إلى مجلد الوجهة المقدم. |
removeCommenter(emailAddress) | File | إزالة المستخدم المحدّد من قائمة المعلّقين في File . |
removeCommenter(user) | File | إزالة المستخدم المحدّد من قائمة المعلّقين في File . |
removeEditor(emailAddress) | File | إزالة المستخدم المحدّد من قائمة محرّري File . |
removeEditor(user) | File | إزالة المستخدم المحدّد من قائمة محرّري File . |
removeViewer(emailAddress) | File | إزالة المستخدم المحدد من قائمة المشاهدين والمعلقين لـ File . |
removeViewer(user) | File | إزالة المستخدم المحدد من قائمة المشاهدين والمعلقين لـ File . |
revokePermissions(user) | File | إلغاء حق الوصول إلى File الممنوحة للمستخدم المُحدَّد. |
revokePermissions(user) | File | إلغاء حق الوصول إلى File الممنوحة للمستخدم المُحدَّد. |
setContent(content) | File | يستبدل محتوى الملف باستبدال محدد. |
setDescription(description) | File | إعداد وصف File |
setName(name) | File | تضبط هذه السياسة اسم File . |
setOwner(emailAddress) | File | تغيير مالك File |
setOwner(user) | File | تغيير مالك File |
setSecurityUpdateEnabled(enabled) | File | تحدِّد هذه السياسة ما إذا كان File يتطلب مفتاح مصدر للوصول إليه في حال مشاركته باستخدام رابط. |
setShareableByEditors(shareable) | File | يحدِّد هذا الإعداد ما إذا كان يُسمَح للمستخدمين الذين لديهم أذونات لتعديل الحقل File بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات. |
setSharing(accessType, permissionType) | File | تُحدّد فئة المستخدمين التي يمكنها الوصول إلى File والأذونات التي يتم منحها لهؤلاء المستخدمين، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذنًا صريحًا بالوصول. |
setStarred(starred) | File | تحدِّد هذه السياسة ما إذا كانت File مميّزة بنجمة في Drive على جهاز المستخدم. |
setTrashed(trashed) | File | يحدِّد هذا الإعداد ما إذا كان File في مهملات المستخدم على Drive. |
المستندات التفصيلية
addCommenter(emailAddress)
أضِف المستخدم المحدّد إلى قائمة المعلِّقين للحساب File
. إذا كان المستخدم مُدرَجًا في قائمة المشاهدين، ستروّج هذه الطريقة للمستخدم خارج قائمة المشاهدين.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إضافته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addCommenter(user)
أضِف المستخدم المحدّد إلى قائمة المعلِّقين للحساب File
. إذا كان المستخدم مُدرَجًا في قائمة المشاهدين، ستروّج هذه الطريقة للمستخدم خارج قائمة المشاهدين.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم لإضافته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addCommenters(emailAddresses)
أضِف صفيف المستخدمين المحدّد إلى قائمة المعلّقين في File
. إذا كان أيٌّ من المستخدمين ضمن قائمة المشاهدين، تساعد هذه الطريقة في استبعادهم من قائمة المشاهدين.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتها. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addEditor(emailAddress)
إضافة المستخدم المحدد إلى قائمة محررات File
. إذا كان المستخدم مدرجًا حاليًا
في قائمة المشاهدين، ستؤدي هذه الطريقة إلى استبعاد المستخدم من قائمة المشاهدين.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إضافته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addEditor(user)
إضافة المستخدم المحدد إلى قائمة محررات File
. إذا كان المستخدم مدرجًا حاليًا
في قائمة المشاهدين، ستؤدي هذه الطريقة إلى استبعاد المستخدم من قائمة المشاهدين.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم لإضافته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addEditors(emailAddresses)
لإضافة صفيف معيّن من المستخدمين إلى قائمة محرّري File
. وإذا كان أيٌّ من المستخدمين مدرجًا في قائمة المشاهدين، تتيح لهم هذه الطريقة استبعادهم من قائمة المشاهدين.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتها. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addViewer(emailAddress)
تعمل على إضافة المستخدم المحدد إلى قائمة مشاهدي File
. إذا كان المستخدم مدرَجًا في قائمة المحرّرين، لن يكون لهذه الطريقة أي تأثير.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إضافته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addViewer(user)
تعمل على إضافة المستخدم المحدد إلى قائمة مشاهدي File
. إذا كان المستخدم مدرَجًا في قائمة المحرّرين، لن يكون لهذه الطريقة أي تأثير.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم لإضافته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addViewers(emailAddresses)
تعمل هذه السياسة على إضافة المصفوفة المحدّدة من المستخدمين إلى قائمة المشاهدين للوحدة التنظيمية File
. إذا كان أي من المستخدمين مدرجًا في قائمة أدوات التحرير، لن يكون لهذه الطريقة أي تأثير.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتها. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
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
getAs(contentType)
عرض البيانات داخل هذا العنصر ككائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد. تضيف هذه الطريقة الامتداد المناسب إلى اسم الملف، على سبيل المثال، "myfile.pdf". ومع ذلك، يفترض أنّ الجزء من اسم الملف الذي يتبع النقطة الأخيرة (إن وجد) هو إضافة حالية يجب استبدالها. نتيجةً لذلك، يصبح "ShoppingList.12.25.2014" "ShoppingList.12.25.pdf".
لعرض الحصص اليومية للإحالات الناجحة، يُرجى الاطّلاع على حصص خدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا إلى عروض أسعار أكثر صرامة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
contentType | String | نوع MIME المطلوب التحويل إليه. وبالنسبة إلى معظم الكائنات الثنائية الكبيرة، 'application/pdf' هو الخيار الوحيد الصالح. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، أي من القيم 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png' صالح أيضًا. |
تذكرة ذهاب وعودة
Blob
— البيانات كائن ثنائي كبير.
getBlob()
getDateCreated()
getDescription()
getDownloadUrl()
يحصل على عنوان URL الذي يمكن استخدامه لتنزيل الملف. يمكن فقط للمستخدمين الذين لديهم الإذن لفتح الملف
في Google Drive الوصول إلى عنوان URL. يمكنك استخدام عنوان URL هذا في متصفح لتنزيل الملف، ولكن لا يمكنك استخدام جلب الملف مع UrlFetchApp
. وإذا كنت تريد محتوى الملف في النص البرمجي، استخدِم getBlob()
.
تذكرة ذهاب وعودة
String
— عنوان URL الذي يمكن استخدامه لتنزيل الملف.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getEditors()
الحصول على قائمة المحرِّرين لجهاز File
هذا. إذا لم يكن لدى المستخدم الذي ينفذ النص البرمجي حق التعديل على File
، ستعرض هذه الطريقة مصفوفة فارغة.
تذكرة ذهاب وعودة
User[]
: مصفوفة من المستخدمين لديهم إذن تعديل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getId()
getLastUpdated()
getMimeType()
الحصول على نوع MIME للملف.
تذكرة ذهاب وعودة
String
— نوع MIME للملف.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getName()
getOwner()
getParents()
يحصل على مجموعة من المجلدات التي تمثّل عناصر مباشرة من File
.
تذكرة ذهاب وعودة
FolderIterator
- مجموعة من المجلدات التي هي الوالدَين المباشرَين لـ File
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getResourceKey()
يحصل على مفتاح المصدر من File
المطلوب للوصول إلى العناصر التي تمت مشاركتها باستخدام رابط.
تذكرة ذهاب وعودة
String
— مفتاح المصدر File
.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEligible()
لمعرفة ما إذا كانت File
هذه مؤهّلة لتطبيق تحديث الأمان الذي يتطلب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط.
يتطلب Drive مفتاح مصدر للوصول إلى بعض الملفات أو المجلدات التي تمت مشاركتها باستخدام رابط. هذا التغيير جزء من تحديث أمان. يتم تفعيل التحديث تلقائيًا
للمجلدات والملفات المؤهلة. لتفعيل شرط مفتاح المورد أو إيقافه للملفات المؤهَّلة، استخدِم
setSecurityUpdateEnabled
.
تعرّف على المزيد من المعلومات عن تحديث الأمان في Google Drive.
تذكرة ذهاب وعودة
Boolean
: يمكن تطبيق متطلّب مفتاح المورد على File
.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEnabled()
يحدِّد هذا الإعداد ما إذا كان File
يتطلب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط. ويكون هذا الشرط مفعَّلاً تلقائيًا للملفات والمجلدات المؤهّلة.
لتفعيل شرط مفتاح المورد أو إيقافه للملفات المؤهَّلة، استخدِم
setSecurityUpdateEnabled
.
تعرّف على المزيد من المعلومات عن تحديث الأمان في Google Drive.
تذكرة ذهاب وعودة
Boolean
: تحديد ما إذا كان قد تم تفعيل مطلب مفتاح المورد لـ File
هذه.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingAccess()
تحدد فئة المستخدمين التي يمكنها الوصول إلى File
، بجانب أي مستخدمين فرديين تم منحهم حق الوصول بشكل صريح.
تذكرة ذهاب وعودة
Access
: فئة المستخدمين التي يمكنها الوصول إلى File
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingPermission()
يحصل على الإذن الممنوح لهؤلاء المستخدمين الذين يمكنهم الوصول إلى File
،
إلى جانب أي مستخدمين فرديين تم منحهم إذنًا صريحًا بالوصول.
تذكرة ذهاب وعودة
Permission
: الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى File
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSize()
يحصل على عدد وحدات البايت المُستخدَمة لتخزين File
في Drive. يُرجى ملاحظة أن
ملفات تطبيقات Google Workspace لا يتم احتسابها ضمن حدود مساحة التخزين في Drive، وبالتالي يتم عرض
0
بايت.
تذكرة ذهاب وعودة
Integer
— عدد وحدات البايت المُستخدَمة لتخزين File
في Drive.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getTargetId()
إذا كان هذا اختصارًا، سيتم عرض رقم تعريف العنصر الذي يشير إليه.
وإلا، سيتم إرجاع null
.
تذكرة ذهاب وعودة
String
— رقم تعريف العنصر المستهدف.
getTargetMimeType()
إذا كان هذا اختصارًا، سيتم عرض نوع MIME من العنصر الذي يشير إليه.
وإلا، سيتم إرجاع null
.
تذكرة ذهاب وعودة
String
— نوع بروتوكول MIME للسلعة الهدف.
getTargetResourceKey()
إذا كان الملف اختصارًا، سيتم عرض مفتاح المصدر للعنصر الذي يشير إليه. مفاتيح الموارد هي معلَمة إضافية يجب تمريرها للوصول إلى الملفات التي تمت مشاركتها باستخدام رابط.
إذا لم يكن الملف اختصارًا، سيعرض null
.
تذكرة ذهاب وعودة
String
— مفتاح المصدر للعنصرޓ، أو null
إذا لم يكن الملف اختصارًا.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getThumbnail()
getUrl()
يحصل على عنوان URL الذي يمكن استخدامه لفتح File
في أحد تطبيقات Google، مثل
Drive أو"مستندات Google".
تذكرة ذهاب وعودة
String
— عنوان URL الذي يمكن استخدامه لعرض هذا File
في أحد تطبيقات Google، مثل
Drive أو "مستندات Google"
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getViewers()
يحصل على قائمة المشاهدين والمعلقين لجهاز File
هذا. إذا كان المستخدم الذي نفّذ النص البرمجي لا يملك الإذن بتعديل المحتوى في File
، تعرض هذه الطريقة مصفوفة فارغة.
تذكرة ذهاب وعودة
User[]
: مصفوفة من المستخدمين الذين لديهم إذن عرض أو تعليق.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isStarred()
تحدِّد هذه السياسة ما إذا كانت File
قد تم تمييزها بنجمة في Drive على جهاز المستخدم.
تذكرة ذهاب وعودة
Boolean
— true
إذا كان File
مميزًا بنجمة في Drive الخاص بالمستخدم، false
إذا لم يكن مميّزًا.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isTrashed()
يتم تحديد ما إذا كان File
في مهملات المستخدم على Drive.
تذكرة ذهاب وعودة
Boolean
— true
إذا كان File
موضوعًا في مهملات المستخدم's Drive،
false
إذا لم يكن
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
makeCopy()
makeCopy(destination)
makeCopy(name)
إنشاء نسخة من الملف وتسميتها بالاسم الذي تم تقديمه.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
name | String | اسم الملف الذي يجب تطبيقه على النسخة الجديدة. |
تذكرة ذهاب وعودة
File
— النسخة الجديدة:
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
makeCopy(name, destination)
تنشئ نسخة من الملف في الدليل الوجهة وتسمّيها بالاسم المقدّم.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
name | String | اسم الملف الذي يجب تطبيقه على النسخة الجديدة. |
destination | Folder | الدليل الذي تريد نسخ الملف إليه. |
تذكرة ذهاب وعودة
File
— النسخة الجديدة:
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
moveTo(destination)
تنقل هذا العنصر إلى مجلد الوجهة المقدم.
يجب أن يكون المستخدم الحالي هو مالك الملف أو أن يكون لديه إذن تعديل على الأقل إلى المجلد الرئيسي الحالي للعنصر لنقله إلى المجلد الوجهة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
destination | Folder | المجلد الذي يصبح المجلد الرئيسي الجديد. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeCommenter(emailAddress)
إزالة المستخدم المحدّد من قائمة المعلّقين في File
. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة مستخدمين لديهم إذن وصول عام، على سبيل المثال، في حال مشاركة File
مع نطاق المستخدم بالكامل.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeCommenter(user)
إزالة المستخدم المحدّد من قائمة المعلّقين في File
. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة مستخدمين لديهم إذن وصول عام، على سبيل المثال، في حال مشاركة File
مع نطاق المستخدم بالكامل.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل المستخدم المطلوب إزالته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeEditor(emailAddress)
إزالة المستخدم المحدّد من قائمة محرّري File
. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة مستخدمين لديهم حق الوصول العام، مثلاً، في حال مشاركة File
مع نطاق المستخدم بالكامل، أو إذا كانت File
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeEditor(user)
إزالة المستخدم المحدّد من قائمة محرّري File
. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة مستخدمين لديهم حق الوصول العام، مثلاً، في حال مشاركة File
مع نطاق المستخدم بالكامل، أو إذا كانت File
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل المستخدم المطلوب إزالته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeViewer(emailAddress)
إزالة المستخدم المحدد من قائمة المشاهدين والمعلقين لـ File
. وليس لهذه الطريقة أي تأثير إذا كان المستخدم محرِّرًا وليس مشاهدًا أو معلِّقًا. هذه الطريقة أيضًا
لا تمنع المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة مستخدمين
لديهم حق الوصول العام، مثلاً، إذا تمت مشاركة File
مع نطاق المستخدم بالكامل، أو إذا كانت File
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة التحرير.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeViewer(user)
إزالة المستخدم المحدد من قائمة المشاهدين والمعلقين لـ File
. وليس لهذه الطريقة أي تأثير إذا كان المستخدم محرِّرًا وليس مشاهدًا. هذه الطريقة أيضًا لا تمنع
المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة مستخدمين لديهم حق الوصول العام، مثلاً، إذا تمت مشاركة File
مع نطاق المستخدم بالكامل، أو
إذا كانت File
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة التحرير.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل المستخدم المطلوب إزالته. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
revokePermissions(user)
إلغاء حق الوصول إلى File
الممنوحة للمستخدم المُحدَّد. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة مستخدمين لديهم إذن وصول عام، على سبيل المثال، في حال مشاركة File
مع نطاق المستخدم بالكامل.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
user | String | عنوان البريد الإلكتروني للمستخدم الذي يجب إبطال إمكانية وصوله |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
revokePermissions(user)
إلغاء حق الوصول إلى File
الممنوحة للمستخدم المُحدَّد. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة مستخدمين لديهم إذن وصول عام، على سبيل المثال، في حال مشاركة File
مع نطاق المستخدم بالكامل.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم الذي يجب إبطال حق وصوله |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setContent(content)
يستبدل محتوى الملف باستبدال محدد. يتم طرح استثناء إذا كان حجم content
أكبر من 10 ميغابايت.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
content | String | المحتوى الجديد للملف. |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setDescription(description)
setName(name)
setOwner(emailAddress)
تغيير مالك File
تمنح هذه الطريقة أيضًا المالك السابق
إذنًا صريحًا بتعديل المحتوى في File
.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم الذي يجب أن يصبح المالك الجديد |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setOwner(user)
تغيير مالك File
تمنح هذه الطريقة أيضًا المالك السابق
إذنًا صريحًا بتعديل المحتوى في File
.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم الذي من المفترض أن يصبح المالك الجديد |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setSecurityUpdateEnabled(enabled)
تحدِّد هذه السياسة ما إذا كان File
يتطلب مفتاح مصدر للوصول إليه في حال مشاركته باستخدام رابط. تكون الملفات والمجلدات المؤهَّلة مفعَّلة تلقائيًا.
تعرّف على المزيد من المعلومات عن تحديث الأمان في Google Drive.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
enabled | Boolean | ما إذا كان سيتم تفعيل متطلب مفتاح المورد لـ File . |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setSharing(accessType, permissionType)
تُحدّد فئة المستخدمين التي يمكنها الوصول إلى File
والأذونات التي يتم منحها لهؤلاء المستخدمين، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذنًا صريحًا بالوصول.
// 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 | فئة المستخدمين التي يجب أن يتمكنوا من الوصول إلى File |
permissionType | Permission | الأذونات التي يجب منحها للمستخدمين الذين يمكنهم الوصول إلى File |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setStarred(starred)
تحدِّد هذه السياسة ما إذا كانت File
مميّزة بنجمة في Drive على جهاز المستخدم. الإعداد التلقائي File
الجديد هو false
.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
starred | Boolean | true إذا كان يجب تمييز File بنجمة في Drive للمستخدم، أو false في حال عدم ظهوره |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setTrashed(trashed)
يحدِّد هذا الإعداد ما إذا كان File
في مهملات المستخدم على Drive. يمكن للمالك فقط نقل File
إلى المهملات. الإعداد التلقائي في File
الجديدة هو false
.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
trashed | Boolean | true إذا كان يجب نقل File إلى مهملات المستخدم على Drive ، false وإذا لم يكن كذلك |
تذكرة ذهاب وعودة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive