Class File

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ملف

ملف في 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. إذا كان المستخدم مدرجًا من قبل في قائمة المشاهدين، فإن هذه الطريقة تروّج للمستخدم خارج قائمة المشاهدين.

المعلَمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم المراد إضافته.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

addCommenter(user)

إضافة المستخدم المعني إلى قائمة المعلقين في File. إذا كان المستخدم مدرجًا من قبل في قائمة المشاهدين، فإن هذه الطريقة تروّج للمستخدم خارج قائمة المشاهدين.

المعلَمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم لإضافته.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

addCommenters(emailAddresses)

إضافة المصفوفة المحدّدة من المستخدمين إلى قائمة المعلّقين في File. وإذا كان أي من المستخدمين مدرجًا في قائمة المشاهدين، فستعمل هذه الطريقة على استبعادهم من قائمة المشاهدين.

المعلَمات

الاسمالنوعالوصف
emailAddressesString[]مصفوفة من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتهم.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

addEditor(emailAddress)

إضافة المستخدم المحدد إلى قائمة محرِّري File. إذا كان المستخدم مدرجًا بالفعل في قائمة المشاهدين، فإن هذه الطريقة تروّج للمستخدم خارج قائمة المشاهدين.

المعلَمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم المراد إضافته.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

addEditor(user)

إضافة المستخدم المحدد إلى قائمة محرِّري File. إذا كان المستخدم مدرجًا بالفعل في قائمة المشاهدين، فإن هذه الطريقة تروّج للمستخدم خارج قائمة المشاهدين.

المعلَمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم لإضافته.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

addEditors(emailAddresses)

لإضافة الصفيف المحدد من المستخدمين إلى قائمة المحررين لـ File. وإذا كان أي من المستخدمين مدرجًا في قائمة المشاهدين، ستنقلهم هذه الطريقة من قائمة المشاهدين.

المعلَمات

الاسمالنوعالوصف
emailAddressesString[]مصفوفة من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتهم.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

addViewer(emailAddress)

لإضافة المستخدم المحدد إلى قائمة مشاهدي File. إذا كان المستخدم مدرجًا من قبل في قائمة المحررين، فلن يكون لهذه الطريقة أي تأثير.

المعلَمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم المراد إضافته.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

addViewer(user)

لإضافة المستخدم المحدد إلى قائمة مشاهدي File. إذا كان المستخدم مدرجًا من قبل في قائمة المحررين، فلن يكون لهذه الطريقة أي تأثير.

المعلَمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم لإضافته.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

addViewers(emailAddresses)

لإضافة الصفيف المحدد من المستخدمين إلى قائمة مشاهدي File. إذا كان أي من المستخدمين مدرجًا من قبل في قائمة المحررين، فلن يكون لهذه الطريقة أي تأثير عليهم.

المعلَمات

الاسمالنوعالوصف
emailAddressesString[]مصفوفة من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتهم.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

getAccess(email)

يحصل على الإذن الممنوح للمستخدم المُحدّد.

المعلَمات

الاسمالنوعالوصف
emailStringعنوان البريد الإلكتروني للمستخدم الذي يجب التحقق من أذوناته

تذكرة ذهاب وعودة

Permission — الأذونات الممنوحة للمستخدم

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getAccess(user)

يحصل على الإذن الممنوح للمستخدم المُحدّد.

المعلَمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم يجب التحقّق من أذوناته

تذكرة ذهاب وعودة

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 التي تم إنشاؤها حديثًا إلى حصص حصص أكثر صرامة.

المعلَمات

الاسمالنوعالوصف
contentTypeStringنوع MIME المراد التحويل إليه. وبالنسبة إلى معظم الكائنات الثنائية الكبيرة، 'application/pdf' هو الخيار الوحيد الصالح. بالنسبة إلى الصور بالتنسيق BMP أو GIF أو JPEG أو PNG، يكون أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png' صالحًا أيضًا.

تذكرة ذهاب وعودة

Blob — البيانات كائن كائن ثنائي كبير.


getBlob()

اعرض البيانات داخل هذا الكائن كائن كائن ثنائي كبير.

تذكرة ذهاب وعودة

Blob — البيانات كائن كائن ثنائي كبير.


getDateCreated()

يعرض هذا الحقل تاريخ إنشاء File.

تذكرة ذهاب وعودة

Date — تاريخ إنشاء File

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getDescription()

للحصول على وصف File.

تذكرة ذهاب وعودة

String — وصف File

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

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()

للحصول على معرّف File.

تذكرة ذهاب وعودة

String — رقم تعريف File

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getLastUpdated()

للحصول على تاريخ آخر تحديث لـ File.

تذكرة ذهاب وعودة

Date — تاريخ آخر تحديث لـ File

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getMimeType()

للحصول على نوع MIME للملف.

تذكرة ذهاب وعودة

String — نوع MIME للملف.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getName()

للحصول على اسم File.

تذكرة ذهاب وعودة

String — اسم File

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

getOwner()

الحصول على مالك File.

تذكرة ذهاب وعودة

User — كائن User يمثل المالك

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

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

isShareableByEditors()

يحدِّد هذا الإعداد ما إذا كان يُسمَح للمستخدمين الذين لديهم أذونات تعديل في File بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات.

تذكرة ذهاب وعودة

Boolean - true في حال السماح للمستخدمين الذين لديهم أذونات للتعديل بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات، false إذا لم يكن مسموحًا بذلك

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • 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 للمستخدم.

تذكرة ذهاب وعودة

Booleantrue إذا كانت File في مهملات Drive للمستخدم، false إذا لم تكن موجودة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive

makeCopy()

لإنشاء نسخة من الملف.

تذكرة ذهاب وعودة

File — النسخة الجديدة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

makeCopy(destination)

لإنشاء نسخة من الملف في الدليل الوجهة.

المعلَمات

الاسمالنوعالوصف
destinationFolderالدليل المطلوب نسخ الملف إليه.

تذكرة ذهاب وعودة

File — النسخة الجديدة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

makeCopy(name)

لإنشاء نسخة من الملف وتسميته بالاسم الذي تم تقديمه.

المعلَمات

الاسمالنوعالوصف
nameStringاسم الملف الذي يجب تطبيقه على النسخة الجديدة.

تذكرة ذهاب وعودة

File — النسخة الجديدة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

makeCopy(name, destination)

لإنشاء نسخة من الملف في الدليل الوجهة وتسميته بالاسم المقدم.

المعلَمات

الاسمالنوعالوصف
nameStringاسم الملف الذي يجب تطبيقه على النسخة الجديدة.
destinationFolderالدليل المطلوب نسخ الملف إليه.

تذكرة ذهاب وعودة

File — النسخة الجديدة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

moveTo(destination)

لنقل هذا العنصر إلى مجلد الوجهة الذي تم تقديمه.

يجب أن يكون المستخدم الحالي هو مالك الملف أو يكون على الأقل لديه حق التعديل في المجلد الرئيسي الحالي للعنصر من أجل نقل العنصر إلى المجلد الوجهة.

المعلَمات

الاسمالنوعالوصف
destinationFolderالمجلد الذي سيصبح المجلد الرئيسي الجديد.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

removeCommenter(emailAddress)

لإزالة المستخدم المحدد من قائمة المعلقين في File. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى File إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، مثلاً، إذا تمت مشاركة File مع نطاق المستخدم بأكمله.

المعلَمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم المطلوب إزالته.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

removeCommenter(user)

لإزالة المستخدم المحدد من قائمة المعلقين في File. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى File إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، مثلاً، إذا تمت مشاركة File مع نطاق المستخدم بأكمله.

المعلَمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم لإزالته.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

removeEditor(emailAddress)

إزالة المستخدم المحدد من قائمة المحررين لـ File. لا تحظر هذه الطريقة المستخدمين من الوصول إلى File إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم حق الوصول العام، مثلاً، إذا تمت مشاركة File مع نطاق المستخدم بالكامل، أو إذا كانت File في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

وبالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.

المعلَمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم المطلوب إزالته.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

removeEditor(user)

إزالة المستخدم المحدد من قائمة المحررين لـ File. لا تحظر هذه الطريقة المستخدمين من الوصول إلى File إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم حق الوصول العام، مثلاً، إذا تمت مشاركة File مع نطاق المستخدم بالكامل، أو إذا كانت File في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

وبالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.

المعلَمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم لإزالته.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

removeViewer(emailAddress)

يزيل المستخدم المعين من قائمة المشاهدين والمعلقين في File. ليس لهذه الطريقة أي تأثير إذا كان المستخدم محررًا، وليس مشاهدًا أو معلقًا. ولا تمنع هذه الطريقة أيضًا المستخدمين من الوصول إلى File إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، مثلاً، إذا تمت مشاركة File مع نطاق المستخدم بأكمله، أو إذا كانت File في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

وبالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المحررين.

المعلَمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم المطلوب إزالته.

تذكرة ذهاب وعودة

File — هذا File للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

removeViewer(user)

يزيل المستخدم المعين من قائمة المشاهدين والمعلقين في File. ليس لهذه الطريقة أي تأثير إذا كان المستخدم محررًا، وليس مشاهدًا. ولا تحظر هذه الطريقة أيضًا المستخدمين من الوصول إلى File إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، مثلاً، إذا تمت مشاركة File مع نطاق المستخدم بالكامل، أو إذا كانت File في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

وبالنسبة إلى ملفات Drive، يؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المحررين.

المعلَمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم لإزالته.

تذكرة ذهاب وعودة

File — هذا File للتسلسل.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

revokePermissions(emailAddress)

يُبطِل حق الوصول إلى File الممنوحة للمستخدم المُحدَّد. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى File إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، مثلاً، إذا تمت مشاركة File مع نطاق المستخدم بأكمله.

المعلَمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم الذي يجب إبطال إمكانية وصوله.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

revokePermissions(user)

يُبطِل حق الوصول إلى File الممنوحة للمستخدم المُحدَّد. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى File إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن بالوصول العام، مثلاً، إذا تمت مشاركة File مع نطاق المستخدم بأكمله.

المعلَمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم الذي يجب إبطال إمكانية وصوله

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

setContent(content)

استبدال محتوى الملف باستبدال معيّن. لعرض استثناء إذا كان حجم content أكبر من 10 ميغابايت.

المعلَمات

الاسمالنوعالوصف
contentStringالمحتوى الجديد للملف.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

setDescription(description)

لتعيين وصف File.

المعلَمات

الاسمالنوعالوصف
descriptionStringالوصف الجديد لـ File

تذكرة ذهاب وعودة

File - هذا File، للسلسلة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

setName(name)

لتعيين اسم File.

المعلَمات

الاسمالنوعالوصف
nameStringالاسم الجديد لـ File

تذكرة ذهاب وعودة

File - هذا File، للسلسلة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

setOwner(emailAddress)

يغيّر مالك File. تمنح هذه الطريقة أيضًا المالك السابق إذنًا صريحًا بتعديل محتوى File.

المعلَمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم الذي يجب أن يصبح المالك الجديد

تذكرة ذهاب وعودة

File - هذا File، للسلسلة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

setOwner(user)

يغيّر مالك File. تمنح هذه الطريقة أيضًا المالك السابق إذنًا صريحًا بتعديل محتوى File.

المعلَمات

الاسمالنوعالوصف
userUserإقرار للمستخدم الذي يجب أن يصبح المالك الجديد

تذكرة ذهاب وعودة

File - هذا File، للسلسلة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

setSecurityUpdateEnabled(enabled)

يحدِّد هذا الإعداد ما إذا كان File يتطلّب مفتاح وصول للوصول عند مشاركته باستخدام رابط. يتم تمكين الملفات والمجلدات المؤهلة بشكل افتراضي.

مزيد من المعلومات حول تحديث الأمان في Google Drive.

المعلَمات

الاسمالنوعالوصف
enabledBooleanيمكنك تفعيل شرط مفتاح المورد لـ File.

تذكرة ذهاب وعودة

File — هذا File، للسلسلة.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

setShareableByEditors(shareable)

يحدّد هذا الإعداد ما إذا كان مسموحًا للمستخدمين الذين لديهم أذونات تعديل في File بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات. يكون File التلقائي هو true.

المعلَمات

الاسمالنوعالوصف
shareableBooleantrue في حال كان مسموحًا للمستخدمين الذين لديهم أذونات تعديل بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات، false في حال عدم السماح بذلك

تذكرة ذهاب وعودة

File - هذا 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);

المعلَمات

الاسمالنوعالوصف
accessTypeAccessفئة المستخدمين الذين يجب أن يتمكنوا من الوصول إلى File
permissionTypePermissionالأذونات التي يجب منحها للمستخدمين الذين يمكنهم الوصول إلى File

تذكرة ذهاب وعودة

File - هذا File، للسلسلة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

setStarred(starred)

لتعيين ما إذا كان سيتم تمييز File بنجمة في Drive للمستخدم أم لا. الإعداد التلقائي للصفحات File الجديدة هو false.

المعلَمات

الاسمالنوعالوصف
starredBooleantrue إذا كان يجب تمييز File بنجمة في Drive للمستخدم، false إذا لم يكن مميزًا

تذكرة ذهاب وعودة

File - هذا File، للسلسلة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive

setTrashed(trashed)

لتعيين ما إذا كان File في مهملات Drive للمستخدم أم لا. يمكن للمالك فقط نقل المهملات إلى File. الإعداد التلقائي في File الجديدة هو false.

المعلَمات

الاسمالنوعالوصف
trashedBooleantrue إذا كان يجب نقل File إلى مهملات Drive للمستخدم، false إذا لم يتم نقلها

تذكرة ذهاب وعودة

File - هذا File، للسلسلة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/drive