ملف في 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 أو المستندات. |
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(emailAddress) | 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()
اعرض البيانات داخل هذا الكائن كائن كائن ثنائي كبير.
تذكرة ذهاب وعودة
Blob
— البيانات كائن كائن ثنائي كبير.
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()
الحصول على صورة مصغّرة للملف، أو null
في حال عدم توفّر صورة مصغّرة.
تذكرة ذهاب وعودة
Blob
— الصورة المصغرة للملف.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getUrl()
يحصل على عنوان URL الذي يمكن استخدامه لفتح File
في أحد تطبيقات Google مثل
Drive أو المستندات.
تذكرة ذهاب وعودة
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
في مهملات 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(emailAddress)
يُبطِل حق الوصول إلى File
الممنوحة للمستخدم المُحدَّد. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، مثلاً، إذا تمت مشاركة File
مع نطاق المستخدم بأكمله.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | 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