Google Drive API

تسمح واجهة برمجة التطبيقات Google Drive API للعملاء بالوصول إلى الموارد من Google Drive.

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

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

المستند المرتبط بميزة "اقتراحات"

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

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

نقطة نهاية الخدمة هي عنوان 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
تحصل هذه الوظيفة على مفتاح المرور 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}
لتعديل مراجعة.