تمت ترجمة هذه الصفحة بواسطة 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`	اعرض البيانات داخل هذا الكائن ككائنات ثنائية (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`	الحصول على مالك الملف.
`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(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. إذا كان المستخدم حاليًا في قائمة المشاهدين، تعمل هذه الطريقة على الترويج للمستخدم من قائمة المشاهدين.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace 'cloudysanfrancisco@gmail.com' with the email address that you
// want to add as a commenter.
while (files.hasNext()) {
  const file = files.next();
  email = 'cloudysanfrancisco@gmail.com';
  console.log(file.addCommenter(email));
}

المَعلمات

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

رحلة العودة

File: هذا File، لسلسلة الكتب.

التفويض

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

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

`addCommenter(user)`

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Adds the active user as a commenter.
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter(Session.getActiveUser());
}

المَعلمات

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

رحلة العودة

File: هذا File، لسلسلة الكتب.

التفويض

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

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

`addCommenters(emailAddresses)`

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

while (files.hasNext()) {
  const file = files.next();
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and
  // 'baklavainthebalkans@gmail.com' with the email addresses to add as commenters.
  const emails = ['cloudysanfrancisco@gmail.com','baklavainthebalkans@gmail.com'];
  console.log(file.addCommenters(emails));
}

المَعلمات

الاسم	النوع	الوصف
`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).

رحلة العودة

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 الذي يمكن استخدامه لتنزيل الملف لا يمكن الوصول إلى عنوان URL إلا للمستخدمين الذين لديهم إذن بفتح الملف في Google Drive. يمكنك استخدام عنوان URL هذا في أحد المتصفحات لتنزيل الملف، ولكن لا يمكنك استخدام جلب الملف مع UrlFetchApp. وإذا كنت تريد استخدام محتوى الملف في النص البرمجي، استخدِم getBlob().

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the download URLs to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getDownloadUrl());
}

رحلة العودة

String: عنوان URL الذي يمكن استخدامه لتنزيل الملف.

التفويض

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

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

`getEditors()`

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Adds the email addresses in the array as editors of each file.
  // TODO(developer): Replace 'cloudysanfrancisco@gmail.com'
  // and 'baklavainthebalkans@gmail.com' with valid email addresses.
  file.addEditors(['cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com']);

  // Gets a list of the file editors.
  const editors = file.getEditors();

  // For each file, logs the editors' email addresses to the console.
  for (const editor of editors) {
    console.log(editor.getEmail());
  }
}

رحلة العودة

User[]: إذا كان المستخدم لديه الإذن بتعديل محتوى File هذا، سيتم عرض قائمة بالمحرِّرين. في حال لم يكن لدى المستخدم الإذن بتعديل المحتوى، سيتم عرض صفيف فارغ.

التفويض

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

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 للملف

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the MIME type to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getMimeType());
}

رحلة العودة

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

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files and logs the names of the file owners to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getOwner().getName());
}

رحلة العودة

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.

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the target ID of the shortcut.
console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);

رحلة العودة

String: معرّف السلعة المستهدَف

`getTargetMimeType()`

وإذا كان هذا اختصارًا، سيتم عرض نوع MIME للعنصر الذي يشير إليه.

وإلا، سيتم عرض null.

// The ID of the file for which to make a shortcut and the ID of
// the folder to which you want to add the shortcut.
// TODO(developer): Replace the file and folder IDs with your IDs.
const fileId = 'abc123456';
const folderId = 'xyz987654';

// Gets the folder to add the shortcut to.
const folder = DriveApp.getFolderById(folderId);

// Creates a shortcut of the file and moves it to the specified folder.
const shortcut = DriveApp.createShortcut(fileId).moveTo(folder);

// Logs the MIME type of the file that the shortcut points to.
console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);

رحلة العودة

String: نوع MIME للعنصر المستهدف.

`getTargetResourceKey()`

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

إذا لم يكن الملف اختصارًا، سيتم عرض null.

// Gets a file by its ID.
// TODO(developer): Replace 'abc123456' with your file ID.
const file = DriveApp.getFileById('abc123456');

// If the file is a shortcut, returns the resource key of the file that it points to.
console.log(file.getTargetResourceKey());

رحلة العودة

String: مفتاح مورد العنصر المستهدف أو null إذا لم يكن الملف اختصارًا.

التفويض

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

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

`getThumbnail()`

يمكن الحصول على صورة مصغّرة للملف أو null في حال عدم توفّر صورة مصغّرة.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Logs the thumbnail image for each file to the console as a blob,
  // or null if no thumbnail exists.
  console.log(file.getThumbnail());
}

رحلة العودة

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، ستعرض هذه الطريقة صفيفًا فارغًا.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // For each file, logs the viewers' email addresses to the console.
  const viewers = file.getViewers();
  for (viewer of viewers) {
    console.log(viewer.getEmail());
  }
}

رحلة العودة

User[]: إذا كان المستخدم يملك الإذن بتعديل محتوى File هذا، سيتم عرض قائمة المشاهدين والمعلِّقين. في حال لم يكن لدى المستخدم الإذن بتعديل المحتوى، سيتم عرض صفيف فارغ.

التفويض

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

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

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and logs the file name to the console.
  console.log(file.makeCopy().getName());
}

رحلة العودة

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

التفويض

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

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

`makeCopy(destination)`

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and adds it to the specified folder.
  // TODO(developer): Replace the folder ID with your own.
  const destination = DriveApp.getFolderById('123456abcxyz');
  const copiedFile = file.makeCopy(destination);

  // Logs the file names to the console.
  console.log(copiedFile.getName());
}

المَعلمات

الاسم	النوع	الوصف
`destination`	`Folder`	الدليل الذي تريد نسخ الملف إليه.

رحلة العودة

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

التفويض

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

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

`makeCopy(name)`

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

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file and sets the name to 'Test-Copy.'
  const filename = file.makeCopy('Test-Copy');

  // Logs the copied file's name to the console.
  console.log(filename.getName());
}

المَعلمات

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

رحلة العودة

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

التفويض

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

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

`makeCopy(name, destination)`

تنشئ هذه السياسة نسخة من الملف في دليل الوجهة وتسمّيها بالاسم المقدّم.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Creates a copy of each file, sets the file name, and adds the copied file
  // to the specified folder.
  // TODO(developer): Replace the folder ID with your own.
  const destination = DriveApp.getFolderById('123456abcxyz');
  const copiedFile = file.makeCopy('Test-Copy', destination);

  // Logs the file names to the console.
  console.log(copiedFile.getName());
}

المَعلمات

الاسم	النوع	الوصف
`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 مع النطاق الكامل للمستخدم.

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  // TODO(developer): Replace the email with the email of the user you want to remove.
  file.removeCommenter('cloudysanfrancisco@gmail.com');
}

المَعلمات

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

رحلة العودة

File: هذا File، لسلسلة الكتب.

التفويض

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

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

`removeCommenter(user)`

// Gets a list of all files in Google Drive with the given name.
// TODO(developer): Replace the file name with your own.
const files = DriveApp.getFilesByName('Test');

// Loops through the files.
while (files.hasNext()) {
  const file = files.next();

  // Removes the given user from the list of commenters for each file.
  console.log(file.removeCommenter(Session.getActiveUser()));
}

المَعلمات

الاسم	النوع	الوصف
`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 ميغابايت.

// Creates a text file with the content 'Hello, world!'
file = DriveApp.createFile('New Text File', 'Hello, world!');

// Logs the content of the text file to the console.
console.log(file.getBlob().getDataAsString());

// Updates the content of the text file to 'Updated text!'
file.setContent('Updated text!')

// Logs content of the text file to the console.
console.log(file.getBlob().getDataAsString());

المَعلمات

الاسم	النوع	الوصف
`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