REST Resource: drives

משאב: Drive

ייצוג של אחסון שיתופי.

ייצוג 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

קבוצה של הגבלות שחלות על האחסון השיתופי הזה או על פריטים שכלולים באחסון השיתופי הזה.
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

 מחיקה סופית של אחסון שיתופי שהמשתמש הוא המארגן שלו.

get

 קבלת מטא-נתונים של אחסון שיתופי לפי מזהה.

hide

 מסתיר אחסון שיתופי מתצוגת ברירת המחדל.

list

רשימה של תיקיות האחסון השיתופי של המשתמש.

unhide

 שחזור של אחסון שיתופי לתצוגת ברירת המחדל.

update

 מעדכנים את המטא-נתונים של אחסון שיתופי.