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

المعلّمات

الاسمالنوعالوصف
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 — مفتاح المصدر للعنصر&#1939، أو 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 أو"مستندات 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

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.

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

Boolean — true إذا كان File موضوعًا في مهملات المستخدم's 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(user)

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

المعلّمات

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

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

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