تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

REST Resource: drives

المورد: Drive
- تمثيل JSON
الطُرق

المورد: Drive

تمثيل مساحة تخزين سحابي مشتركة

تتطلّب بعض طرق الموارد (مثل drives.update) السمة driveId. استخدِم الطريقة drives.list لاسترداد رقم تعريف مساحة تخزين سحابي مشتركة.

تمثيل JSON
{ "id": string, "name": string, "colorRgb": string, "kind": string, "backgroundImageLink": string, "capabilities": { "canAddChildren": boolean, "canComment": boolean, "canCopy": boolean, "canDeleteDrive": boolean, "canDownload": boolean, "canEdit": boolean, "canListChildren": boolean, "canManageMembers": boolean, "canReadRevisions": boolean, "canRename": boolean, "canRenameDrive": boolean, "canChangeDriveBackground": boolean, "canShare": boolean, "canChangeCopyRequiresWriterPermissionRestriction": boolean, "canChangeDomainUsersOnlyRestriction": boolean, "canChangeDriveMembersOnlyRestriction": boolean, "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean, "canResetDriveRestrictions": boolean, "canDeleteChildren": boolean, "canTrashChildren": boolean }, "themeId": string, "backgroundImageFile": { "id": string, "xCoordinate": number, "yCoordinate": number, "width": number }, "createdTime": string, "hidden": boolean, "restrictions": { "copyRequiresWriterPermission": boolean, "domainUsersOnly": boolean, "driveMembersOnly": boolean, "adminManagedRestrictions": boolean, "sharingFoldersRequiresOrganizerPermission": boolean }, "orgUnitId": string }

تمثيل JSON

{
  "id": string,
  "name": string,
  "colorRgb": string,
  "kind": string,
  "backgroundImageLink": string,
  "capabilities": {
    "canAddChildren": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDeleteDrive": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canManageMembers": boolean,
    "canReadRevisions": boolean,
    "canRename": boolean,
    "canRenameDrive": boolean,
    "canChangeDriveBackground": boolean,
    "canShare": boolean,
    "canChangeCopyRequiresWriterPermissionRestriction": boolean,
    "canChangeDomainUsersOnlyRestriction": boolean,
    "canChangeDriveMembersOnlyRestriction": boolean,
    "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean,
    "canResetDriveRestrictions": boolean,
    "canDeleteChildren": boolean,
    "canTrashChildren": boolean
  },
  "themeId": string,
  "backgroundImageFile": {
    "id": string,
    "xCoordinate": number,
    "yCoordinate": number,
    "width": number
  },
  "createdTime": string,
  "hidden": boolean,
  "restrictions": {
    "copyRequiresWriterPermission": boolean,
    "domainUsersOnly": boolean,
    "driveMembersOnly": boolean,
    "adminManagedRestrictions": boolean,
    "sharingFoldersRequiresOrganizerPermission": boolean
  },
  "orgUnitId": string
}

الحقول
`id`	`string` الإخراج فقط. رقم تعريف مساحة التخزين السحابي المشتركة هذه، وهو أيضًا رقم تعريف مجلد المستوى الأعلى في مساحة التخزين السحابي المشتركة هذه.
`name`	`string` اسم مساحة التخزين السحابي المشتركة هذه.
`colorRgb`	`string` لون مساحة التخزين السحابي المشتركة هذه كسلسلة سداسية عشرية على شكل RGB ويمكن ضبطها فقط على طلب `drive.drives.update` الذي لا يحدِّد `themeId`.
`kind`	`string` الإخراج فقط. يحدّد نوع هذا المورد. القيمة: السلسلة الثابتة `"drive#drive"`.
`backgroundImageLink`	`string` الإخراج فقط. رابط قصير الأجل يؤدي إلى صورة خلفية مساحة التخزين السحابي المشتركة هذه.
`capabilities`	`object` الإخراج فقط. الإمكانيات المتاحة للمستخدم الحالي في مساحة التخزين السحابي المشتركة هذه.
`capabilities.canAddChildren`	`boolean` الإخراج فقط. ما إذا كان يمكن للمستخدم الحالي إضافة أطفال إلى المجلدات في مساحة التخزين السحابي المشتركة هذه
`capabilities.canComment`	`boolean` الإخراج فقط. ما إذا كان يمكن للمستخدم الحالي التعليق على الملفات في "مساحة التخزين السحابي المشتركة" هذه.
`capabilities.canCopy`	`boolean` الإخراج فقط. ما إذا كان بإمكان المستخدم الحالي نسخ الملفات في مساحة التخزين السحابي المشتركة هذه
`capabilities.canDeleteDrive`	`boolean` الإخراج فقط. ما إذا كان بإمكان المستخدم الحالي حذف مساحة التخزين السحابي المشتركة هذه. قد يتعذّر أيضًا محاولة حذف مساحة التخزين السحابي المشتركة إذا كانت هناك عناصر غير مضمّنة في المهملات ضمن مساحة التخزين السحابي المشتركة.
`capabilities.canDownload`	`boolean` الإخراج فقط. ما إذا كان بإمكان المستخدم الحالي تنزيل الملفات في مساحة التخزين السحابي المشتركة هذه.
`capabilities.canEdit`	`boolean` الإخراج فقط. ما إذا كان يمكن للمستخدم الحالي تعديل الملفات في مساحة التخزين السحابي المشتركة هذه
`capabilities.canListChildren`	`boolean` الإخراج فقط. ما إذا كان يمكن للمستخدم الحالي إدراج العناصر الثانوية للمجلدات في مساحة التخزين السحابي المشتركة هذه.
`capabilities.canManageMembers`	`boolean` الإخراج فقط. ما إذا كان يمكن للمستخدم الحالي إضافة أعضاء إلى مساحة التخزين السحابي المشتركة هذه أو إزالتهم أو تغيير دورهم
`capabilities.canReadRevisions`	`boolean` الإخراج فقط. ما إذا كان يمكن للمستخدم الحالي قراءة مورد النُسخ السابقة من الملفات في مساحة التخزين السحابي المشتركة هذه.
`capabilities.canRename`	`boolean` الإخراج فقط. ما إذا كان بإمكان المستخدم الحالي إعادة تسمية الملفات أو المجلدات في مساحة التخزين السحابي المشتركة هذه.
`capabilities.canRenameDrive`	`boolean` الإخراج فقط. ما إذا كان بإمكان المستخدم الحالي إعادة تسمية مساحة التخزين السحابي المشتركة هذه.
`capabilities.canChangeDriveBackground`	`boolean` الإخراج فقط. ما إذا كان بإمكان المستخدم الحالي تغيير خلفية مساحة التخزين السحابي المشتركة هذه.
`capabilities.canShare`	`boolean` الإخراج فقط. ما إذا كان بإمكان المستخدم الحالي مشاركة الملفات أو المجلدات في مساحة التخزين السحابي المشتركة هذه.
`capabilities.canChangeCopyRequiresWriterPermissionRestriction`	`boolean` الإخراج فقط. ما إذا كان بإمكان المستخدم الحالي تغيير قيود `copyRequiresWriterPermission` لمساحة التخزين السحابي المشتركة هذه.
`capabilities.canChangeDomainUsersOnlyRestriction`	`boolean` الإخراج فقط. ما إذا كان بإمكان المستخدم الحالي تغيير قيود `domainUsersOnly` لمساحة التخزين السحابي المشتركة هذه.
`capabilities.canChangeDriveMembersOnlyRestriction`	`boolean` الإخراج فقط. ما إذا كان بإمكان المستخدم الحالي تغيير قيود `driveMembersOnly` لمساحة التخزين السحابي المشتركة هذه.
`capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction`	`boolean` الإخراج فقط. ما إذا كان بإمكان المستخدم الحالي تغيير قيود `sharingFoldersRequiresOrganizerPermission` لمساحة التخزين السحابي المشتركة هذه.
`capabilities.canResetDriveRestrictions`	`boolean` الإخراج فقط. يمكنك اختيار ما إذا كان بإمكان المستخدم الحالي إعادة ضبط قيود مساحة التخزين السحابي المشتركة على الإعدادات التلقائية.
`capabilities.canDeleteChildren`	`boolean` الإخراج فقط. ما إذا كان بإمكان المستخدم الحالي حذف الأطفال من المجلدات في مساحة التخزين السحابي المشتركة هذه.
`capabilities.canTrashChildren`	`boolean` الإخراج فقط. ما إذا كان المستخدم الحالي يمكنه نقل الأطفال إلى المجلدات من مساحة التخزين السحابي المشتركة هذه
`themeId`	`string` رقم تعريف المظهر الذي سيتم ضبط صورة الخلفية ولونها منه. يمكن استرداد مجموعة `driveThemes` المحتملة من استجابة `drive.about.get`. في حال عدم تحديد هذا الخيار في طلب `drive.drives.create`، يتم اختيار مظهر عشوائي يتم من خلاله ضبط صورة الخلفية ولونها. هذا حقل للقراءة فقط، ويمكن ضبطه فقط في الطلبات التي لا تضبط `colorRgb` أو `backgroundImageFile`.
`backgroundImageFile`	`object` ملف صورة ومعلمات اقتصاص يتم ضبط صورة خلفية منها لمساحة التخزين السحابي المشتركة هذه هذا حقل للكتابة فقط، ولا يمكن ضبطه إلا على طلبات `drive.drives.update` التي لا تضبط `themeId`. يجب ضبط جميع حقول `backgroundImageFile`، عند تحديدها.
`backgroundImageFile.id`	`string` رقم تعريف ملف الصورة في Google Drive لاستخدامه مع صورة الخلفية.
`backgroundImageFile.xCoordinate`	`number` الإحداثيات X في أعلى يمين منطقة الاقتصاص في صورة الخلفية. هذه قيمة في نطاق مغلق من 0 إلى 1. وتمثّل هذه القيمة المسافة الأفقية من الجانب الأيسر للصورة بأكملها إلى الجانب الأيسر من منطقة الاقتصاص مقسومة على عرض الصورة بالكامل.
`backgroundImageFile.yCoordinate`	`number` التنسيق Y للزاوية العليا اليسرى لمنطقة الاقتصاص في صورة الخلفية. هذه قيمة في نطاق مغلق من 0 إلى 1. تمثل هذه القيمة المسافة الرأسية من الجانب العلوي للصورة بأكملها إلى الجانب العلوي لمنطقة الاقتصاص مقسومًا على ارتفاع الصورة بالكامل.
`backgroundImageFile.width`	`number` عرض الصورة التي تم اقتصاصها ضِمن النطاق المغلق من 0 إلى 1. تمثل هذه القيمة عرض الصورة التي تم اقتصاصها مقسومة على عرض الصورة بالكامل. يتم احتساب الارتفاع عن طريق تطبيق نسبة عرض إلى ارتفاع من 80 إلى 9. يجب ألا يقل عرض الصورة الناتجة عن 1280 بكسل وارتفاع 144 بكسل.
`createdTime`	`string` الإخراج فقط. الوقت الذي تم فيه إنشاء مساحة التخزين السحابي المشتركة (التاريخ والوقت RFC 3339).
`hidden`	`boolean` ما إذا كانت مساحة التخزين السحابي المشتركة مخفية عن العرض التلقائي أم لا.
`restrictions`	`object` مجموعة من القيود التي تنطبق على مساحة التخزين السحابي المشتركة هذه أو العناصر داخلها.
`restrictions.copyRequiresWriterPermission`	`boolean` يجب إيقاف خيارات نسخ الملفات أو طباعتها أو تنزيلها داخل مساحة التخزين السحابي المشتركة هذه للقرّاء والمعلِّقين. عند ضبط هذا القيد على `true`، سيؤدي ذلك إلى إلغاء الحقل المُسمّى المماثل إلى `true` لأي ملف داخل مساحة التخزين السحابي المشتركة هذه.
`restrictions.domainUsersOnly`	`boolean` ما إذا كان الوصول إلى مساحة التخزين السحابي المشتركة هذه والعناصر داخلها تقتصر على مستخدمي النطاق الذي تنتمي إليه مساحة التخزين السحابي المشتركة هذه. قد يتم إلغاء هذا القيد عن طريق سياسات مشاركة أخرى يتم التحكّم فيها خارج مساحة التخزين السحابي المشتركة هذه.
`restrictions.driveMembersOnly`	`boolean` ما إذا كان الوصول إلى العناصر داخل مساحة التخزين السحابي المشتركة هذه مقصورًا على الأعضاء.
`restrictions.adminManagedRestrictions`	`boolean` ما إذا كانت الامتيازات الإدارية مطلوبة في مساحة التخزين السحابي المشتركة هذه لتعديل القيود
`restrictions.sharingFoldersRequiresOrganizerPermission`	`boolean` إذا كانت السياسة صحيحة، لا يمكن إلا للمستخدمين الذين لديهم دور المنظِّم مشاركة المجلدات. إذا كانت السياسة غير صحيحة، يمكن للمستخدمين الذين لديهم دور المنظِّم أو دور منظِّم الملفات مشاركة المجلدات.
`orgUnitId`	`string` الإخراج فقط. الوحدة التنظيمية لمساحة التخزين السحابي المشتركة هذه. وتتم تعبئة هذا الحقل فقط في الردود على `drives.list` عندما يتم ضبط المعلمة `useDomainAdminAccess` على `true`.

الطُرق
`create`	إنشاء مساحة تخزين سحابي مشتركة
`delete`	يحذف نهائيًا مساحة التخزين السحابي المشتركة التي يكون المستخدم `organizer` فيها.
`get`	يحصل على البيانات الوصفية لمساحة التخزين السحابي المشتركة حسب رقم التعريف.
`hide`	لإخفاء مساحة تخزين سحابي مشتركة من طريقة العرض التلقائية
`list`	يتم إدراج مساحات التخزين السحابي المشتركة للمستخدم.
`unhide`	استعادة مساحة تخزين سحابي مشتركة إلى طريقة العرض التلقائية
`update`	يعدّل التاريخ الوصفية لمساحة تخزين سحابي مشتركة.

REST Resource: drives

المورد: Drive

الطُرق

`create`

`delete`

`get`

`hide`

`list`

`unhide`

`update`