تسمح هذه الخدمة بإنشاء النصوص والمجلدات والعثور عليها وتعديلها في Google Drive.
إذا كان النص البرمجي يستخدم مشروعًا عاديًا على Cloud بدلاً من مشروع تلقائي على السحابة الإلكترونية، عليك تفعيل Drive API يدويًا. في مشروعك العادي على السحابة الإلكترونية، فعِّل واجهة برمجة تطبيقات Drive:
تفعيل واجهة برمجة تطبيقات Drive
يعرض نموذج الرمز التالي كيفية تسجيل أسماء كل ملف في مجلد "ملفاتي" للمستخدم:// Logs the name of every file in the user's Drive.
var files = DriveApp.getFiles();
while (files.hasNext()) {
var file = files.next();
console.log(file.getName());
}
صفوف
الاسم | وصف قصير |
---|---|
Access | تعداد فئات تمثّل فئات المستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً. |
DriveApp | يتيح هذا الخيار للنصوص البرمجية إنشاء ملفات ومجلدات والعثور عليها وتعديلها في Google Drive. |
File | ملف في Google Drive. |
FileIterator | مُكرِّر يسمح بتكرار النصوص البرمجية فوق مجموعة كبيرة من الملفات التي يُحتمل أن تكون كبيرة. |
Folder | مجلّد في Google Drive |
FolderIterator | يشير هذا المصطلح إلى عنصر يسمح بتكرار النصوص البرمجية فوق مجموعة كبيرة من المجلدات. |
Permission | تعداد يمثّل الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، إلى جانب أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً. |
User | مستخدم مرتبط بملف في Google Drive |
Access
أماكن إقامة
الموقع | Type | الوصف |
---|---|---|
ANYONE | Enum | يمكن لأي شخص على الإنترنت البحث عن العنصر والوصول إليه. |
ANYONE_WITH_LINK | Enum | يمكن لأي مستخدم لديه الرابط الوصول إلى هذا التسجيل. |
DOMAIN | Enum | يمكن للمستخدمين في نطاقك العثور على العنصر والوصول إليه. |
DOMAIN_WITH_LINK | Enum | تتوفر إمكانية الوصول للمستخدمين في نطاقك الذين لديهم الرابط. |
PRIVATE | Enum | تتوفر إمكانية الدخول للأشخاص الذين تم منحهم إذنًا صريحًا بذلك. |
DriveApp
أماكن إقامة
الموقع | Type | الوصف |
---|---|---|
Access | Access | تعداد فئات تمثّل فئات المستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً. |
Permission | Permission | تعداد يمثّل الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، إلى جانب أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً. |
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
continueFileIterator(continuationToken) | FileIterator | استئناف تكرار الملف باستخدام رمز مميز للتكرار من مكرّر سابق |
continueFolderIterator(continuationToken) | FolderIterator | استئناف تكرار المجلد باستخدام رمز مميّز لاستمرارية العرض من مكرّر سابق |
createFile(blob) | File | يُنشئ ملفًا في جذر Drive على المستخدم من Blob من البيانات العشوائية. |
createFile(name, content) | File | يُنشئ ملفًا نصيًا في جذر Drive Drive للمستخدم بالاسم ومحتوياته. |
createFile(name, content, mimeType) | File | يُنشئ ملفًا في جذر Drive Drive للمستخدم مع ذكر الاسم والمحتوى ونوع MIME المحدّد. |
createFolder(name) | Folder | ينشئ مجلدًا في جذر Drive 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 | اعرض البيانات داخل هذا الكائن ككائنات ثنائية (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 للمستخدم. |
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(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
أماكن إقامة
الموقع | Type | الوصف |
---|---|---|
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 لصورة المستخدم |