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

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

المعلمات

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

الإرجاع

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`addCommenters(emailAddresses)`

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`addEditor(emailAddress)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`addEditor(user)`

المعلمات

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

الإرجاع

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

التفويض

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

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

`addEditors(emailAddresses)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`addViewer(emailAddress)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`addViewer(user)`

المعلمات

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

الإرجاع

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

التفويض

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

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

`addViewers(emailAddresses)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`getAccess(email)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`getAccess(user)`

المعلمات

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

الإرجاع

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

التفويض

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

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

`getAs(contentType)`

عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد تُضيف هذه الطريقة امتداد اسم الملف المناسب، على سبيل المثال "myfile.pdf". ومع ذلك، فإنه يفترِض أنّ جزء اسم الملف الذي يلي النقطة الأخيرة (إن وُجد) هو امتداد حالي يجب استبداله. نتيجةً لذلك، يصبح ملف ShoppingList.12.25.2014 هو ShoppingList.12.25.pdf.

للاطّلاع على الحصص اليومية للإحالات الناجحة، يُرجى الاطّلاع على الحصص لخدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا مؤقتًا لحدود قياسية أكثر صرامة.

المعلمات

الاسم	النوع	الوصف
`contentType`	`String`	نوع MIME المطلوب التحويل إليه بالنسبة إلى معظم العناصر المصغّرة، يكون `'application/pdf'` هو الخيار الوحيد الصالح. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يمكن استخدام أي من `'image/bmp'` أو `'image/gif'` أو `'image/jpeg'` أو `'image/png'` أيضًا. بالنسبة إلى مستند "مستندات 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());
}

المعلمات

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

الإرجاع

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

التفويض

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

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

`makeCopy(name)`

يتم إنشاء نسخة من الملف وتسمية الملف بالاسم المقدَّم.

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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`makeCopy(name, destination)`

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

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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`moveTo(destination)`

تنقل هذه العملية هذا العنصر إلى المجلد الوجهة المقدَّم.

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

المعلمات

الاسم	النوع	الوصف
`destination`	`Folder`	المجلد الذي يصبح المجلد الرئيسي الجديد.

الإرجاع

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

التفويض

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

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

`removeCommenter(emailAddress)`

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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`removeCommenter(user)`

تزيل هذه السمة المستخدم المحدّد من قائمة المعلِقين في 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()));
}

المعلمات

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

الإرجاع

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

التفويض

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

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

`removeEditor(emailAddress)`

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`removeEditor(user)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`removeViewer(emailAddress)`

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

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

المعلمات

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

الإرجاع

File — هذا File لإنشاء سلسلة.

التفويض

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

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

`removeViewer(user)`

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

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

المعلمات

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

الإرجاع

File — هذا File لإنشاء سلسلة.

التفويض

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

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

`revokePermissions(emailAddress)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`revokePermissions(user)`

المعلمات

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

الإرجاع

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

التفويض

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

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

`setContent(content)`

تؤدي هذه العملية إلى استبدال محتوى الملف بمحتوى بديل. يُعرِض استثناءً إذا كان حجم content أكبر من 10 ميغابايت.

// Creates a text file with the content 'Hello, world!'
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());

المعلمات

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

الإرجاع

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

التفويض

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

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

`setDescription(description)`

لضبط وصف File.

المعلمات

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

الإرجاع

File — هذا File، لإنشاء سلسلة

التفويض

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

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

`setName(name)`

لضبط اسم File.

المعلمات

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

الإرجاع

File — هذا File، لإنشاء سلسلة

التفويض

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

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

`setOwner(emailAddress)`

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

المعلمات

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

الإرجاع

File — هذا File، لإنشاء سلسلة

التفويض

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

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

`setOwner(user)`

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

المعلمات

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

الإرجاع

File — هذا File، لإنشاء سلسلة

التفويض

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

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

`setSecurityUpdateEnabled(enabled)`

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

مزيد من المعلومات حول تحديث الأمان لخدمة Google Drive

المعلمات

الاسم	النوع	الوصف
`enabled`	`Boolean`	ما إذا كان سيتم تفعيل متطلّبات مفتاح المورد في `File`

الإرجاع

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

التفويض

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

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

`setShareableByEditors(shareable)`

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

المعلمات

الاسم	النوع	الوصف
`shareable`	`Boolean`	`true` إذا كان يجب السماح للمستخدمين الذين لديهم أذونات تعديل بالمشاركة مع المستخدمين الآخرين أو تغيير الأذونات `false` إذا لم يكن الأمر كذلك

الإرجاع

File — هذا File، لإنشاء سلسلة

التفويض

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

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

`setSharing(accessType, permissionType)`

لتحديد فئة المستخدمين الذين يمكنهم الوصول إلى File والأذونات التي يتم منحها لهؤلاء المستخدمين، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً.

// Creates a folder that anyone on the Internet can read from and write to.
// (Domain administrators can prohibit this setting for users of a Google
// Workspace domain.)
const folder = DriveApp.createFolder('Shared Folder');
folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);

المعلمات

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

الإرجاع

File — هذا File، لإنشاء سلسلة

التفويض

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

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

`setStarred(starred)`

لضبط ما إذا كان File مميّزًا بنجمة في Drive الخاص بالمستخدم. القيمة التلقائية ل File الجديدة هي false.

المعلمات

الاسم	النوع	الوصف
`starred`	`Boolean`	`true` إذا كان يجب وضع علامة النجمة على `File` في حساب المستخدم على Drive، `false` إذا لم يكن الأمر كذلك

الإرجاع

File — هذا File، لإنشاء سلسلة

التفويض

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

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

`setTrashed(trashed)`

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

المعلمات

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

الإرجاع

File — هذا File، لإنشاء سلسلة

التفويض

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

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

Class File تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الطُرق

مستندات تفصيلية

addCommenter(emailAddress)

المعلمات

الإرجاع

التفويض

addCommenter(user)

المعلمات

الإرجاع

التفويض

addCommenters(emailAddresses)

المعلمات

الإرجاع

التفويض

addEditor(emailAddress)

المعلمات

الإرجاع

التفويض

addEditor(user)

المعلمات

الإرجاع

التفويض

addEditors(emailAddresses)

المعلمات

الإرجاع

التفويض

addViewer(emailAddress)

المعلمات

الإرجاع

التفويض

addViewer(user)

المعلمات

الإرجاع

التفويض

addViewers(emailAddresses)

المعلمات

الإرجاع

التفويض

getAccess(email)

المعلمات

الإرجاع

التفويض

getAccess(user)

المعلمات

الإرجاع

التفويض

getAs(contentType)

المعلمات

الإرجاع

getBlob()

الإرجاع

getDateCreated()

الإرجاع

التفويض

getDescription()

الإرجاع

التفويض

getDownloadUrl()

الإرجاع

التفويض

getEditors()

الإرجاع

التفويض

getId()

الإرجاع

التفويض

getLastUpdated()

الإرجاع

التفويض

getMimeType()

الإرجاع

التفويض

getName()

الإرجاع

التفويض

getOwner()

الإرجاع

التفويض

getParents()

Class File
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

`addCommenter(emailAddress)`

`addCommenter(user)`

`addCommenters(emailAddresses)`

`addEditor(emailAddress)`

`addEditor(user)`

`addEditors(emailAddresses)`

`addViewer(emailAddress)`

`addViewer(user)`

`addViewers(emailAddresses)`

`getAccess(email)`

`getAccess(user)`

`getAs(contentType)`

`getBlob()`

`getDateCreated()`

`getDescription()`

`getDownloadUrl()`

`getEditors()`

`getId()`

`getLastUpdated()`

`getMimeType()`

`getName()`

`getOwner()`

`getParents()`

`getResourceKey()`

`getSecurityUpdateEligible()`

`getSecurityUpdateEnabled()`

`getSharingAccess()`

`getSharingPermission()`

`getSize()`

`getTargetId()`

`getTargetMimeType()`

`getTargetResourceKey()`

`getThumbnail()`

`getUrl()`

`getViewers()`

`isShareableByEditors()`

`isStarred()`

`isTrashed()`

`makeCopy()`

`makeCopy(destination)`

`makeCopy(name)`

`makeCopy(name, destination)`

`moveTo(destination)`

`removeCommenter(emailAddress)`

`removeCommenter(user)`