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 الذي يمكن استخدامه لتنزيل الملف. يمكن فقط للمستخدمين الذين لديهم إذن بفتح الملف في Google Drive الوصول إلى عنوان URL. يمكنك استخدام عنوان URL هذا في متصفّح لتنزيل الملف، ولكن لا يمكنك استخدامه لجلب الملف باستخدام UrlFetchApp. إذا كنت تريد تضمين محتوى الملف في النص البرمجي، استخدِم getBlob().

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

// Loops through the files and logs the download URLs to the console.
while (files.hasNext()) {
  const file = files.next();
  console.log(file.getDownloadUrl());
}

الإرجاع

String: عنوان URL الذي يمكن استخدامه لتنزيل الملف.

التفويض

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

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

تعرض هذه الطريقة قائمة بالمحرّرين في 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|null: الصورة المصغّرة للملف

التفويض

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

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

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