تمت ترجمة هذه الصفحة بواسطة 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` لون مساحة التخزين السحابي المشتركة هذه كسلسلة سداسية عشرية باللون الأحمر والأخضر والأزرق ويمكن ضبط السياسة فقط على طلب `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` مجموعة من القيود التي تنطبق على مساحة التخزين السحابي المشتركة هذه أو العناصر داخل مساحة التخزين السحابي المشتركة هذه. يُرجى ملاحظة أنّه لا يمكن ضبط القيود عند إنشاء مساحة تخزين سحابي مشتركة. لإضافة قيود، عليك أولاً إنشاء مساحة تخزين سحابي مشتركة ثم استخدام `drives.update` لإضافة قيود.
`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`