تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

المعلَمات

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

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

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

التفويض

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

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

`addCommenter(user)`

المعلَمات

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

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

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

التفويض

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

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

`addCommenters(emailAddresses)`

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

المعلَمات

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

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

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

التفويض

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

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

`addEditor(emailAddress)`

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

المعلَمات

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

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

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

التفويض

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

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

`addEditor(user)`

المعلَمات

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

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

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

التفويض

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

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

`addEditors(emailAddresses)`

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

المعلَمات

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

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

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

التفويض

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

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

`addViewer(emailAddress)`

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

المعلَمات

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

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

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

التفويض

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

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

`addViewer(user)`

المعلَمات

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

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

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

التفويض

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

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

`addViewers(emailAddresses)`

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

المعلَمات

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

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

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

التفويض

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

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

يعرض هذا الحقل تاريخ إنشاء 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 للمستخدم.

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

Boolean — true إذا كانت 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)`

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

المعلَمات

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

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

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

التفويض

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

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

`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`	المجلد الذي سيصبح المجلد الرئيسي الجديد.

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

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

التفويض

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

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

`removeCommenter(emailAddress)`

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

المعلَمات

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

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

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

التفويض

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

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

`removeCommenter(user)`

المعلَمات

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

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

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

التفويض

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

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

`removeEditor(emailAddress)`

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

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

المعلَمات

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

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

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

التفويض

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

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

`removeEditor(user)`

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

المعلَمات

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

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

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

التفويض

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

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

`removeViewer(emailAddress)`

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

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

المعلَمات

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

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

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

التفويض

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

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

`removeViewer(user)`

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

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

المعلَمات

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

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

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

التفويض

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

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

`revokePermissions(emailAddress)`

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

المعلَمات

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

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

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

التفويض

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

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

`revokePermissions(user)`

المعلَمات

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

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

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

التفويض

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

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

`setContent(content)`

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

المعلَمات

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

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

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

التفويض

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

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

`setDescription(description)`

لتعيين وصف File.

المعلَمات

الاسم	النوع	الوصف
`description`	`String`	الوصف الجديد لـ `File`

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

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

التفويض

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

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

`setName(name)`

لتعيين اسم File.

المعلَمات

الاسم	النوع	الوصف
`name`	`String`	الاسم الجديد لـ `File`

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

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

التفويض

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

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

`setOwner(emailAddress)`

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

المعلَمات

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

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

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

التفويض

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

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

`setOwner(user)`

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

المعلَمات

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

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

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

التفويض

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

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

`setSecurityUpdateEnabled(enabled)`

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

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

المعلَمات

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

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

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

التفويض

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

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

`setShareableByEditors(shareable)`

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

المعلَمات

الاسم	النوع	الوصف
`shareable`	`Boolean`	`true` في حال كان مسموحًا للمستخدمين الذين لديهم أذونات تعديل بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات، `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);

المعلَمات

الاسم	النوع	الوصف
`accessType`	`Access`	فئة المستخدمين الذين يجب أن يتمكنوا من الوصول إلى `File`
`permissionType`	`Permission`	الأذونات التي يجب منحها للمستخدمين الذين يمكنهم الوصول إلى `File`

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

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

التفويض

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

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

`setStarred(starred)`

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

المعلَمات

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

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

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

التفويض

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

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

`setTrashed(trashed)`

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

المعلَمات

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

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

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

التفويض

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

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