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,
    "canChangeDownloadRestriction": 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,
    "downloadRestriction": {
      object (DownloadRestriction)
    }
  },
  "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

النتائج فقط. تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي نقل العناصر الفرعية من المجلدات في مساحة التخزين السحابي المشتركة هذه إلى المهملات.
capabilities.canChangeDownloadRestriction

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، يمكن للمستخدمين الذين لديهم دور المنظِّم أو دور منظِّم الملفات مشاركة المجلدات.
restrictions.downloadRestriction

object (DownloadRestriction)

قيود التنزيل التي يفرضها مديرو مساحة التخزين السحابي المشتركة
orgUnitId

string

النتائج فقط. الوحدة التنظيمية لمساحة التخزين السحابي المشتركة هذه لا تتم تعبئة هذا الحقل في ردود drives.list إلا عندما يتم ضبط المَعلمة useDomainAdminAccess على true.

الطُرق

create

 تنشئ هذه الطريقة مساحة تخزين سحابي مشتركة.

delete

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

get

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

hide

 يخفي مساحة تخزين سحابي مشتركة من العرض التلقائي.

list

تعرض هذه السمة مساحات التخزين السحابي المشتركة الخاصة بالمستخدم.

unhide

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

update

 تعدِّل هذه الطريقة البيانات الوصفية لمساحة تخزين سحابي مشتركة.