تتيح هذه الخدمة للبرامج النصية إنشاء الملفات والمجلدات والعثور عليها وتعديلها في Google Drive. على الرغم من أنّ خدمة Drive المضمّنة أسهل في الاستخدام، إلا أنّها تتضمّن بعض القيود. للحصول على أحدث الميزات والدعم، والوصول إلى الملفات أو المجلدات في مساحات التخزين السحابي المشتركة، استخدِم خدمة Drive المتقدّمة.
إذا كان النص البرمجي يستخدم مشروع Cloud عاديًا بدلاً من مشروع Cloud تلقائي، عليك تفعيل Drive API يدويًا. في مشروعك العادي على السحابة الإلكترونية، فعِّل Drive API باتّباع الخطوات التالية:
يوضّح نموذج الرمز التالي كيفية تسجيل أسماء كل ملف في مجلد "ملفاتي" الخاص بالمستخدم:// 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 | تعداد يمثّل فئات المستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكل صريح. |
Drive | يسمح للبرامج النصية بإنشاء الملفات والمجلدات والبحث عنها وتعديلها في Google Drive. |
File | ملف في Google Drive |
File | عنصر تكرار يتيح للبرامج النصية التكرار على مجموعة كبيرة محتملة من الملفات. |
Folder | مجلد في Google Drive |
Folder | عنصر يتيح للبرامج النصية تكرار مجموعة كبيرة محتملة من المجلدات. |
Permission | تعداد يمثّل الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكل صريح. |
User | يشير ذلك إلى مستخدم مرتبط بملف في Google Drive. |
Access
الخصائص
| الموقع | النوع | الوصف |
|---|---|---|
ANYONE | Enum | يمكن لأي شخص على الإنترنت البحث عن الروابط والدخول إلى العناصر. |
ANYONE_WITH_LINK | Enum | يمكن لأي مستخدم لديه الرابط الوصول إلى هذا التسجيل. |
DOMAIN | Enum | يمكن للمستخدمين في نطاقك العثور على المستند والوصول إليه. |
DOMAIN_WITH_LINK | Enum | يمكن للمستخدمين في نطاقك الذين لديهم الرابط الوصول إلى الملف. |
PRIVATE | Enum | تتوفر إمكانية الدخول للأشخاص الذين تم منحهم إذنًا صريحًا بذلك. |
Drive App
الخصائص
| الموقع | النوع | الوصف |
|---|---|---|
Access | Access | تعداد يمثّل فئات المستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكل صريح. |
Permission | Permission | تعداد يمثّل الأذونات الممنوحة للمستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكل صريح. |
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
continue | File | يستأنف تكرار الملفات باستخدام رمز مميز لمواصلة العملية من مكرّر سابق. |
continue | Folder | تستأنف هذه الطريقة تكرار المجلد باستخدام رمز مميز لمواصلة العملية من مكرّر سابق. |
create | File | ينشئ هذا الإجراء ملفًا في جذر حساب المستخدم على Drive من Blob معيّن من البيانات العشوائية. |
create | File | ينشئ هذا الإجراء ملفًا نصيًا في جذر مساحة Drive الخاصة بالمستخدم بالاسم والمحتوى المحدّدَين. |
create | File | ينشئ هذا الإجراء ملفًا في جذر مساحة تخزين المستخدم على Drive بالاسم والمحتوى ونوع MIME المحدّدين. |
create | Folder | ينشئ هذا الإجراء مجلدًا في جذر حساب المستخدم على Drive بالاسم المحدّد. |
create | File | تنشئ هذه الطريقة اختصارًا لمعرّف عنصر Drive المقدَّم وتعرضه. |
create | File | ينشئ هذا الإجراء اختصارًا لمعرّف عنصر Drive ومفتاح المورد المقدَّمَين، ويعرضه. |
enforce | void | تفعيل أو إيقاف سلوك enforceSingleParent لجميع عمليات الاستدعاء التي تؤثر في العناصر الرئيسية |
get | File | يحصل على الملف الذي يحمل رقم التعريف المحدّد. |
get | File | يحصل على الملف الذي يحمل رقم التعريف ومفتاح المصدر المحدّدَين. |
get | File | تعرض هذه الطريقة مجموعة من جميع الملفات في حساب Drive الخاص بالمستخدم. |
get | File | تعرض هذه الطريقة مجموعة من جميع الملفات في مساحة Drive الخاصة بالمستخدم والتي تحمل الاسم المحدّد. |
get | File | تعرض هذه الطريقة مجموعة من جميع الملفات في حساب Drive الخاص بالمستخدم والتي لها نوع MIME المحدّد. |
get | Folder | تعرض هذه الطريقة المجلد الذي يحمل رقم التعريف المحدّد. |
get | Folder | تعرض هذه الطريقة المجلد الذي يحمل رقم التعريف ومفتاح المورد المحدّدَين. |
get | Folder | تعرض هذه الطريقة مجموعة من جميع المجلدات في حساب Drive الخاص بالمستخدم. |
get | Folder | تعرض هذه الطريقة مجموعة من جميع المجلدات في Drive الخاص بالمستخدم والتي تحمل الاسم المحدّد. |
get | Folder | تعرض هذه الطريقة المجلد في جذر حساب المستخدم على Drive. |
get | Integer | تعرض هذه السمة عدد وحدات البايت التي يُسمح للمستخدم بتخزينها في Drive. |
get | Integer | تعرض هذه الطريقة عدد وحدات البايت التي يخزّنها المستخدم حاليًا في Drive. |
get | File | تعرض هذه الطريقة مجموعة من جميع الملفات في سلة المهملات في حساب Drive الخاص بالمستخدم. |
get | Folder | تعرض هذه الطريقة مجموعة من جميع المجلدات في مهملات حساب Drive الخاص بالمستخدم. |
search | File | تعرض هذه الطريقة مجموعة من جميع الملفات في حساب المستخدم على Drive التي تتطابق مع معايير البحث المحدّدة. |
search | Folder | تعرض هذه الطريقة مجموعة من جميع المجلدات في حساب المستخدم على Drive التي تطابق معايير البحث المحدّدة. |
File
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
add | File | أضِف المستخدم المحدّد إلى قائمة المعلّقين على File. |
add | File | أضِف المستخدم المحدّد إلى قائمة المعلّقين على File. |
add | File | أضِف مصفوفة المستخدمين المحدّدة إلى قائمة المعلّقين على File. |
add | File | تضيف هذه الطريقة المستخدم المحدّد إلى قائمة المحرّرين في File. |
add | File | تضيف هذه الطريقة المستخدم المحدّد إلى قائمة المحرّرين في File. |
add | File | تضيف هذه الطريقة مصفوفة المستخدمين المحدّدة إلى قائمة المحرّرين في File. |
add | File | تضيف هذه الطريقة المستخدم المحدّد إلى قائمة المشاهدين في File. |
add | File | تضيف هذه الطريقة المستخدم المحدّد إلى قائمة المشاهدين في File. |
add | File | تضيف هذه الطريقة مصفوفة المستخدمين المحدّدة إلى قائمة المشاهدين في File. |
get | Permission | تعرض هذه الطريقة الإذن الممنوح لمستخدم معيّن. |
get | Permission | تعرض هذه الطريقة الإذن الممنوح لمستخدم معيّن. |
get | Blob | لعرض البيانات داخل هذا العنصر ككائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد |
get | Blob | لعرض البيانات داخل هذا العنصر ككائن ثنائي كبير. |
get | Date | تعرض هذه السمة تاريخ إنشاء File. |
get | String | تعرض هذه السمة وصفًا لـ File. |
get | String | تعرض هذه السمة عنوان URL الذي يمكن استخدامه لتنزيل الملف. |
get | User[] | تعرض هذه الطريقة قائمة بالمحرّرين في File. |
get | String | تعرض هذه السمة معرّف File. |
get | Date | تعرض هذه السمة تاريخ آخر تعديل على File. |
get | String | تعرض هذه السمة نوع MIME للملف. |
get | String | تعرض هذه السمة اسم File. |
get | User | تعرض هذه الطريقة مالك الملف. |
get | Folder | تعرض هذه الطريقة مجموعة من المجلدات التي تمثّل المجلدات الرئيسية المباشرة للعنصر File. |
get | String | يحصل هذا الحقل على مفتاح المورد الخاص بـ File المطلوب للوصول إلى الملفات التي تمت مشاركتها باستخدام رابط. |
get | Boolean | تعرض هذه السمة ما إذا كان File مؤهلاً لتطبيق تحديث الأمان الذي يتطلب مفتاح مصدر للوصول إلى الملف عند مشاركته باستخدام رابط. |
get | Boolean | تعرض هذه السمة ما إذا كان File يتطلّب مفتاح مورد للوصول إليه عند مشاركته باستخدام رابط. |
get | Access | تعرض هذه السمة فئة المستخدمين الذين يمكنهم الوصول إلى File، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكل صريح. |
get | Permission | تعرض هذه السمة الإذن الممنوح للمستخدمين الذين يمكنهم الوصول إلى File،
بالإضافة إلى أي مستخدمين فرديين تم منحهم الإذن بالوصول بشكل صريح. |
get | Integer | تعرض هذه الطريقة عدد وحدات البايت المستخدَمة لتخزين File في Drive. |
get | String | إذا كان هذا العنصر عبارة عن اختصار، تعرض هذه السمة معرّف العنصر الذي يشير إليه الاختصار. |
get | String | إذا كان هذا العنصر عبارة عن اختصار، تعرض هذه السمة نوع MIME الخاص بالعنصر الذي يشير إليه. |
get | String | إذا كان الملف عبارة عن اختصار، يعرض مفتاح مصدر العنصر الذي يشير إليه. |
get | Blob|null | تعرض هذه السمة صورة مصغّرة للملف، أو null إذا لم تكن هناك صورة مصغّرة. |
get | String | يحصل على عنوان URL الذي يمكن استخدامه لفتح File في أحد تطبيقات Google، مثل Drive أو "مستندات Google". |
get | User[] | تعرض هذه الطريقة قائمة بالمشاهدين والمعلّقين على File. |
is | Boolean | تحدّد هذه السمة ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل File بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات. |
is | Boolean | تُحدِّد هذه السمة ما إذا تم تمييز File بنجمة في حساب Drive الخاص بالمستخدم. |
is | Boolean | يحدّد هذا الحقل ما إذا كان File في مهملات حساب المستخدم على Drive. |
make | File | ينشئ نسخة من الملف. |
make | File | ينشئ نسخة من الملف في دليل الوجهة. |
make | File | ينشئ هذا الإجراء نسخة من الملف ويسمّيها بالاسم المقدَّم. |
make | File | ينشئ نسخة من الملف في دليل الوجهة ويسمّيها بالاسم المقدَّم. |
move | File | تنقل هذه الطريقة العنصر إلى مجلد الوجهة المقدَّم. |
remove | File | يزيل هذا الإجراء المستخدم المحدّد من قائمة المعلّقين على File. |
remove | File | يزيل هذا الإجراء المستخدم المحدّد من قائمة المعلّقين على File. |
remove | File | تزيل هذه الطريقة المستخدم المحدّد من قائمة المحرّرين في File. |
remove | File | تزيل هذه الطريقة المستخدم المحدّد من قائمة المحرّرين في File. |
remove | File | تزيل هذه الطريقة المستخدم المحدّد من قائمة المشاهدين والمعلّقين على File. |
remove | File | تزيل هذه الطريقة المستخدم المحدّد من قائمة المشاهدين والمعلّقين على File. |
revoke | File | يلغي هذا الإجراء إذن الوصول إلى File الممنوح للمستخدم المحدّد. |
revoke | File | يلغي هذا الإجراء إذن الوصول إلى File الممنوح للمستخدم المحدّد. |
set | File | تتم الكتابة فوق محتوى الملف باستبداله بمحتوى آخر. |
set | File | تضبط هذه السمة وصف File. |
set | File | تُستخدَم لضبط اسم File. |
set | File | تغيير مالك File |
set | File | تغيير مالك File |
set | File | يحدّد هذا الإعداد ما إذا كانت السمة File تتطلّب مفتاح مصدر للوصول إليها عند مشاركتها باستخدام رابط. |
set | File | تضبط هذه السمة ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل File بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات. |
set | File | تحدّد هذه السمة فئة المستخدمين الذين يمكنهم الوصول إلى File والأذونات الممنوحة لهم، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكل صريح. |
set | File | تضبط هذه السمة ما إذا كان File مميّزًا بنجمة في حساب Drive الخاص بالمستخدم. |
set | File | يحدّد هذا الحقل ما إذا كان File في مهملات حساب المستخدم على Drive. |
File Iterator
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
get | String | يحصل على رمز مميّز يمكن استخدامه لاستئناف هذه التكرار في وقت لاحق. |
has | Boolean | تحدّد هذه السمة ما إذا كان طلب next() سيعرض عنصرًا. |
next() | File | تعرض هذه السمة العنصر التالي في مجموعة الملفات أو المجلدات. |
Folder
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
add | Folder | تضيف هذه الطريقة المستخدم المحدّد إلى قائمة المحرّرين في Folder. |
add | Folder | تضيف هذه الطريقة المستخدم المحدّد إلى قائمة المحرّرين في Folder. |
add | Folder | تضيف هذه الطريقة مصفوفة المستخدمين المحدّدة إلى قائمة المحرّرين في Folder. |
add | Folder | تضيف هذه الطريقة المستخدم المحدّد إلى قائمة المشاهدين في Folder. |
add | Folder | تضيف هذه الطريقة المستخدم المحدّد إلى قائمة المشاهدين في Folder. |
add | Folder | تضيف هذه الطريقة مصفوفة المستخدمين المحدّدة إلى قائمة المشاهدين في Folder. |
create | File | ينشئ هذا الإجراء ملفًا في المجلد الحالي من Blob معيّن يتضمّن بيانات عشوائية. |
create | File | ينشئ ملفًا نصيًا في المجلد الحالي بالاسم والمحتوى المحدّدين. |
create | File | تنشئ هذه الطريقة ملفًا في المجلد الحالي بالاسم والمحتوى ونوع MIME المحدّدين. |
create | Folder | ينشئ هذا الأمر مجلدًا في المجلد الحالي بالاسم المحدّد. |
create | File | تنشئ هذه الطريقة اختصارًا لمعرّف عنصر Drive المقدَّم وتعرضه. |
create | File | ينشئ هذا الإجراء اختصارًا لمعرّف عنصر Drive ومفتاح المورد المقدَّمَين، ويعرضه. |
get | Permission | تعرض هذه الطريقة الإذن الممنوح لمستخدم معيّن. |
get | Permission | تعرض هذه الطريقة الإذن الممنوح لمستخدم معيّن. |
get | Date | تعرض هذه السمة تاريخ إنشاء Folder. |
get | String | تعرض هذه السمة وصفًا لـ Folder. |
get | User[] | تعرض هذه الطريقة قائمة بالمحرّرين في Folder. |
get | File | يحصل على مجموعة من جميع الملفات التي تندرج ضمن المجلد الحالي. |
get | File | يحصل على مجموعة من جميع الملفات التي تندرج ضمن المجلد الحالي ولها الاسم المحدّد. |
get | File | تعرض هذه الطريقة مجموعة من جميع الملفات التي تندرج ضمن المجلد الحالي ولها نوع MIME المحدّد. |
get | Folder | تعرض هذه الطريقة مجموعة من جميع المجلدات التي تندرج ضمن المجلد الحالي. |
get | Folder | تعرض هذه الطريقة مجموعة من جميع المجلدات التي تندرج ضمن المجلد الحالي وتحمل الاسم المحدّد. |
get | String | تعرض هذه السمة معرّف Folder. |
get | Date | تعرض هذه السمة تاريخ آخر تعديل على Folder. |
get | String | تعرض هذه السمة اسم Folder. |
get | User | تعرض هذه الطريقة مالك Folder. |
get | Folder | تعرض هذه الطريقة مجموعة من المجلدات التي تمثّل المجلدات الرئيسية المباشرة للعنصر Folder. |
get | String | يحصل هذا الحقل على مفتاح المورد الخاص بـ Folder المطلوب للوصول إلى الملفات التي تمت مشاركتها باستخدام رابط. |
get | Boolean | تعرض هذه السمة ما إذا كان Folder مؤهلاً لتطبيق تحديث الأمان الذي يتطلب مفتاح مصدر للوصول إلى الملف عند مشاركته باستخدام رابط. |
get | Boolean | تعرض هذه السمة ما إذا كان Folder يتطلّب مفتاح مورد للوصول إليه عند مشاركته باستخدام رابط. |
get | Access | تعرض هذه السمة فئة المستخدمين الذين يمكنهم الوصول إلى Folder، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكل صريح. |
get | Permission | تعرض هذه السمة الإذن الممنوح للمستخدمين الذين يمكنهم الوصول إلى Folder،
بالإضافة إلى أي مستخدمين فرديين تم منحهم الإذن بالوصول بشكل صريح. |
get | Integer | تعرض هذه الطريقة عدد وحدات البايت المستخدَمة لتخزين Folder في Drive. |
get | String | يحصل على عنوان URL الذي يمكن استخدامه لفتح Folder في أحد تطبيقات Google، مثل Drive أو "مستندات Google". |
get | User[] | تعرض هذه الطريقة قائمة بالمشاهدين والمعلّقين على Folder. |
is | Boolean | تحدّد هذه السمة ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل Folder بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات. |
is | Boolean | تُحدِّد هذه السمة ما إذا تم تمييز Folder بنجمة في حساب Drive الخاص بالمستخدم. |
is | Boolean | يحدّد هذا الحقل ما إذا كان Folder في مهملات حساب المستخدم على Drive. |
move | Folder | تنقل هذه الطريقة العنصر إلى مجلد الوجهة المقدَّم. |
remove | Folder | تزيل هذه الطريقة المستخدم المحدّد من قائمة المحرّرين في Folder. |
remove | Folder | تزيل هذه الطريقة المستخدم المحدّد من قائمة المحرّرين في Folder. |
remove | Folder | تزيل هذه الطريقة المستخدم المحدّد من قائمة المشاهدين والمعلّقين على Folder. |
remove | Folder | تزيل هذه الطريقة المستخدم المحدّد من قائمة المشاهدين والمعلّقين على Folder. |
revoke | Folder | يلغي هذا الإجراء إذن الوصول إلى Folder الممنوح للمستخدم المحدّد. |
revoke | Folder | يلغي هذا الإجراء إذن الوصول إلى Folder الممنوح للمستخدم المحدّد. |
search | File | يحصل على مجموعة من جميع الملفات التي تمثّل عناصر فرعية للمجلد الحالي وتتطابق مع معايير البحث المحدّدة. |
search | Folder | يحصل على مجموعة من جميع المجلدات الفرعية للمجلد الحالي والتي تتطابق مع معايير البحث المحدّدة. |
set | Folder | تضبط هذه السمة وصف Folder. |
set | Folder | تُستخدَم لضبط اسم Folder. |
set | Folder | تغيير مالك Folder |
set | Folder | تغيير مالك Folder |
set | Folder | يحدّد هذا الإعداد ما إذا كانت السمة Folder تتطلّب مفتاح مصدر للوصول إليها عند مشاركتها باستخدام رابط. |
set | Folder | تضبط هذه السمة ما إذا كان يُسمح للمستخدمين الذين لديهم أذونات تعديل Folder بالمشاركة مع مستخدمين آخرين أو تغيير الأذونات. |
set | Folder | تحدّد هذه السمة فئة المستخدمين الذين يمكنهم الوصول إلى Folder والأذونات الممنوحة لهم، بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول بشكل صريح. |
set | Folder | تضبط هذه السمة ما إذا كان Folder مميّزًا بنجمة في حساب Drive الخاص بالمستخدم. |
set | Folder | يحدّد هذا الحقل ما إذا كان Folder في مهملات حساب المستخدم على Drive. |
Folder Iterator
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
get | String | يحصل على رمز مميّز يمكن استخدامه لاستئناف هذه التكرار في وقت لاحق. |
has | Boolean | تحدّد هذه السمة ما إذا كان طلب next() سيعرض عنصرًا. |
next() | Folder | تعرض هذه السمة العنصر التالي في مجموعة الملفات أو المجلدات. |
Permission
الخصائص
| الموقع | النوع | الوصف |
|---|---|---|
VIEW | Enum | يمكن للمستخدمين الذين يمكنهم الوصول إلى الملف أو المجلد الاطّلاع عليه أو نسخه فقط. |
EDIT | Enum | يمكن للمستخدمين الذين يمكنهم الوصول إلى الملف أو المجلد تعديله. |
COMMENT | Enum | يمكن للمستخدمين الذين يمكنهم الوصول إلى الملف أو المجلد عرضه أو نسخه أو التعليق عليه فقط. |
OWNER | Enum | يمتلك المستخدم الملف أو المجلد. |
ORGANIZER | Enum | المستخدمون الذين يمكنهم تنظيم الملفات والمجلدات في مساحة تخزين سحابي مشتركة |
FILE_ORGANIZER | Enum | المستخدمون الذين يمكنهم تعديل المحتوى ونقله إلى المهملات ونقله داخل مساحة تخزين سحابي مشتركة |
NONE | Enum | لا يملك المستخدم أي أذونات للملف أو المجلد. |
User
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
get | String|null | تعرض هذه الطريقة اسم النطاق المرتبط بحساب المستخدم. |
get | String|null | تعرض هذه السمة عنوان البريد الإلكتروني للمستخدم. |
get | String|null | تعرض هذه السمة اسم المستخدم. |
get | String|null | تعرض هذه الطريقة عنوان URL لصورة المستخدم. |