تتيح هذه الخدمة للنصوص البرمجية إنشاء الملفات والمجلدات والعثور عليها وتعديلها في Google Drive.
// Log the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
var file = files.next();
Logger.log(file.getName());
}
صفوف
الاسم | وصف قصير |
---|---|
Access | تعداد يمثل فئات المستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين فرديين تم منحهم حق الوصول بشكل صريح. |
DriveApp | تسمح للنصوص البرمجية بإنشاء الملفات والمجلدات والعثور عليها وتعديلها في Google Drive. |
File | ملف في Google Drive. |
FileIterator | مكرّر يسمح للنصوص البرمجية بتكرار مجموعة من الملفات التي يُحتمل أن تكون كبيرة الحجم. |
Folder | مجلد في Google Drive. |
FolderIterator | كائن يسمح للنصوص البرمجية بتكرار مجموعة من المجلدات التي يُحتمل أن تكون كبيرة. |
Permission | تعداد يمثّل الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين فرديين تم منحهم حق الوصول بشكل صريح. |
User | مستخدم مرتبط بملف في Google Drive. |
Access
أماكن إقامة
الخاصية | النوع | الوصف |
---|---|---|
ANYONE | Enum | يمكن لأي شخص على الإنترنت البحث عن الملف والوصول إليه. |
ANYONE_WITH_LINK | Enum | أي مستخدم لديه الرابط يمكنه الوصول إلى التسجيل. |
DOMAIN | Enum | يمكن للأشخاص في نطاقك العثور على الملف والدخول إليه. |
DOMAIN_WITH_LINK | Enum | تتوفر إمكانية الوصول للأشخاص في نطاقك الذين لديهم الرابط. |
PRIVATE | Enum | تتوفر إمكانية الدخول للأشخاص الذين تم منحهم إذنًا صريحًا بذلك. |
DriveApp
أماكن إقامة
الخاصية | النوع | الوصف |
---|---|---|
Access | Access | تعداد يمثل فئات المستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين فرديين تم منحهم حق الوصول بشكل صريح. |
Permission | Permission | تعداد يمثّل الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين فرديين تم منحهم حق الوصول بشكل صريح. |
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
continueFileIterator(continuationToken) | FileIterator | استئناف تكرار الملف باستخدام رمز مميز للمتابعة من مُكرر سابق. |
continueFolderIterator(continuationToken) | FolderIterator | استئناف تكرار المجلد باستخدام رمز مميّز للمتابعة من مكرّر سابق |
createFile(blob) | File | تنشئ ملفًا في جذر مساحة تخزين Drive للمستخدم من Blob لبيانات عشوائية. |
createFile(name, content) | File | يُنشئ ملفًا نصيًا في جذر مساحة تخزين Drive للمستخدم. |
createFile(name, content, mimeType) | File | يُنشئ ملفًا في جذر مساحة تخزين Drive للمستخدم. |
createFolder(name) | Folder | يُنشئ مجلدًا في جذر مساحة تخزين Drive للمستخدم. |
createShortcut(targetId) | File | يتم إنشاء اختصار لمعرّف عنصر Drive الذي تم تقديمه، ثم عرضه. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | يتم إنشاء اختصار لرقم تعريف عنصر Drive ومفتاح المورد المتوفّرين، ويتم عرضه. |
enforceSingleParent(value) | void | تفعِّل هذه السياسة أو توقف تنفيذها كسلوك أحد الوالدين لكل المكالمات التي تؤثر على العنصر الرئيسي. |
getFileById(id) | File | الحصول على الملف بالمعرف المحدد. |
getFileByIdAndResourceKey(id, resourceKey) | File | الحصول على الملف باستخدام رقم التعريف ومفتاح المفتاح للمورد |
getFiles() | FileIterator | الحصول على مجموعة من جميع الملفات في Drive التابع للمستخدم. |
getFilesByName(name) | FileIterator | الحصول على مجموعة من جميع الملفات في مساحة المستخدم على Drive التي تحمل الاسم المحدد. |
getFilesByType(mimeType) | FileIterator | الحصول على مجموعة من جميع الملفات في Drive التابع للمستخدم والتي لها نوع MIME المحدد. |
getFolderById(id) | Folder | للحصول على المجلد الذي يحمل رقم التعريف المحدد. |
getFolderByIdAndResourceKey(id, resourceKey) | Folder | للحصول على المجلد الذي يحمل المعرّف ومفتاح المفتاح المتوفّرين. |
getFolders() | FolderIterator | الحصول على مجموعة من جميع المجلدات في Drive للمستخدم. |
getFoldersByName(name) | FolderIterator | يحصل على مجموعة من جميع المجلدات في Drive التابع للمستخدم والتي تحمل الاسم نفسه. |
getRootFolder() | Folder | للحصول على المجلد في جذر حساب المستخدم في Drive. |
getStorageLimit() | Integer | يحصل على عدد وحدات البايت التي يُسمح للمستخدم بتخزينها في Drive. |
getStorageUsed() | Integer | يحصل على عدد وحدات البايت التي يخزّنها المستخدم حاليًا في Drive. |
getTrashedFiles() | FileIterator | الحصول على مجموعة من جميع الملفات في مهملات المستخدم على Drive. |
getTrashedFolders() | FolderIterator | الحصول على مجموعة من جميع المجلدات في مهملات المستخدم على Drive. |
searchFiles(params) | FileIterator | يحصل على مجموعة من جميع الملفات في Drive التابع للمستخدم والتي تطابق معايير البحث المحددة. |
searchFolders(params) | FolderIterator | يحصل على مجموعة من جميع المجلدات في Drive التابع للمستخدم والتي تطابق معايير البحث المحددة. |
File
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
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 | عرض البيانات داخل هذا العنصر ككائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد. |
getBlob() | Blob | عرض البيانات داخل هذا الكائن كائن ثنائي كبير. |
getDateCreated() | Date | يعرض هذا العمود تاريخ إنشاء File . |
getDescription() | String | الحصول على وصف File |
getDownloadUrl() | String | يحصل على عنوان URL الذي يمكن استخدامه لتنزيل الملف. |
getEditors() | User[] | الحصول على قائمة المحرِّرين لجهاز File هذا. |
getId() | String | تحصل على رقم تعريف File . |
getLastUpdated() | Date | يحدّد هذا الحقل تاريخ آخر تعديل لـ File . |
getMimeType() | String | الحصول على نوع MIME للملف. |
getName() | String | تحصل على اسم File . |
getOwner() | User | الحصول على مالك File . |
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(user) | 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. |
FileIterator
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
getContinuationToken() | String | يحصل على رمز مميز يمكن استخدامه لاستئناف هذا التكرار في وقت لاحق. |
hasNext() | Boolean | تحدِّد هذه السياسة ما إذا كان طلب next() سيؤدي إلى عرض سلعة. |
next() | File | الحصول على العنصر التالي في مجموعة الملفات أو المجلدات. |
Folder
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
addEditor(emailAddress) | Folder | إضافة المستخدم المحدد إلى قائمة محررات Folder . |
addEditor(user) | Folder | إضافة المستخدم المحدد إلى قائمة محررات Folder . |
addEditors(emailAddresses) | Folder | لإضافة صفيف معيّن من المستخدمين إلى قائمة محرّري Folder . |
addViewer(emailAddress) | Folder | تعمل على إضافة المستخدم المحدد إلى قائمة مشاهدي Folder . |
addViewer(user) | Folder | تعمل على إضافة المستخدم المحدد إلى قائمة مشاهدي Folder . |
addViewers(emailAddresses) | Folder | تعمل هذه السياسة على إضافة المصفوفة المحدّدة من المستخدمين إلى قائمة المشاهدين للوحدة التنظيمية Folder . |
createFile(blob) | File | تعمل هذه السياسة على إنشاء ملف في المجلد الحالي من Blob لبيانات عشوائية. |
createFile(name, content) | File | إنشاء ملف نصي في المجلد الحالي بالاسم و المحتويات المحددة. |
createFile(name, content, mimeType) | File | يتم إنشاء ملف في المجلد الحالي بالاسم والمحتوى ونوع MIME المحدّد. |
createFolder(name) | Folder | لإنشاء مجلد في المجلد الحالي بالاسم نفسه. |
createShortcut(targetId) | File | يتم إنشاء اختصار لمعرّف عنصر Drive الذي تم تقديمه، ثم عرضه. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | يتم إنشاء اختصار لرقم تعريف عنصر Drive ومفتاح المورد المتوفّرين، ويتم عرضه. |
getAccess(email) | Permission | يحصل المستخدم على الإذن الذي تم منحه للمستخدم. |
getAccess(user) | Permission | يحصل المستخدم على الإذن الذي تم منحه للمستخدم. |
getDateCreated() | Date | يعرض هذا العمود تاريخ إنشاء Folder . |
getDescription() | String | الحصول على وصف Folder |
getEditors() | User[] | الحصول على قائمة المحرِّرين لجهاز Folder هذا. |
getFiles() | FileIterator | الحصول على مجموعة من جميع الملفات الثانوية في المجلد الحالي. |
getFilesByName(name) | FileIterator | الحصول على مجموعة من جميع الملفات الفرعية من المجلد الحالي والتي تحمل الاسم نفسه. |
getFilesByType(mimeType) | FileIterator | الحصول على مجموعة من جميع الملفات الفرعية من المجلد الحالي والتي لها نوع MIME المحدد. |
getFolders() | FolderIterator | الحصول على مجموعة من جميع المجلدات الفرعية من المجلد الحالي. |
getFoldersByName(name) | FolderIterator | تعرض هذه السياسة مجموعة من جميع المجلدات الفرعية من المجلد الحالي والتي تحمل الاسم نفسه. |
getId() | String | تحصل على رقم تعريف Folder . |
getLastUpdated() | Date | يحدّد هذا الحقل تاريخ آخر تعديل لـ Folder . |
getName() | String | تحصل على اسم Folder . |
getOwner() | User | الحصول على مالك Folder . |
getParents() | FolderIterator | يحصل على مجموعة من المجلدات التي تمثّل عناصر مباشرة من Folder . |
getResourceKey() | String | يحصل على مفتاح المصدر من Folder المطلوب للوصول إلى العناصر التي تمت مشاركتها باستخدام رابط. |
getSecurityUpdateEligible() | Boolean | لمعرفة ما إذا كانت Folder هذه مؤهّلة لتطبيق تحديث الأمان الذي يتطلب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط. |
getSecurityUpdateEnabled() | Boolean | يحدِّد هذا الإعداد ما إذا كان Folder يتطلب مفتاح مصدر للوصول إليه عند مشاركته باستخدام رابط. |
getSharingAccess() | Access | تحدد فئة المستخدمين التي يمكنها الوصول إلى Folder ، بجانب أي مستخدمين فرديين تم منحهم حق الوصول بشكل صريح. |
getSharingPermission() | Permission | يحصل على الإذن الممنوح لهؤلاء المستخدمين الذين يمكنهم الوصول إلى Folder ،
إلى جانب أي مستخدمين فرديين تم منحهم إذنًا صريحًا بالوصول. |
getSize() | Integer | يحصل على عدد وحدات البايت المُستخدَمة لتخزين Folder في Drive. |
getUrl() | String | يحصل على عنوان URL الذي يمكن استخدامه لفتح Folder في أحد تطبيقات Google، مثل
Drive أو"مستندات Google". |
getViewers() | User[] | يحصل على قائمة المشاهدين والمعلقين لجهاز Folder هذا. |
isShareableByEditors() | Boolean | تُحدِّد هذه السياسة ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات بتعديل Folder بمشاركة الملفات مع مستخدمين آخرين أو تغيير الأذونات. |
isStarred() | Boolean | تحدِّد هذه السياسة ما إذا كانت Folder قد تم تمييزها بنجمة في Drive على جهاز المستخدم. |
isTrashed() | Boolean | يتم تحديد ما إذا كان Folder في مهملات المستخدم على Drive. |
moveTo(destination) | Folder | تنقل هذا العنصر إلى مجلد الوجهة المقدم. |
removeEditor(emailAddress) | Folder | إزالة المستخدم المحدّد من قائمة محرّري Folder . |
removeEditor(user) | Folder | إزالة المستخدم المحدّد من قائمة محرّري Folder . |
removeViewer(emailAddress) | Folder | إزالة المستخدم المحدد من قائمة المشاهدين والمعلقين لـ Folder . |
removeViewer(user) | Folder | إزالة المستخدم المحدد من قائمة المشاهدين والمعلقين لـ Folder . |
revokePermissions(user) | Folder | إلغاء حق الوصول إلى Folder الممنوحة للمستخدم المُحدَّد. |
revokePermissions(user) | Folder | إلغاء حق الوصول إلى Folder الممنوحة للمستخدم المُحدَّد. |
searchFiles(params) | FileIterator | يحصل على مجموعة من جميع الملفات الفرعية من المجلد الحالي وتتطابق مع معايير البحث. |
searchFolders(params) | FolderIterator | يحصل على مجموعة من جميع المجلدات الفرعية من المجلد الحالي وتتطابق مع معايير البحث. |
setDescription(description) | Folder | إعداد وصف Folder |
setName(name) | Folder | تضبط هذه السياسة اسم Folder . |
setOwner(emailAddress) | Folder | تغيير مالك Folder |
setOwner(user) | Folder | تغيير مالك Folder |
setSecurityUpdateEnabled(enabled) | Folder | تحدِّد هذه السياسة ما إذا كان Folder يتطلب مفتاح مصدر للوصول إليه في حال مشاركته باستخدام رابط. |
setShareableByEditors(shareable) | Folder | يحدِّد هذا الإعداد ما إذا كان يُسمَح للمستخدمين الذين لديهم أذونات لتعديل الحقل Folder بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات. |
setSharing(accessType, permissionType) | Folder | تُحدّد فئة المستخدمين التي يمكنها الوصول إلى Folder والأذونات التي يتم منحها لهؤلاء المستخدمين، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذنًا صريحًا بالوصول. |
setStarred(starred) | Folder | تحدِّد هذه السياسة ما إذا كانت Folder مميّزة بنجمة في Drive على جهاز المستخدم. |
setTrashed(trashed) | Folder | يحدِّد هذا الإعداد ما إذا كان Folder في مهملات المستخدم على Drive. |
FolderIterator
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
getContinuationToken() | String | يحصل على رمز مميز يمكن استخدامه لاستئناف هذا التكرار في وقت لاحق. |
hasNext() | Boolean | تحدِّد هذه السياسة ما إذا كان طلب next() سيؤدي إلى عرض سلعة. |
next() | Folder | الحصول على العنصر التالي في مجموعة الملفات أو المجلدات. |
Permission
أماكن إقامة
الخاصية | النوع | الوصف |
---|---|---|
VIEW | Enum | المستخدمون الذين يمكنهم الوصول إلى الملف أو المجلد يمكنهم الاطّلاع عليه أو نسخه فقط. |
EDIT | Enum | يمكن للمستخدمين الذين يمكنهم الوصول إلى الملف أو المجلد تعديله. |
COMMENT | Enum | المستخدمون الذين يمكنهم الوصول إلى الملف أو المجلد يمكنهم الاطّلاع عليه أو نسخه أو التعليق عليه فقط. |
OWNER | Enum | يمتلك المستخدم الملف أو المجلد. |
ORGANIZER | Enum | المستخدمون الذين يمكنهم تنظيم الملفات والمجلدات داخل مساحة التخزين السحابي المشتركة. |
FILE_ORGANIZER | Enum | المستخدمون الذين يمكنهم تعديل المحتوى أو نقله أو نقله داخل مساحة تخزين سحابي مشتركة. |
NONE | Enum | لا يمتلك المستخدم أي أذونات للملف أو المجلد. |
User
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
getDomain() | String | تحصل على اسم النطاق المرتبط بحساب المستخدم. |
getEmail() | String | يحصل على عنوان البريد الإلكتروني للمستخدم. |
getName() | String | يحصل على اسم المستخدم. |
getPhotoUrl() | String | يحصل على عنوان URL لصورة المستخدم. |