Google Drive API

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

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

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

مستند "اقتراحات"

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

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

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

  • https://www.googleapis.com

مورد REST: v2.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: 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}
يتم تعديل نسخة سابقة.