ملف في Google Drive يمكن الوصول إلى الملفات أو إنشاؤها من "DriveApp
".
// Trash every untitled spreadsheet that hasn't been updated in a week. var files = DriveApp.getFilesByName('Untitled spreadsheet'); while (files.hasNext()) { var file = files.next(); if (new Date() - file.getLastUpdated() > 7 * 24 * 60 * 60 * 1000) { file.setTrashed(true); } }
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
addCommenter(emailAddress) | File | أضِف المستخدم المعني إلى قائمة المعلِّقين على File . |
addCommenter(user) | File | أضِف المستخدم المعني إلى قائمة المعلِّقين على File . |
addCommenters(emailAddresses) | File | أضِف مجموعة المستخدمين المحدّدة إلى قائمة المعلِّقين على File . |
addEditor(emailAddress) | File | لإضافة المستخدم المحدّد إلى قائمة المحرِّرين في File . |
addEditor(user) | File | لإضافة المستخدم المحدّد إلى قائمة المحرِّرين في File . |
addEditors(emailAddresses) | File | لإضافة مجموعة المستخدمين المحدّدة إلى قائمة المحرِّرين في File . |
addViewer(emailAddress) | File | لإضافة المستخدم المحدّد إلى قائمة المشاهدين في File . |
addViewer(user) | File | لإضافة المستخدم المحدّد إلى قائمة المشاهدين في File . |
addViewers(emailAddresses) | File | لإضافة مصفوفة المستخدمين المحددة إلى قائمة العارضين لـ File . |
getAccess(email) | Permission | يحصل على الإذن الذي تم منحه للمستخدم المحدّد. |
getAccess(user) | Permission | يحصل على الإذن الذي تم منحه للمستخدم المحدّد. |
getAs(contentType) | Blob | عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير يتم تحويله إلى نوع المحتوى المحدّد. |
getBlob() | Blob | عرض البيانات داخل هذا الكائن على هيئة كائن ثنائي كبير (blob). |
getDateCreated() | Date | يعرض هذا الحقل تاريخ إنشاء File . |
getDescription() | String | للحصول على وصف File . |
getDownloadUrl() | String | الحصول على عنوان URL الذي يمكن استخدامه لتنزيل الملف |
getEditors() | User[] | يمكنك الحصول على قائمة بالمحرِّرين في File . |
getId() | String | الحصول على رقم تعريف File |
getLastUpdated() | Date | يمكنك الحصول على تاريخ آخر تعديل لـ File . |
getMimeType() | String | نحصل على نوع MIME للملف. |
getName() | String | يحصل على اسم File . |
getOwner() | User | الوصول إلى مالك الملف. |
getParents() | FolderIterator | للحصول على مجموعة من المجلدات التي تمثّل عناصر رئيسية مباشرة لـ File . |
getResourceKey() | String | الحصول على مفتاح المورد الخاص بـ File المطلوب للوصول إلى العناصر التي تمت مشاركتها باستخدام رابط |
getSecurityUpdateEligible() | Boolean | معرفة ما إذا كان File هذا مؤهَّلاً لتطبيق تحديث الأمان الذي
يتطلب مفتاح مورد للوصول إليه عند مشاركته باستخدام رابط. |
getSecurityUpdateEnabled() | Boolean | تتيح لك معرفة ما إذا كان File هذا يتطلّب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط. |
getSharingAccess() | Access | لمعرفة فئة المستخدمين الذين يمكنهم الوصول إلى File ، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكلٍ صريح. |
getSharingPermission() | Permission | يحصل على الإذن الممنوح لهؤلاء المستخدمين الذين يمكنهم الوصول إلى File ،
بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً. |
getSize() | Integer | الحصول على عدد وحدات البايت المستخدمة لتخزين File في Drive. |
getTargetId() | String | إذا كان هذا اختصارًا، يتم عرض رقم تعريف العنصر الذي يشير إليه. |
getTargetMimeType() | String | إذا كان هذا اختصارًا، يتم عرض نوع MIME للعنصر الذي يشير إليه. |
getTargetResourceKey() | String | إذا كان الملف اختصارًا، يتم عرض مفتاح المورد للعنصر الذي يشير إليه. |
getThumbnail() | Blob | الحصول على صورة مصغّرة للملف أو null في حال عدم توفّر صورة مصغّرة |
getUrl() | String | الحصول على عنوان URL يمكن استخدامه لفتح File في أحد تطبيقات Google، مثل
Drive أو "مستندات Google". |
getViewers() | User[] | للحصول على قائمة المشاهدين والمعلقين على File هذا. |
isShareableByEditors() | Boolean | تحدِّد هذه السياسة ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل سياسة File
بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات. |
isStarred() | Boolean | تحدِّد هذه السياسة ما إذا كان قد تم تمييز File بنجمة في حساب Drive للمستخدم. |
isTrashed() | Boolean | تحدِّد هذه السياسة ما إذا كان ملف "File " في مهملات حساب Drive الخاص بالمستخدم. |
makeCopy() | File | تنشئ نسخة من الملف. |
makeCopy(destination) | File | تنشئ نسخة من الملف في دليل الوجهة. |
makeCopy(name) | File | تنشئ نسخة من الملف وتسميته بالاسم الذي تم تقديمه. |
makeCopy(name, destination) | File | تنشئ نسخة من الملف في دليل الوجهة وتسمّيه بالاسم المقدّم. |
moveTo(destination) | File | ينقل هذا العنصر إلى مجلد الوجهة المحدَّد. |
removeCommenter(emailAddress) | File | لإزالة المستخدم المحدّد من قائمة المعلِّقين في File . |
removeCommenter(user) | File | لإزالة المستخدم المحدّد من قائمة المعلِّقين في File . |
removeEditor(emailAddress) | File | لإزالة المستخدم المحدّد من قائمة المحرِّرين في File . |
removeEditor(user) | File | لإزالة المستخدم المحدّد من قائمة المحرِّرين في File . |
removeViewer(emailAddress) | File | لإزالة المستخدم المحدّد من قائمة المشاهدين والمعلقين في File . |
removeViewer(user) | File | لإزالة المستخدم المحدّد من قائمة المشاهدين والمعلقين في File . |
revokePermissions(emailAddress) | File | لإلغاء إمكانية الوصول إلى File التي تم منحها للمستخدم المحدّد. |
revokePermissions(user) | File | لإلغاء إمكانية الوصول إلى File التي تم منحها للمستخدم المحدّد. |
setContent(content) | File | يستبدل محتوى الملف باستبدال معيّن. |
setDescription(description) | File | لضبط وصف File . |
setName(name) | File | لضبط اسم File . |
setOwner(emailAddress) | File | تغيير مالك File . |
setOwner(user) | File | تغيير مالك File . |
setSecurityUpdateEnabled(enabled) | File | تحدّد هذه السياسة ما إذا كان File يتطلّب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط. |
setShareableByEditors(shareable) | File | يحدّد هذا الإعداد ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل File بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات. |
setSharing(accessType, permissionType) | File | تحدّد فئة المستخدمين الذين يمكنهم الوصول إلى File والأذونات التي يمنحها هؤلاء المستخدمون، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً. |
setStarred(starred) | File | تحدِّد هذه السياسة ما إذا كان سيتم تمييز File بنجمة في حساب Drive للمستخدم. |
setTrashed(trashed) | File | تحدِّد هذه السياسة ما إذا كان File في مهملات حساب Drive للمستخدم. |
الوثائق التفصيلية
addCommenter(emailAddress)
أضِف المستخدم المعني إلى قائمة المعلِّقين على File
. إذا كان المستخدم مدرجًا في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' with the email address that you // want to add as a commenter. while (files.hasNext()) { const file = files.next(); email = 'cloudysanfrancisco@gmail.com'; console.log(file.addCommenter(email)); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إضافته. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addCommenter(user)
أضِف المستخدم المعني إلى قائمة المعلِّقين على File
. إذا كان المستخدم مدرجًا في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Adds the active user as a commenter. while (files.hasNext()) { const file = files.next(); file.addCommenter(Session.getActiveUser()); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم تتم إضافته. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addCommenters(emailAddresses)
أضِف مجموعة المستخدمين المحدّدة إلى قائمة المعلِّقين على File
. إذا كان أيٌّ من المستخدمين
مدرَجًا في قائمة المشاهدين حاليًا، تتم عملية الترويج له خارج قائمة
المشاهدين.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); while (files.hasNext()) { const file = files.next(); // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' and // 'baklavainthebalkans@gmail.com' with the email addresses to add as commenters. const emails = ['cloudysanfrancisco@gmail.com','baklavainthebalkans@gmail.com']; console.log(file.addCommenters(emails)); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المراد إضافتها. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addEditor(emailAddress)
لإضافة المستخدم المحدّد إلى قائمة المحرِّرين في File
. إذا كان المستخدم مدرجًا في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إضافته. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addEditor(user)
لإضافة المستخدم المحدّد إلى قائمة المحرِّرين في File
. إذا كان المستخدم مدرجًا في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم تتم إضافته. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addEditors(emailAddresses)
لإضافة مجموعة المستخدمين المحدّدة إلى قائمة المحرِّرين في File
. إذا كان أيٌّ من المستخدمين مدرجًا في قائمة المشاهدين، تعمل هذه الطريقة على الترويج له خارج قائمة المشاهدين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المراد إضافتها. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addViewer(emailAddress)
لإضافة المستخدم المحدّد إلى قائمة المشاهدين في File
. إذا كان المستخدم بالفعل في قائمة
المحررين، فلن يكون لهذه الطريقة أي تأثير.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إضافته. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addViewer(user)
لإضافة المستخدم المحدّد إلى قائمة المشاهدين في File
. إذا كان المستخدم بالفعل في قائمة
المحررين، فلن يكون لهذه الطريقة أي تأثير.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم تتم إضافته. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
addViewers(emailAddresses)
لإضافة مصفوفة المستخدمين المحددة إلى قائمة العارضين لـ File
. إذا كان أي من المستخدمين مدرجًا بالفعل في قائمة المحررين، فلن يكون لهذه الطريقة أي تأثير عليهم.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المراد إضافتها. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
getAccess(email)
يحصل على الإذن الذي تم منحه للمستخدم المحدّد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
email | String | عنوان البريد الإلكتروني للمستخدم الذي يجب التحقق من أذوناته |
استرجاع الكرة
Permission
- الأذونات الممنوحة للمستخدم
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getAccess(user)
يحصل على الإذن الذي تم منحه للمستخدم المحدّد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم الذي يجب التحقق من أذوناته |
استرجاع الكرة
Permission
- الأذونات الممنوحة للمستخدم
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getAs(contentType)
عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير يتم تحويله إلى نوع المحتوى المحدّد. تضيف هذه الطريقة الامتداد المناسب إلى اسم الملف - على سبيل المثال، "myfile.pdf". ومع ذلك، يُفترض أن يمثّل جزء اسم الملف الذي يلي النقطة الأخيرة (إن وُجدت) إضافة حالية يجب استبدالها. وبالتالي، يصبح "ShoppingList.12.25.2014" هو "ShoppingList.12.25.pdf".
لعرض الحصص اليومية للإحالات الناجحة، راجِع حصص خدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا لحصص أكثر صرامة مؤقتًا.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
contentType | String | نوع MIME المطلوب التحويل إليه. بالنسبة إلى معظم الكائنات الثنائية الكبيرة، يكون 'application/pdf' هو الخيار الصالح الوحيد. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يكون أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png' صالحًا أيضًا. |
استرجاع الكرة
Blob
— البيانات في صورة كائن ثنائي كبير (blob).
getBlob()
عرض البيانات داخل هذا الكائن على هيئة كائن ثنائي كبير (blob).
استرجاع الكرة
Blob
— البيانات في صورة كائن ثنائي كبير (blob).
getDateCreated()
getDescription()
getDownloadUrl()
الحصول على عنوان URL الذي يمكن استخدامه لتنزيل الملف يمكن فقط للمستخدمين الذين لديهم إذن لفتح الملف
في Google Drive الوصول إلى عنوان URL. يمكنك استخدام عنوان URL هذا في المتصفح لتنزيل الملف، ولكن لا يمكنك استخدامه لجلب الملف من خلال UrlFetchApp
. إذا كنت تريد محتويات الملف
في النص البرمجي، استخدم getBlob()
.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the download URLs to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getDownloadUrl()); }
استرجاع الكرة
String
- عنوان URL الذي يمكن استخدامه لتنزيل الملف
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getEditors()
يمكنك الحصول على قائمة بالمحرِّرين في File
. وإذا لم يكن لدى المستخدم الذي ينفّذ النص البرمجي الإذن بتعديل المحتوى في File
، تعرض هذه الطريقة صفيفًا فارغًا.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Adds the email addresses in the array as editors of each file. // TODO(developer): Replace 'cloudysanfrancisco@gmail.com' // and 'baklavainthebalkans@gmail.com' with valid email addresses. file.addEditors(['cloudysanfrancisco@gmail.com', 'baklavainthebalkans@gmail.com']); // Gets a list of the file editors. const editors = file.getEditors(); // For each file, logs the editors' email addresses to the console. for (const editor of editors) { console.log(editor.getEmail()); } }
استرجاع الكرة
User[]
: إذا كان المستخدم لديه الإذن بتعديل المحتوى في File
هذا، سيتم عرض قائمة
المُحرِّرين. إذا لم يكن لدى المستخدم الإذن بتعديل المحتوى، سيتم عرض مصفوفة فارغة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getId()
getLastUpdated()
getMimeType()
نحصل على نوع MIME للملف.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the MIME type to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getMimeType()); }
استرجاع الكرة
String
— نوع MIME للملف
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getName()
getOwner()
الوصول إلى مالك الملف.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files and logs the names of the file owners to the console. while (files.hasNext()) { const file = files.next(); console.log(file.getOwner().getName()); }
استرجاع الكرة
User
— مالك الملف
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getParents()
للحصول على مجموعة من المجلدات التي تمثّل عناصر رئيسية مباشرة لـ File
.
استرجاع الكرة
FolderIterator
- مجموعة من المجلدات التي تمثّل عناصر رئيسية مباشرة لـ File
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getResourceKey()
الحصول على مفتاح المورد الخاص بـ File
المطلوب للوصول إلى العناصر التي تمت مشاركتها باستخدام رابط
استرجاع الكرة
String
: مفتاح المصدر لـ File
.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEligible()
معرفة ما إذا كان File
هذا مؤهَّلاً لتطبيق تحديث الأمان الذي
يتطلب مفتاح مورد للوصول إليه عند مشاركته باستخدام رابط.
يتطلب Drive مفتاح مورد للوصول إلى بعض الملفات أو المجلدات التي تمت مشاركتها باستخدام
رابط. هذا التغيير جزء من تحديث أمان. يتم تفعيل التحديث تلقائيًا للملفات
والمجلدات المؤهَّلة. لتفعيل متطلبات مفتاح المورد أو إيقافها للملفات المؤهَّلة، استخدِم
setSecurityUpdateEnabled
.
تعرّف على مزيد من المعلومات حول تحديث الأمان في Google Drive.
استرجاع الكرة
Boolean
: لتحديد ما إذا كان من الممكن تطبيق شرط مفتاح المورد على File
.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSecurityUpdateEnabled()
تتيح لك معرفة ما إذا كان File
هذا يتطلّب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط. يتم تفعيل هذه المتطلبات تلقائيًا للملفات والمجلدات المؤهَّلة.
لتفعيل متطلبات مفتاح المورد أو إيقافها للملفات المؤهَّلة، استخدِم
setSecurityUpdateEnabled
.
تعرّف على مزيد من المعلومات حول تحديث الأمان في Google Drive.
استرجاع الكرة
Boolean
: يشير ذلك إلى ما إذا تم تفعيل متطلبات مفتاح المورد لجهاز File
هذا.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingAccess()
لمعرفة فئة المستخدمين الذين يمكنهم الوصول إلى File
، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكلٍ صريح.
استرجاع الكرة
Access
: فئة المستخدمين الذين يمكنهم الوصول إلى File
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSharingPermission()
يحصل على الإذن الممنوح لهؤلاء المستخدمين الذين يمكنهم الوصول إلى File
،
بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً.
استرجاع الكرة
Permission
: الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى File
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getSize()
الحصول على عدد وحدات البايت المستخدمة لتخزين File
في Drive. يُرجى ملاحظة أنّه
لا يتم احتساب ملفات تطبيق Google Workspace ضمن حدود مساحة التخزين في Drive، وبالتالي يتم عرض 0
بايت من مساحة التخزين.
استرجاع الكرة
Integer
: عدد وحدات البايت المستخدمة لتخزين File
في Drive
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getTargetId()
إذا كان هذا اختصارًا، يتم عرض رقم تعريف العنصر الذي يشير إليه.
وبخلاف ذلك، سيتم عرض null
.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the target ID of the shortcut. console.log(`${shortcut.getName()}=${shortcut.getTargetId()}`);
استرجاع الكرة
String
— رقم تعريف العنصر المستهدَف
getTargetMimeType()
إذا كان هذا اختصارًا، يتم عرض نوع MIME للعنصر الذي يشير إليه.
وبخلاف ذلك، سيتم عرض null
.
// The ID of the file for which to make a shortcut and the ID of // the folder to which you want to add the shortcut. // TODO(developer): Replace the file and folder IDs with your IDs. const fileId = 'abc123456'; const folderId = 'xyz987654'; // Gets the folder to add the shortcut to. const folder = DriveApp.getFolderById(folderId); // Creates a shortcut of the file and moves it to the specified folder. const shortcut = DriveApp.createShortcut(fileId).moveTo(folder); // Logs the MIME type of the file that the shortcut points to. console.log(`MIME type of the shortcut: ${shortcut.getTargetMimeType()}`);
استرجاع الكرة
String
- نوع MIME للعنصر المستهدف
getTargetResourceKey()
إذا كان الملف اختصارًا، يتم عرض مفتاح المورد للعنصر الذي يشير إليه. مفتاح المورد هو معلمة إضافية تحتاج إلى تمريرها للوصول إلى الملفات التي تمت مشاركتها باستخدام رابط.
إذا لم يكن الملف اختصارًا، سيعرض null
.
// Gets a file by its ID. // TODO(developer): Replace 'abc123456' with your file ID. const file = DriveApp.getFileById('abc123456'); // If the file is a shortcut, returns the resource key of the file that it points to. console.log(file.getTargetResourceKey());
استرجاع الكرة
String
: مفتاح مورد العنصر الهدف أو null
إذا لم يكن الملف اختصارًا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getThumbnail()
الحصول على صورة مصغّرة للملف أو null
في حال عدم توفّر صورة مصغّرة
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Logs the thumbnail image for each file to the console as a blob, // or null if no thumbnail exists. console.log(file.getThumbnail()); }
استرجاع الكرة
Blob
- الصورة المصغّرة للملف
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getUrl()
الحصول على عنوان URL يمكن استخدامه لفتح File
في أحد تطبيقات Google، مثل
Drive أو "مستندات Google".
استرجاع الكرة
String
- عنوان URL الذي يمكن استخدامه لعرض File
في أحد تطبيقات Google، مثل Drive أو "مستندات Google"
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
getViewers()
للحصول على قائمة المشاهدين والمعلقين على File
هذا. إذا لم يكن لدى المستخدم الذي ينفّذ النص البرمجي إذن تعديل File
، ستعرض هذه الطريقة مصفوفة فارغة.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // For each file, logs the viewers' email addresses to the console. const viewers = file.getViewers(); for (viewer of viewers) { console.log(viewer.getEmail()); } }
استرجاع الكرة
User[]
: إذا كان لدى المستخدم الإذن بتعديل محتوى File
هذا، سيتم عرض قائمة المشاهدين والمعلِّقين. إذا لم يكن لدى المستخدم الإذن بتعديل المحتوى، سيتم عرض مصفوفة فارغة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isStarred()
تحدِّد هذه السياسة ما إذا كان قد تم تمييز File
بنجمة في حساب Drive للمستخدم.
استرجاع الكرة
Boolean
- true
إذا تم تمييز File
بنجمة في حساب Drive للمستخدم، وfalse
إذا لم يكن كذلك
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
isTrashed()
تحدِّد هذه السياسة ما إذا كان ملف "File
" في مهملات حساب Drive الخاص بالمستخدم.
استرجاع الكرة
من Boolean
إلى true
إذا كانت File
في مهملات Drive للمستخدم، وfalse
إذا لم تكن كذلك
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive.readonly
-
https://www.googleapis.com/auth/drive
makeCopy()
تنشئ نسخة من الملف.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and logs the file name to the console. console.log(file.makeCopy().getName()); }
استرجاع الكرة
File
— النسخة الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
makeCopy(destination)
تنشئ نسخة من الملف في دليل الوجهة.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and adds it to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy(destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
destination | Folder | الدليل المطلوب نسخ الملف إليه. |
استرجاع الكرة
File
— النسخة الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
makeCopy(name)
تنشئ نسخة من الملف وتسميته بالاسم الذي تم تقديمه.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file and sets the name to 'Test-Copy.' const filename = file.makeCopy('Test-Copy'); // Logs the copied file's name to the console. console.log(filename.getName()); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
name | String | اسم الملف الذي يجب تطبيقه على النسخة الجديدة. |
استرجاع الكرة
File
— النسخة الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
makeCopy(name, destination)
تنشئ نسخة من الملف في دليل الوجهة وتسمّيه بالاسم المقدّم.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Creates a copy of each file, sets the file name, and adds the copied file // to the specified folder. // TODO(developer): Replace the folder ID with your own. const destination = DriveApp.getFolderById('123456abcxyz'); const copiedFile = file.makeCopy('Test-Copy', destination); // Logs the file names to the console. console.log(copiedFile.getName()); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
name | String | اسم الملف الذي يجب تطبيقه على النسخة الجديدة. |
destination | Folder | الدليل المطلوب نسخ الملف إليه. |
استرجاع الكرة
File
— النسخة الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
moveTo(destination)
ينقل هذا العنصر إلى مجلد الوجهة المحدَّد.
يجب أن يكون المستخدم الحالي مالك الملف أو أن يكون لديه على الأقل الإذن بتعديل المجلد الرئيسي الحالي للعنصر من أجل نقل العنصر إلى مجلد الوجهة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
destination | Folder | المجلد الذي سيصبح المجلد الرئيسي الجديد |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeCommenter(emailAddress)
لإزالة المستخدم المحدّد من قائمة المعلِّقين في File
. ولا تحظر هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون لفئة معيّنة من المستخدمين يملكون إذن الوصول العام، مثلاً إذا تمت مشاركة File
مع النطاق الكامل للمستخدم.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. // TODO(developer): Replace the email with the email of the user you want to remove. file.removeCommenter('cloudysanfrancisco@gmail.com'); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeCommenter(user)
لإزالة المستخدم المحدّد من قائمة المعلِّقين في File
. ولا تحظر هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون لفئة معيّنة من المستخدمين يملكون إذن الوصول العام، مثلاً إذا تمت مشاركة File
مع النطاق الكامل للمستخدم.
// Gets a list of all files in Google Drive with the given name. // TODO(developer): Replace the file name with your own. const files = DriveApp.getFilesByName('Test'); // Loops through the files. while (files.hasNext()) { const file = files.next(); // Removes the given user from the list of commenters for each file. console.log(file.removeCommenter(Session.getActiveUser())); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم المطلوب إزالته. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeEditor(emailAddress)
لإزالة المستخدم المحدّد من قائمة المحرِّرين في File
. ولا تحظر هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة File
مع نطاق المستخدم بأكمله، أو إذا كانت File
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، سيؤدي هذا أيضًا إلى إزالة المستخدم من قائمة العارضين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeEditor(user)
لإزالة المستخدم المحدّد من قائمة المحرِّرين في File
. ولا تحظر هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة File
مع نطاق المستخدم بأكمله، أو إذا كانت File
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، سيؤدي هذا أيضًا إلى إزالة المستخدم من قائمة العارضين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم المطلوب إزالته. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeViewer(emailAddress)
لإزالة المستخدم المحدّد من قائمة المشاهدين والمعلقين في File
. ليس لهذه الطريقة تأثير إذا كان المستخدم محررًا، وليس مشاهدًا أو معلقًا. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة File
مع نطاق المستخدم بالكامل أو إذا كانت File
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، سيؤدي هذا أيضًا إلى إزالة المستخدم من قائمة المحرِّرين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
removeViewer(user)
لإزالة المستخدم المحدّد من قائمة المشاهدين والمعلقين في File
. ليس لهذه الطريقة أي تأثير إذا كان المستخدم محررًا وليس عارضًا. ولا تمنع هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون لفئة معيّنة من المستخدمين يمكنهم الوصول بشكل عام، مثلاً إذا تمت مشاركة File
مع النطاق الكامل للمستخدم، أو إذا كانت File
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
بالنسبة إلى ملفات Drive، سيؤدي هذا أيضًا إلى إزالة المستخدم من قائمة المحرِّرين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم المطلوب إزالته. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
revokePermissions(emailAddress)
لإلغاء إمكانية الوصول إلى File
التي تم منحها للمستخدم المحدّد. ولا تحظر هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة File
مع النطاق الكامل للمستخدم.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم الذي يجب إبطال إذن وصوله |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
revokePermissions(user)
لإلغاء إمكانية الوصول إلى File
التي تم منحها للمستخدم المحدّد. ولا تحظر هذه الطريقة المستخدمين من الوصول إلى File
إذا كانوا ينتمون إلى فئة من المستخدمين الذين لديهم إذن وصول عام، مثلاً إذا تمت مشاركة File
مع النطاق الكامل للمستخدم.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم الذي يجب إبطال إذن وصوله. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setContent(content)
يستبدل محتوى الملف باستبدال معيّن. تعرض هذه السياسة استثناءً إذا كان حجم content
أكبر من 10 ميغابايت.
// Creates a text file with the content 'Hello, world!' file = DriveApp.createFile('New Text File', 'Hello, world!'); // Logs the content of the text file to the console. console.log(file.getBlob().getDataAsString()); // Updates the content of the text file to 'Updated text!' file.setContent('Updated text!') // Logs content of the text file to the console. console.log(file.getBlob().getDataAsString());
المَعلمات
الاسم | Type | الوصف |
---|---|---|
content | String | المحتوى الجديد للملف. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setDescription(description)
setName(name)
setOwner(emailAddress)
تغيير مالك File
. تمنح هذه الطريقة أيضًا المالك السابق
إذنًا صريحًا لتعديل File
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم الذي يجب أن يصبح المالك الجديد |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setOwner(user)
تغيير مالك File
. تمنح هذه الطريقة أيضًا المالك السابق
إذنًا صريحًا لتعديل File
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
user | User | تمثيل للمستخدم الذي يجب أن يصبح المالك الجديد |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setSecurityUpdateEnabled(enabled)
تحدّد هذه السياسة ما إذا كان File
يتطلّب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط. يتم تفعيل الملفات والمجلدات المؤهَّلة تلقائيًا.
تعرّف على مزيد من المعلومات حول تحديث الأمان في Google Drive.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
enabled | Boolean | يمكنك اختيار ما إذا كان سيتم تفعيل متطلبات مفتاح المورد لـ File . |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setSharing(accessType, permissionType)
تحدّد فئة المستخدمين الذين يمكنهم الوصول إلى File
والأذونات التي يمنحها هؤلاء المستخدمون، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً.
// Creates a folder that anyone on the Internet can read from and write to. (Domain // administrators can prohibit this setting for users of a Google Workspace domain.) var folder = DriveApp.createFolder('Shared Folder'); folder.setSharing(DriveApp.Access.ANYONE, DriveApp.Permission.EDIT);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
accessType | Access | فئة المستخدمين التي يجب أن تكون لديهم إمكانية الوصول إلى File |
permissionType | Permission | الأذونات التي يجب منحها للمستخدمين الذين يمكنهم الوصول إلى File |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setStarred(starred)
تحدِّد هذه السياسة ما إذا كان سيتم تمييز File
بنجمة في حساب Drive للمستخدم. الإعداد التلقائي
لإعدادات File
الجديدة هو false
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
starred | Boolean | true إذا كان يجب تمييز File بنجمة في Drive للمستخدم، وfalse إذا لم يكن الأمر كذلك |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive
setTrashed(trashed)
تحدِّد هذه السياسة ما إذا كان File
في مهملات حساب Drive للمستخدم. ولا يجوز لأحد سوى
المالك نقل File
إلى المهملات. الإعداد التلقائي لـ File
الجديدة هو false
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
trashed | Boolean | true إذا كان يجب نقل File إلى مهملات
Drive للمستخدم، وfalse إذا لم يكن الأمر كذلك |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/drive