Class File

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

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

المعلمات

الإرجاع

‫Blob: البيانات بتنسيق ملف نصي

عرض البيانات داخل هذا الكائن ككتلة بيانات

الإرجاع

‫Blob: البيانات بتنسيق ملف نصي

تحصل على تاريخ إنشاء File.

الإرجاع

Date: تاريخ إنشاء File

التفويض

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

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

تحصل على وصف File.

الإرجاع

String: وصف File

التفويض

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

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

تحصل على عنوان 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

تحصل على قائمة بالمحرِّرين لهذا 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

تحصل على معرّف File.

الإرجاع

String: معرّف File

التفويض

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

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

تحصل على تاريخ آخر تعديل على File.

الإرجاع

Date: تاريخ آخر تعديل على File

التفويض

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

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

تحصل على نوع 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

تحصل على اسم File.

الإرجاع

String - اسم File

التفويض

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

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

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

// 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

تحصل على مجموعة من المجلدات التي هي مجلدات رئيسية فورية للعنصر File.

الإرجاع

FolderIterator: مجموعة من المجلدات التي هي مجلدات رئيسية مباشرةً للFile

التفويض

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

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

تحصل على مفتاح المورد الخاص بـ File المطلوب للوصول إلى العناصر التي تمّت مشاركتها باستخدام رابط.

الإرجاع

String: مفتاح المورد الخاص بـ File.

التفويض

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

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

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

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

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

الإرجاع

Boolean — ما إذا كان يمكن تطبيق متطلّبات مفتاح المورد على File.

التفويض

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

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

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

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

الإرجاع

Boolean: ما إذا كان متطلّب مفتاح المورد مفعّلاً لهذا File.

التفويض

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

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

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

الإرجاع

Access - فئة المستخدمين الذين يمكنهم الوصول إلى File

التفويض

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

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

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

الإرجاع

Permission: الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى File

التفويض

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

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

تحصل على عدد وحدات البايت المستخدَمة لتخزين File في Drive. يُرجى العِلم أنّه لا يتم احتساب ملفات تطبيقات Google Workspace ضمن حدود مساحة التخزين في Drive، وبالتالي يتم عرض قيمة 0 بايت.

الإرجاع

Integer: عدد وحدات البايت المستخدَمة لتخزين File في Drive

التفويض

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

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

إذا كان هذا اختصارًا، يتم عرض رقم تعريف العنصر الذي يشير إليه.

بخلاف ذلك، يتم عرض 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: معرّف السلعة المستهدَفة.

إذا كان هذا العنصر اختصارًا، يتم عرض نوع 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 للعنصر المستهدَف

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

إذا لم يكن الملف اختصارًا، يتم عرض 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

تحصل على صورة مصغّرة للملف، أو 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

تحصل على عنوان URL الذي يمكن استخدامه لفتح File في أحد تطبيقات Google، مثل Drive أو "مستندات Google".

الإرجاع

String: عنوان URL الذي يمكن استخدامه لعرض هذا File في أحد تطبيقات Google، مثل Drive أو "مستندات Google"

التفويض

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

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

تحصل على قائمة بالمشاهدين والمعلقين لهذا 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

لتحديد ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل على File بمشاركتها مع مستخدمين آخرين أو تغيير الأذونات

الإرجاع

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

التفويض

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

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

لتحديد ما إذا تم وضع علامة "تمييز بعلامة النجمة" على File في Drive الخاص بالمستخدم.

الإرجاع

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

التفويض

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

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

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

الإرجاع

Boolean — true إذا كان File في المهملات في حساب المستخدم على Drive false إذا لم يكن الأمر كذلك

التفويض

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

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

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

// 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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

تؤدي هذه العملية إلى استبدال محتوى الملف بمحتوى بديل. يُعرِض استثناءً إذا كان حجم 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());

المعلمات

الإرجاع

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

التفويض

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

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

لضبط وصف File.

المعلمات

الإرجاع

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

التفويض

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

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

تُستخدَم لضبط اسم File.

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

لتحديد فئة المستخدمين الذين يمكنهم الوصول إلى 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);

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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

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

المعلمات

الإرجاع

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

التفويض

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

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