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

لون مساحة التخزين السحابي المشتركة هذه بتنسيق سلسلة سداسية عشرية لنموذج RGB ولا يمكن ضبطه إلا في طلب 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

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