Drive Service

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
من Drive

تتيح هذه الخدمة للنصوص البرمجية إنشاء الملفات والمجلدات والعثور عليها وتعديلها في 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

أماكن إقامة

الخاصيةالنوعالوصف
ANYONEEnumيمكن لأي شخص على الإنترنت البحث عن الملف والوصول إليه.
ANYONE_WITH_LINKEnumأي مستخدم لديه الرابط يمكنه الوصول إلى التسجيل.
DOMAINEnumيمكن للأشخاص في نطاقك العثور على الملف والدخول إليه.
DOMAIN_WITH_LINKEnumتتوفر إمكانية الوصول للأشخاص في نطاقك الذين لديهم الرابط.
PRIVATEEnumتتوفر إمكانية الدخول للأشخاص الذين تم منحهم إذنًا صريحًا بذلك.

DriveApp

أماكن إقامة

الخاصيةالنوعالوصف
AccessAccessتعداد يمثل فئات المستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين فرديين تم منحهم حق الوصول بشكل صريح.
PermissionPermissionتعداد يمثّل الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين فرديين تم منحهم حق الوصول بشكل صريح.

الطُرق

الطريقةنوع الإرجاعوصف قصير
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

أماكن إقامة

الخاصيةالنوعالوصف
VIEWEnumالمستخدمون الذين يمكنهم الوصول إلى الملف أو المجلد يمكنهم الاطّلاع عليه أو نسخه فقط.
EDITEnumيمكن للمستخدمين الذين يمكنهم الوصول إلى الملف أو المجلد تعديله.
COMMENTEnumالمستخدمون الذين يمكنهم الوصول إلى الملف أو المجلد يمكنهم الاطّلاع عليه أو نسخه أو التعليق عليه فقط.
OWNEREnumيمتلك المستخدم الملف أو المجلد.
ORGANIZEREnumالمستخدمون الذين يمكنهم تنظيم الملفات والمجلدات داخل مساحة التخزين السحابي المشتركة.
FILE_ORGANIZEREnumالمستخدمون الذين يمكنهم تعديل المحتوى أو نقله أو نقله داخل مساحة تخزين سحابي مشتركة.
NONEEnumلا يمتلك المستخدم أي أذونات للملف أو المجلد.

User

الطُرق

الطريقةنوع الإرجاعوصف قصير
getDomain()Stringتحصل على اسم النطاق المرتبط بحساب المستخدم.
getEmail()Stringيحصل على عنوان البريد الإلكتروني للمستخدم.
getName()Stringيحصل على اسم المستخدم.
getPhotoUrl()Stringيحصل على عنوان URL لصورة المستخدم.