Method: drives.insert
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لإنشاء مساحة تخزين سحابي مشتركة جديدة
طلب HTTP
POST https://www.googleapis.com/drive/v2/drives
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات طلب البحث
| المعلمات |
requestId |
string
مطلوب. رقم تعريف، مثل معرّف UUID عشوائي، يحدِّد بشكلٍ فريد طلب هذا المستخدِم لإنشاء مساحة تخزين سحابي مشترَكة بشكلٍ لا يتغيّر. سيؤدي تقديم طلب متكرّر من قِبل المستخدم نفسه ومعرّف الطلب نفسه إلى تجنُّب إنشاء نُسخ طبق الأصل من خلال محاولة إنشاء مساحة التخزين السحابي المشتركة نفسها. إذا كانت مساحة التخزين السحابي المشتركة متوفّرة، سيتم عرض الخطأ 409.
|
نص الطلب
يحتوي نص الطلب على مثال Drive.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من Drive.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/drive
تكون بعض النطاقات محظورة وتتطلّب تقييم أمان ليتمكّن تطبيقك من استخدامها. لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: drives.insert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a new shared drive.\n\n### HTTP request\n\n`POST https://www.googleapis.com/drive/v2/drives`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requestId` | `string` Required. An ID, such as a random UUID, which uniquely identifies this user's request for idempotent creation of a shared drive. A repeated request by the same user and with the same request ID will avoid creating duplicates by attempting to create the same shared drive. If the shared drive already exists a 409 error will be returned. |\n\n### Request body\n\nThe request body contains an instance of [Drive](/workspace/drive/api/reference/rest/v2/drives#Drive).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Drive](/workspace/drive/api/reference/rest/v2/drives#Drive).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/drive`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
