تتيح لك واجهة برمجة التطبيقات Google Drive API إنشاء تطبيقات تستخدم مساحة التخزين السحابي في Google Drive.
يمكنك تطوير تطبيقات تتكامل مع Drive وإنشاء وظائف قوية في تطبيقك باستخدام Drive API.
يوضّح هذا الرسم البياني العلاقة بين تطبيق Drive وDrive API وDrive:
الشكل 1. مخطّط علاقات Google Drive
تحدّد هذه المصطلحات المكوّنات الرئيسية الموضّحة في الشكل 1:
Google Drive
توفّر خدمة تخزين الملفات في السحابة الإلكترونية من Google للمستخدمين مساحة تخزين شخصية، تُعرف باسم ملفاتي، وخيار الوصول إلى المجلدات المشتركة التعاونية، المعروفة باسم مساحات Drive المشتركة.
Google Drive API
واجهة REST API التي تتيح لك استخدام مساحة تخزين Drive
من داخل تطبيقك
تطبيق Google Drive
تطبيق يستخدم Drive كحلّ للتخزين
واجهة مستخدم Google Drive
واجهة مستخدم Google التي تدير الملفات المخزَّنة على Drive إذا كان تطبيقك من نوع تطبيقات التحرير، مثل
جداول البيانات أو معالجة النصوص، يمكنك الدمج مع
واجهة مستخدم Drive لإنشاء الملفات وفتحها داخل تطبيقك.
ملفاتي
موقع تخزين في Drive يملكه مستخدم محدّد. يمكن مشاركة الملفات المخزّنة في "ملفاتي" مع مستخدمين آخرين، ولكن تظل ملكية المحتوى خاصة بمستخدم فردي.
OAuth 2.0
بروتوكول التفويض الذي تتطلّبه واجهة برمجة التطبيقات Drive API
لإثبات هوية مستخدمي تطبيقك. إذا كان تطبيقك يستخدم ميزة تسجيل الدخول باستخدام حساب Google، سيتولّى معالجة عملية OAuth 2.0 ورموز الدخول إلى التطبيق.
مساحة التخزين السحابي المشتركة
موقع تخزين على Drive يضم ملفات يتعاون عليها عدة مستخدمين. يمكن لأي مستخدم لديه إذن وصول إلى مساحة تخزين سحابي مشتركة الوصول إلى جميع الملفات التي تحتوي عليها. يمكن أيضًا منح المستخدمين إذن الوصول إلى ملفات فردية داخل مساحة التخزين السحابي المشتركة.
يمكنك دمج تطبيقك المتوافق مع Drive مع واجهة مستخدم Drive
باستخدام واجهة مستخدم Google Drive. وهي واجهة مستخدم الويب العادية من Google التي يمكنك استخدامها لإنشاء ملفات Drive وتنظيمها والبحث عنها ومشاركتها.
تطبيق التصنيفات على ملفات Drive، وتحديد قيم حقول التصنيفات، وقراءة قيم حقول التصنيفات في الملفات، والبحث عن الملفات باستخدام عبارات بيانات وصفية خاصة بالتصنيفات تم تحديدها من خلال تصنيف التصنيفات المخصصة
هل تريد الاطّلاع على Google Drive API أثناء العمل؟
تقدّم قناة "مطوّرو Google Workspace" فيديوهات تتضمّن نصائح وحِيلاً وأحدث الميزات.
لمعرفة المزيد عن التطوير باستخدام واجهات برمجة التطبيقات في Google Workspace، بما في ذلك التعامل مع المصادقة والتفويض، يُرجى الاطّلاع على التطوير على Google Workspace.
للتعرّف على كيفية ضبط تطبيق Drive API وتشغيله، يُرجى الاطّلاع على البدايات السريعة.
تاريخ التعديل الأخير: 2025-09-03 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-03 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["|-------------------------------------------------------------------------------------------------------------------------------------------|\n| Got 5 minutes? Help us improve our Google Workspace documentation by taking a quick [online survey](https://forms.gle/XcqRP3PJiQv9ADuj9). |\n\nThe Google Drive API lets you create apps that use Google Drive cloud storage.\nYou can develop applications that integrate with Drive, and\ncreate robust functionality in your application using the Drive API.\n\nThis diagram shows the relationship between your Drive app, the\nDrive API, and Drive:\n**Figure 1.** Google Drive relationship diagram.\n\nThese terms define the key components shown in Figure 1:\n\n*Google Drive*\n: Google's cloud file storage service provides users with a\n personal storage space, called *My Drive* , and the option to\n access collaborative shared folders, called *shared drives*.\n\n*Google Drive API*\n: The REST API that lets you use Drive storage\n from within your app.\n\n*Google Drive app*\n: An app that uses Drive as its storage solution.\n\n*Google Drive UI*\n: Google's user interface that manages files stored on\n Drive. If your app is an editor-type app, such as a\n spreadsheet or word processor, you can integrate with the\n Drive UI to create and open files within your app.\n\n*My Drive*\n: A Drive storage location that a\n specific user owns. Files stored on My Drive can be shared\n with other users, but ownership of the content remains specific to an\n individual user.\n\n*OAuth 2.0*\n: The authorization protocol that Drive API requires to\n authenticate your app users. If your application uses [Sign In With\n Google](/identity/gsi/web/guides/overview), it handles the OAuth 2.0 flow\n and application access tokens.\n\n*Shared drive*\n: A Drive storage location that owns files that multiple users\n collaborate on. Any user with access to a shared drive has access to all\n files it contains. Users can also be granted access to individual\n files inside the shared drive.\n\nWhat can you do with the Drive API?\n\nYou can use the Drive API to:\n\n- [Download files](/workspace/drive/api/guides/manage-downloads) from Drive and [upload files](/workspace/drive/api/guides/manage-uploads) to Drive.\n- [Search for files and folders](/workspace/drive/api/guides/search-files) stored in Drive. Create complex search queries that return any of the file metadata fields in the [`files`](/workspace/drive/api/reference/rest/v3/files) resource.\n- Let users [share files, folders, and drives](/workspace/drive/api/guides/manage-sharing) to collaborate on content.\n- Combine with the [Google Picker API](https://developers.google.com/picker/docs/) to search all files in Drive, then return the filename, URL, last modified date, and user.\n- [Create *third-party shortcuts*](/workspace/drive/api/guides/third-party-shortcuts) that are external links to data stored outside of Drive, in a different datastore or cloud storage system.\n- Create a dedicated Drive folder to [store\n application-specific data](/workspace/drive/api/guides/appdata) so the app cannot access all the user's content stored in Drive.\n- Monitor or respond to file activity using [Google Drive\n events](/workspace/events/guides/events-drive).\n- Integrate your Drive-enabled app with the [Drive UI](/workspace/drive/api/guides/about-apps) using the *Google Drive UI*. It's Google's standard web UI that you can use to create, organize, discover, and share Drive files.\n- Apply [labels](/workspace/drive/api/guides/about-labels) to Drive files, set label field values, read label field values on files, and search for files using label metadata terms defined by the custom label taxonomy.\n\n|---|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | Want to see the Google Drive API in action? The Google Workspace Developers channel offers videos about tips, tricks, and the latest features. [Subscribe now](https://www.youtube.com/channel/UCUcg6az6etU_gRtZVAhBXaw) |\n\nRelated topics\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, see [Develop on\n Google Workspace](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a Drive API app, read the\n [Quickstarts](/workspace/drive/api/quickstart/js)."]]
