Google Drive API

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

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

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

مستند Discovery

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

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

نقطة نهاية الخدمة هي عنوان URL أساسي يحدِّد عنوان الشبكة لخدمة واجهة برمجة تطبيقات. قد تحتوي خدمة واحدة على نقاط نهاية متعددة للخدمة. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية وجميع معرّفات الموارد المنتظمة (URI) التالية ذات صلة بنقطة نهاية الخدمة هذه:

  • https://www.googleapis.com

مورد REST: الإصدار 2.about

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

مورد 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
تحصل على رمز بداية الصفحة المميّزة لإدراج التغييرات المستقبلية.
list GET /drive/v2/changes
تسرد التغييرات لمستخدم أو مساحة تخزين سحابي مشتركة.
watch POST /drive/v2/changes/watch
يمكنك الاشتراك لإجراء تغييرات على أحد المستخدمين.

مورد REST: الإصدار 2.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: الإصدار 2.2

الطُرق
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}
تُعدَّل النسخة السابقة.