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
  },
  "createdDate": 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.insert، يتم اختيار مظهر عشوائي يتم من خلاله ضبط صورة الخلفية ولونها. هذا حقل للكتابة فقط؛ لا يمكن ضبطها إلا على الطلبات التي لم يتم ضبط 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 بكسل.

createdDate

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.

الطُرق

delete

يؤدي هذا الإجراء إلى حذف مساحة التخزين السحابي المشتركة التي يكون المستخدم فيها organizer نهائيًا.

get

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

hide

يؤدي هذا الإجراء إلى إخفاء مساحة تخزين سحابي مشتركة من العرض التلقائي.

insert

إنشاء "مساحة تخزين سحابي مشتركة" جديدة

list

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

unhide

استعادة مساحة تخزين سحابي مشتركة إلى العرض التلقائي

update

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