Class File

ملفّ

ملف في Google Drive يمكن الوصول إلى الملفات أو إنشاؤها من DriveApp. 

// Trash every untitled spreadsheet that hasn't been updated in a week.
const files = DriveApp.getFilesByName('Untitled spreadsheet');
while (files.hasNext()) {
  const 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عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد
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الحصول على مالك الملف
getParents()FolderIteratorتحصل على مجموعة من المجلدات التي هي مجلدات رئيسية فورية للعنصر File.
getResourceKey()Stringتحصل على مفتاح المورد الخاص بـ File المطلوب للوصول إلى العناصر التي تمّت مشاركتها باستخدام رابط.
getSecurityUpdateEligible()Booleanتحصل على ما إذا كان هذا File مؤهلاً لتطبيق تحديث الأمان الذي يتطلب مفتاح مصدر للوصول عند مشاركته باستخدام رابط.
getSecurityUpdateEnabled()Booleanتحصل على ما إذا كان هذا File يتطلّب مفتاح مورد للوصول إليه عند مشاركته باستخدام رابط.
getSharingAccess()Accessتحصل على فئة المستخدمين الذين يمكنهم الوصول إلى File، بالإضافة إلى أي مستخدمين individual تم منحهم إذن الوصول بشكل صريح.
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. إذا كان المستخدم مدرَجًا في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين. 

const files = DriveApp.getFilesByName('Test');

// Loops through the files
while (files.hasNext()) {
  const file = files.next();
  file.addCommenter('hello@example.com');
}

المعلمات

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

الحصول على الإذن الممنوح لمستخدم معيّن لا تتيح الطريقة عرض أذونات "مجموعة Google" أو الأذونات المُكتسَبة من خلال "مجموعات Google".

المعلمات

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

الإرجاع

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

التفويض

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

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

getAccess(user)

الحصول على الإذن الممنوح لمستخدم معيّن لا تتيح الطريقة عرض أذونات "مجموعة Google" أو الأذونات المُكتسَبة من خلال "مجموعات Google".

المعلمات

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

الإرجاع

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

التفويض

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

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

getAs(contentType)

عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد تُضيف هذه الطريقة امتداد اسم الملف المناسب، على سبيل المثال "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' أيضًا. بالنسبة إلى مستند "مستندات Google"، يكون 'text/markdown' صالحًا أيضًا.

الإرجاع

‫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 الذي يمكن استخدامه لتنزيل الملف. لا يمكن الوصول إلى عنوان 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، بالإضافة إلى أي مستخدمين individual تم منحهم إذن الوصول بشكل صريح.

الإرجاع

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. إذا لم يكن لدى المستخدم الذي executes the script إذن وصول للتعديل إلى 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 (const 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());
}

المعلمات

الاسمالنوعالوصف
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 للمستخدم بالكامل، أو إذا كان File في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

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

المعلمات

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

الإرجاع

File — هذا الرمز File، لإنشاء سلسلة.

التفويض

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

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

removeEditor(user)

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

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

المعلمات

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

الإرجاع

File — هذا الرمز File، لإنشاء سلسلة.

التفويض

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

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

removeViewer(emailAddress)

تؤدي هذه العملية إلى إزالة المستخدم المحدّد من قائمة المشاهدين والمعلّقين في File. لا تؤثّر هذه المحاولة في حال كان المستخدم محرِّرًا وليس مشاهدًا أو معلِقًا. لا تحظر هذه الطريقة أيضًا المستخدمين من الوصول إلى 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!'
const 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.)
const 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