Class File

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

المَعلمات

رحلة العودة

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

الحصول على الإذن الممنوح للمستخدم المحدّد

المَعلمات

رحلة العودة

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

التفويض

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

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

الحصول على الإذن الممنوح للمستخدم المحدّد

المَعلمات

رحلة العودة

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

التفويض

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

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

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

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

المَعلمات

رحلة العودة

Blob: البيانات الثنائية الفائقة الحجم

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

رحلة العودة

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 هذا. إذا كان المستخدم الذي نفّذ النص البرمجي لا يملك الإذن بتعديل المحتوى على 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

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

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

بالنسبة إلى ملفات 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!'
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.)
var 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