تتيح هذه الخدمة للنصوص البرمجية إنشاء الملفات والمجلدات والعثور عليها وتعديلها في Google Drive.
إذا كان النص البرمجي يستخدم مشروعًا عاديًا على Cloud بدلاً من مشروع تلقائي على Cloud، عليك تفعيل واجهة برمجة التطبيقات Drive API يدويًا. في مشروعك العادي على 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 | فهرس يمثّل فئات المستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين individual تم منحهم إذن الوصول صراحةً |
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 | فهرس يمثّل فئات المستخدمين الذين يمكنهم الوصول إلى ملف أو مجلد، بالإضافة إلى أي مستخدمين individual تم منحهم إذن الوصول صراحةً |
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 ، بالإضافة إلى أي مستخدمين individual
تم منحهم إذن الوصول بشكل صريح. |
get | Permission | الحصول على الإذن الممنوح للمستخدمين الذين يمكنهم الوصول إلى File ،
بالإضافة إلى أي مستخدمين فرديين تم منحهم إذن الوصول صراحةً |
get | Integer | تحصل على عدد وحدات البايت المستخدَمة لتخزين File في Drive. |
get | String | إذا كان هذا اختصارًا، يتم عرض رقم تعريف العنصر الذي يشير إليه. |
get | String | إذا كان هذا العنصر اختصارًا، يتم عرض نوع MIME للعنصر الذي يشير إليه. |
get | String | إذا كان الملف اختصارًا، يتم عرض مفتاح المرجع للعنصر الذي يشير إليه. |
get | Blob | تحصل على صورة مصغّرة للملف، أو 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 ، بالإضافة إلى أي مستخدمين individual
تم منحهم إذن الوصول بشكل صريح. |
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 | تحصل على اسم النطاق المرتبط بحساب المستخدم. |
get | String | تحصل على عنوان البريد الإلكتروني للمستخدم. |
get | String | الحصول على اسم المستخدم |
get | String | تحصل على عنوان URL لصورة المستخدم. |