تمت ترجمة هذه الصفحة بواسطة 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` في حال اختيار القيمة "صحيح"، لا يمكن إلا للمستخدمين الذين لديهم دور المنظِّم مشاركة المجلدات. في حال اختيار القيمة "false"، يمكن للمستخدمين الذين لديهم دور المنظِّم أو دور منظِّم الملفات مشاركة المجلدات.
`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`