Google Drive API

تتيح Google Drive API للعملاء الوصول إلى الموارد من Google Drive.

الخدمة: googleapis.com/drive/v2

لطلب هذه الخدمة، ننصح باستخدام مكتبات العميل التي توفّرها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة لطلب هذه الخدمة، استخدِم المعلومات التالية عند طلب بيانات من واجهة برمجة التطبيقات.

مستند الاستكشاف

مستند الاستكشاف هو عبارة عن مواصفات يمكن أن تقرأها الآلة لوصف REST API واستخدامها. وهو يُستخدم لإنشاء مكتبات العميل ومكوّنات IDE الإضافية وغيرها من الأدوات التي تتفاعل مع Google APIs. تجدر الإشارة إلى أنّ خدمة واحدة قد تقدّم أكثر من وثيقة استكشاف. توفّر هذه الخدمة مستند الاكتشاف التالي:

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي الجزء الأساسي من عنوان URL الذي يحدّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد يكون للخدمة الواحدة أكثر من نقطة نهاية واحدة. تحتوي هذه الخدمة على نقطة النهاية التالية، وجميع عناوين URI أدناه تكون نسبيّة لهذه النقطة:

  • https://www.googleapis.com

مورد REST: ‏ v2.about

الطُرق
get GET /drive/v2/about
تعرض هذه الطريقة معلومات عن المستخدم الحالي بالإضافة إلى إعدادات واجهة برمجة تطبيقات Drive.

مورد REST: ‏ v2.apps

الطُرق
get GET /drive/v2/apps/{appId}
يحصل على تطبيق معيّن.
list GET /drive/v2/apps
تعرض هذه السمة قائمة بالتطبيقات المثبَّتة لدى المستخدم.

مورد REST: ‏ v2.changes

الطُرق
get GET /drive/v2/changes/{changeId}
تم إيقاف هذا الخيار نهائيًا: استخدِم changes.getStartPageToken وchanges.list لاسترداد التغييرات الأخيرة.
getStartPageToken GET /drive/v2/changes/startPageToken
تعرض هذه الطريقة الرمز المميّز pageToken للصفحة الأولى من قائمة التغييرات المستقبلية.
list GET /drive/v2/changes
تعرض هذه السمة التغييرات التي أجراها مستخدم أو تم إجراؤها في مساحة تخزين سحابي مشتركة.
watch POST /drive/v2/changes/watch
للاشتراك في تلقّي إشعارات بالتغييرات التي تطرأ على مستخدم.

مورد REST: ‏ v2.channels

الطُرق
stop POST /drive/v2/channels/stop
يوقف مشاهدة الموارد من خلال هذه القناة.

مورد REST: ‏ v2.children

الطُرق
delete DELETE /drive/v2/files/{folderId}/children/{childId}
تزيل هذه السمة طفلاً من مجلد.
get GET /drive/v2/files/{folderId}/children/{childId}
للحصول على مرجع لنطاق فرعي محدّد.
insert POST /drive/v2/files/{folderId}/children
تُستخدَم لإدراج ملف في مجلد.
list GET /drive/v2/files/{folderId}/children
تعرض هذه السمة العناصر الثانوية لمجلد.

مورد REST: ‏ v2.comments

الطُرق
delete DELETE /drive/v2/files/{fileId}/comments/{commentId}
يحذف هذا الإجراء تعليقًا.
get GET /drive/v2/files/{fileId}/comments/{commentId}
يستردّ تعليقًا حسب رقم التعريف.
insert POST /drive/v2/files/{fileId}/comments
لإنشاء تعليق جديد في الملف المحدّد
list GET /drive/v2/files/{fileId}/comments
تعرض هذه السمة تعليقات ملف.
patch PATCH /drive/v2/files/{fileId}/comments/{commentId}
تعدّل هذه الطريقة تعليقًا حاليًا.
update PUT /drive/v2/files/{fileId}/comments/{commentId}
تعدّل هذه الطريقة تعليقًا حاليًا.

مورد REST: ‏ v2.drives

الطُرق
delete DELETE /drive/v2/drives/{driveId}
يحذف هذا الأمر نهائيًا مساحة تخزين سحابي مشتركة يكون المستخدم organizer لها.
get GET /drive/v2/drives/{driveId}
تعرض هذه الطريقة البيانات الوصفية لمساحة تخزين سحابي مشتركة حسب رقم التعريف.
hide POST /drive/v2/drives/{driveId}/hide
يخفي مساحة تخزين سحابي مشتركة من العرض التلقائي.
insert POST /drive/v2/drives
تُستخدَم لإنشاء مساحة تخزين سحابي مشتركة جديدة.
list GET /drive/v2/drives

تعرض هذه السمة مساحات التخزين السحابي المشتركة الخاصة بالمستخدم.
unhide POST /drive/v2/drives/{driveId}/unhide
تعمل هذه السمة على استعادة مساحة تخزين سحابي مشتركة إلى العرض التلقائي.
update PUT /drive/v2/drives/{driveId}
تعدّل هذه الطريقة البيانات الوصفية لمساحة تخزين سحابي مشتركة.

مورد REST: ‏ v2.files

الطُرق
copy POST /drive/v2/files/{fileId}/copy
تنشئ هذه الدالة نسخة من الملف المحدّد.
delete DELETE /drive/v2/files/{fileId}
يحذف هذا الإجراء نهائيًا ملفًا يملكه المستخدم بدون نقله إلى المهملات.
emptyTrash DELETE /drive/v2/files/trash
لحذف جميع ملفات المستخدم في المهملات نهائيًا
export GET /drive/v2/files/{fileId}/export
يصدّر مستند Google Workspace إلى نوع MIME المطلوب ويعرض محتوى البايت المصدَّر.
generateIds GET /drive/v2/files/generateIds
تنشئ هذه الطريقة مجموعة من أرقام تعريف الملفات التي يمكن تقديمها في طلبات الإدراج أو النسخ.
get GET /drive/v2/files/{fileId}

تعرض هذه الطريقة البيانات الوصفية أو المحتوى الخاص بملف معيّن من خلال رقم تعريفه.
insert POST /drive/v2/files
POST /upload/drive/v2/files

يُدرج ملفًا جديدًا.
list GET /drive/v2/files

تعرض هذه السمة ملفات المستخدم.
listLabels GET /drive/v2/files/{fileId}/listLabels
تعرض هذه السمة التصنيفات في ملف.
modifyLabels POST /drive/v2/files/{fileId}/modifyLabels
تعدّل هذه السمة مجموعة التصنيفات المطبَّقة على ملف.
patch PATCH /drive/v2/files/{fileId}
تعدّل هذه الطريقة البيانات الوصفية لملف و/أو محتواه.
touch POST /drive/v2/files/{fileId}/touch
يتم ضبط وقت تعديل الملف على وقت الخادم الحالي.
trash POST /drive/v2/files/{fileId}/trash
ينقل هذا الأمر ملفًا إلى المهملات.
untrash POST /drive/v2/files/{fileId}/untrash
يتم استخدام هذا الأمر لاستعادة ملف من المهملات.
update PUT /drive/v2/files/{fileId}
PUT /upload/drive/v2/files/{fileId}

تعدّل هذه الطريقة البيانات الوصفية لملف أو محتواه أو كليهما.
watch POST /drive/v2/files/{fileId}/watch
يؤدي هذا الإجراء إلى الاشتراك في التغييرات التي يتم إجراؤها على ملف.

مورد REST: ‏ v2.parents

الطُرق
delete DELETE /drive/v2/files/{fileId}/parents/{parentId}
تزيل هذه السمة أحد الوالدَين من ملف.
get GET /drive/v2/files/{fileId}/parents/{parentId}
للحصول على مرجع محدّد للعنصر الأصل.
insert POST /drive/v2/files/{fileId}/parents
تضيف مجلدًا رئيسيًا لملف.
list GET /drive/v2/files/{fileId}/parents
تعرض هذه السمة قائمة بالعناصر الرئيسية للملف.

مورد REST: ‏ v2.permissions

الطُرق
delete DELETE /drive/v2/files/{fileId}/permissions/{permissionId}
يحذف هذا الأمر إذنًا من ملف أو مساحة تخزين سحابي مشتركة.
get GET /drive/v2/files/{fileId}/permissions/{permissionId}
يحصل على إذن حسب رقم التعريف.
getIdForEmail GET /drive/v2/permissionIds/{email}
تعرِض هذه السمة رقم تعريف الإذن الخاص بعنوان بريد إلكتروني.
insert POST /drive/v2/files/{fileId}/permissions
تُدرج هذه الطريقة إذنًا لملف أو مساحة تخزين سحابي مشتركة.
list GET /drive/v2/files/{fileId}/permissions
تعرض هذه السمة أذونات ملف أو مساحة تخزين سحابي مشتركة.
patch PATCH /drive/v2/files/{fileId}/permissions/{permissionId}
تعدّل هذه الطريقة إذنًا باستخدام دلالات رموز التصحيح.
update PUT /drive/v2/files/{fileId}/permissions/{permissionId}
تعديل إذن

مورد REST: ‏ v2.properties

الطُرق
delete DELETE /drive/v2/files/{fileId}/properties/{propertyKey}
لحذف موقع.
get GET /drive/v2/files/{fileId}/properties/{propertyKey}
تعرض هذه الدالة سمة حسب مفتاحها.
insert POST /drive/v2/files/{fileId}/properties
تضيف هذه السمة موقعًا إلكترونيًا إلى ملف أو تعدّله إذا كان موجودًا من قبل.
list GET /drive/v2/files/{fileId}/properties
تعرض هذه السمة خصائص الملف.
patch PATCH /drive/v2/files/{fileId}/properties/{propertyKey}
تعدّل هذه الطريقة موقعًا.
update PUT /drive/v2/files/{fileId}/properties/{propertyKey}
تعدّل هذه الطريقة موقعًا.

مورد REST: ‏ v2.replies

الطُرق
delete DELETE /drive/v2/files/{fileId}/comments/{commentId}/replies/{replyId}
لحذف ردّ
get GET /drive/v2/files/{fileId}/comments/{commentId}/replies/{replyId}
الحصول على رد
insert POST /drive/v2/files/{fileId}/comments/{commentId}/replies
ينشئ ردًا جديدًا على التعليق المحدّد.
list GET /drive/v2/files/{fileId}/comments/{commentId}/replies
تعرض هذه الطريقة جميع الردود على تعليق.
patch PATCH /drive/v2/files/{fileId}/comments/{commentId}/replies/{replyId}
تعديل ردّ حالي
update PUT /drive/v2/files/{fileId}/comments/{commentId}/replies/{replyId}
تعديل ردّ حالي

مورد REST: ‏ v2.revisions

الطُرق
delete DELETE /drive/v2/files/{fileId}/revisions/{revisionId}
لحذف إصدار ملف نهائيًا.
get GET /drive/v2/files/{fileId}/revisions/{revisionId}
تعرض هذه الطريقة مراجعة محدّدة.
list GET /drive/v2/files/{fileId}/revisions
تعرض هذه السمة نُسخ الملف السابقة.
patch PATCH /drive/v2/files/{fileId}/revisions/{revisionId}
تعدّل هذه السمة مراجعة.
update PUT /drive/v2/files/{fileId}/revisions/{revisionId}
تعدّل هذه السمة مراجعة.