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));
}

المَعلمات

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

رحلة العودة

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

التفويض

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

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

addCommenter(user)

إضافة المستخدم المحدد إلى قائمة المعلِّقين في 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');

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

المَعلمات

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

رحلة العودة

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));
}

المَعلمات

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

رحلة العودة

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

رحلة العودة

Booleantrue إذا كانت الملفات 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());
}

المَعلمات

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

رحلة العودة

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

المَعلمات

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

رحلة العودة

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

المَعلمات

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

// 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');
}

المَعلمات

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

رحلة العودة

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

التفويض

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

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

removeCommenter(user)

إزالة مستخدم معيّن من قائمة المعلِّقين في 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.
  console.log(file.removeCommenter(Session.getActiveUser()));
}

المَعلمات

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

رحلة العودة

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

التفويض

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

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

removeEditor(emailAddress)

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

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

المَعلمات

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

رحلة العودة

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

التفويض

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

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

removeEditor(user)

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

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

المَعلمات

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

رحلة العودة

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

التفويض

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

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

removeViewer(emailAddress)

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

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

المَعلمات

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

رحلة العودة

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

التفويض

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

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

removeViewer(user)

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

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

المَعلمات

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

رحلة العودة

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

التفويض

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

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

revokePermissions(emailAddress)

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

المَعلمات

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

رحلة العودة

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

التفويض

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

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

revokePermissions(user)

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

المَعلمات

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

رحلة العودة

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

التفويض

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

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

setContent(content)

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

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

المَعلمات

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