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عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد.
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" بالإضافة إلى أي فرد المستخدمين الذين تم منحهم إذن الوصول بشكل صريح.
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)

عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد. هذا النمط تضيف الامتداد المناسب لاسم الملف — على سبيل المثال، "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 — البيانات ككائنات ثنائية كبيرة (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 الذي يمكن استخدامه لتنزيل الملف. المستخدمون الذين لديهم إذن بفتح الملف فقط في Google Drive يمكنه الوصول إلى عنوان URL. يمكنك استخدام عنوان 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. مشاركتها مع مستخدمين آخرين أو تغيير الأذونات.

الإرجاع

Booleantrue إذا تم السماح للمستخدمين الذين لديهم أذونات تعديل بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات false إن لم يكن

التفويض

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

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

isStarred()

تحدِّد هذه السياسة ما إذا كان قد تم تمييز File بنجمة في Drive للمستخدم.

الإرجاع

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

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

المعلمات

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

الإرجاع

FileFile هذا للسلسلة.

التفويض

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

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

removeViewer(user)

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

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

المعلمات

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

الإرجاع

FileFile هذا للسلسلة.

التفويض

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

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

revokePermissions(emailAddress)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

revokePermissions(user)

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

المعلمات

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

الإرجاع

FileFile هذا، للسلسلة

التفويض

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

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

setName(name)

لضبط اسم File.

المعلمات

الاسمالنوعالوصف
nameStringالاسم الجديد لـ File

الإرجاع

FileFile هذا، للسلسلة

التفويض

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

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

setOwner(emailAddress)

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

المعلمات

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

الإرجاع

FileFile هذا، للسلسلة

التفويض

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

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

setOwner(user)

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

المعلمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم الذي من المفترض أن يصبح المالك الجديد

الإرجاع

FileFile هذا، للسلسلة

التفويض

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

  • 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 إذا لم يكن كذلك

الإرجاع

FileFile هذا، للسلسلة

التفويض

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

  • 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

الإرجاع

FileFile هذا، للسلسلة

التفويض

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

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

setStarred(starred)

يحدّد هذا الإعداد ما إذا تم تمييز File بنجمة في Drive للمستخدم. الإعداد الافتراضي قيمة File الجديدة هي false.

المعلمات

الاسمالنوعالوصف
starredBooleantrue إذا كان يجب تمييز File بنجمة في حساب المستخدم القيادة؛ false إن لم يكن

الإرجاع

FileFile هذا، للسلسلة

التفويض

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

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

setTrashed(trashed)

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

المعلمات

الاسمالنوعالوصف
trashedBooleantrue إذا كان يجب نقل File إلى مهملات Drive للمستخدم؛ false إن لم يكن

الإرجاع

FileFile هذا، للسلسلة

التفويض

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

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