تسمح هذه الخدمة للنص البرمجي بإنشاء ملفات ومجلدات والعثور عليها وتعديلها في 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 التابع للمستخدم بالاسم والمحتويات ونوع MIME المحدد. |
createFolder(name) | Folder | يُنشئ مجلدًا في جذر Drive للمستخدم بالاسم المحدد. |
createShortcut(targetId) | File | ينشئ اختصارًا لمعرّف عنصر Drive المُقدَّم ويعرضه. |
createShortcutForTargetIdAndResourceKey(targetId, targetResourceKey) | File | ينشئ اختصارًا لمعرّف عنصر Drive ومفتاح المورد المتوفّرَين ويعرضه. |
enforceSingleParent(value) | void | يُفعِّل أو يُعطِّل سلوك فرض SingleParent لجميع المكالمات التي تؤثر على عناصر العنصر الرئيسي. |
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 | الحصول على مالك الملف. |
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 أو المستندات. |
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 للمستخدم أم لا. |
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 أو المستندات. |
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(emailAddress) | 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 | المستخدمون الذين يمكنهم تنظيم الملفات والمجلدات في مساحة Drive مشتركة. |
FILE_ORGANIZER | Enum | المستخدمون الذين يمكنهم تعديل المحتوى وإضافته إلى المهملات ونقله ضمن مساحة Drive مشتركة. |
NONE | Enum | لا يمتلك المستخدم أي أذونات للملف أو المجلد. |
User
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
getDomain() | String | الحصول على اسم النطاق المرتبط بحساب المستخدم. |
getEmail() | String | يحصل على عنوان البريد الإلكتروني للمستخدم. |
getName() | String | يحصل على اسم المستخدم. |
getPhotoUrl() | String | يحصل على عنوان URL لصورة المستخدم. |