REST Resource: drives

المرجع: 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
}
الحقول
id

string

النتائج فقط. رقم تعريف مساحة التخزين السحابي المشتركة هذه، وهو أيضًا رقم تعريف مجلد المستوى الأعلى في مساحة التخزين السحابي المشتركة هذه.
name

string

اسم "مساحة التخزين السحابي المشتركة" هذه.
colorRgb

string

لون مساحة التخزين السحابي المشتركة هذه كسلسلة سداسية عشرية تستند إلى نموذج أحمر أخضر أزرق. ولا يمكن ضبطها إلا من خلال طلب drive.drives.update لا يؤدي إلى ضبط themeId.
kind

string

النتائج فقط. تحدد نوع هذا المورد. القيمة: السلسلة الثابتة "drive#drive".
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

 تعمل على تعديل التاريخ التعريفي لمساحة التخزين السحابي المشتركة.