REST Resource: files

משאב: File
- ייצוג ב-JSON
  - ייצוג ב-JSON
- ContentRestriction
  - ייצוג ב-JSON
Methods

משאב: קובץ

המטא-נתונים של קובץ.

חלק מהשיטות של משאבים (כמו files.update) דורשות fileId. משתמשים בשיטה files.list כדי לאחזר את המזהה של קובץ.

ייצוג ב-JSON

ייצוג ב-JSON
{ "ownerNames": [ string ], "exportLinks": { string: string, ... }, "parents": [ { object (`ParentReference`) } ], "owners": [ { object (`User`) } ], "openWithLinks": { string: string, ... }, "properties": [ { object (`Property`) } ], "permissions": [ { object (`Permission`) } ], "spaces": [ string ], "permissionIds": [ string ], "contentRestrictions": [ { object (`ContentRestriction`) } ], "kind": string, "userPermission": { object (`Permission`) }, "fileExtension": string, "md5Checksum": string, "selfLink": string, "lastModifyingUserName": string, "editable": boolean, "writersCanShare": boolean, "downloadUrl": string, "mimeType": string, "driveId": string, "thumbnailLink": string, "appDataContents": boolean, "webViewLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "defaultOpenWithLink": string, "headRevisionId": string, "copyable": boolean, "etag": string, "sharingUser": { object (`User`) }, "alternateLink": string, "embedLink": string, "webContentLink": string, "fileSize": string, "copyRequiresWriterPermission": boolean, "hasThumbnail": boolean, "folderColorRgb": string, "id": string, "title": string, "description": string, "labels": { "viewed": boolean, "restricted": boolean, "starred": boolean, "hidden": boolean, "trashed": boolean, "modified": boolean }, "explicitlyTrashed": boolean, "createdDate": string, "modifiedDate": string, "modifiedByMeDate": string, "lastViewedByMeDate": string, "markedViewedByMeDate": string, "sharedWithMeDate": string, "quotaBytesUsed": string, "version": string, "indexableText": { "text": string }, "originalFilename": string, "ownedByMe": boolean, "canComment": boolean, "shareable": boolean, "fullFileExtension": string, "isAppAuthorized": boolean, "teamDriveId": string, "capabilities": { "canChangeRestrictedDownload": boolean, "canMoveChildrenOutOfDrive": boolean, "canReadDrive": boolean, "canEdit": boolean, "canCopy": boolean, "canComment": boolean, "canAddChildren": boolean, "canDelete": boolean, "canDownload": boolean, "canListChildren": boolean, "canRemoveChildren": boolean, "canRename": boolean, "canTrash": boolean, "canReadRevisions": boolean, "canReadTeamDrive": boolean, "canMoveTeamDriveItem": boolean, "canChangeCopyRequiresWriterPermission": boolean, "canMoveItemIntoTeamDrive": boolean, "canUntrash": boolean, "canModifyContent": boolean, "canMoveItemWithinTeamDrive": boolean, "canMoveItemOutOfTeamDrive": boolean, "canDeleteChildren": boolean, "canMoveChildrenOutOfTeamDrive": boolean, "canMoveChildrenWithinTeamDrive": boolean, "canTrashChildren": boolean, "canMoveItemOutOfDrive": boolean, "canAddMyDriveParent": boolean, "canRemoveMyDriveParent": boolean, "canMoveItemWithinDrive": boolean, "canShare": boolean, "canMoveChildrenWithinDrive": boolean, "canModifyContentRestriction": boolean, "canAddFolderFromAnotherDrive": boolean, "canChangeSecurityUpdateEnabled": boolean, "canAcceptOwnership": boolean, "canReadLabels": boolean, "canModifyLabels": boolean, "canModifyEditorContentRestriction": boolean, "canModifyOwnerContentRestriction": boolean, "canRemoveContentRestriction": boolean, "canDisableInheritedPermissions": boolean, "canEnableInheritedPermissions": boolean }, "hasAugmentedPermissions": boolean, "trashingUser": { object (`User`) }, "canReadRevisions": boolean, "thumbnailVersion": string, "trashedDate": string, "thumbnail": { "image": string, "mimeType": string }, "imageMediaMetadata": { "flashUsed": boolean, "meteringMode": string, "sensor": string, "exposureMode": string, "colorSpace": string, "whiteBalance": string, "width": integer, "height": integer, "location": { "latitude": number, "longitude": number, "altitude": number }, "rotation": integer, "date": string, "cameraMake": string, "cameraModel": string, "exposureTime": number, "aperture": number, "focalLength": number, "isoSpeed": integer, "exposureBias": number, "maxApertureValue": number, "subjectDistance": integer, "lens": string }, "videoMediaMetadata": { "width": integer, "height": integer, "durationMillis": string }, "shortcutDetails": { "targetId": string, "targetMimeType": string, "targetResourceKey": string }, "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean }, "labelInfo": { "labels": [ { object (`Label`) } ] }, "sha1Checksum": string, "sha256Checksum": string, "inheritedPermissionsDisabled": boolean }

{
  "ownerNames": [
    string
  ],
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "properties": [
    {
      object (Property)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "driveId": string,
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "hasThumbnail": boolean,
  "folderColorRgb": string,
  "id": string,
  "title": string,
  "description": string,
  "labels": {
    "viewed": boolean,
    "restricted": boolean,
    "starred": boolean,
    "hidden": boolean,
    "trashed": boolean,
    "modified": boolean
  },
  "explicitlyTrashed": boolean,
  "createdDate": string,
  "modifiedDate": string,
  "modifiedByMeDate": string,
  "lastViewedByMeDate": string,
  "markedViewedByMeDate": string,
  "sharedWithMeDate": string,
  "quotaBytesUsed": string,
  "version": string,
  "indexableText": {
    "text": string
  },
  "originalFilename": string,
  "ownedByMe": boolean,
  "canComment": boolean,
  "shareable": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeRestrictedDownload": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": string,
  "thumbnail": {
    "image": string,
    "mimeType": string
  },
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "date": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}

שדות
`ownerNames[]`	`string` פלט בלבד. השם או השמות של הבעלים של הקובץ הזה. לא מאוכלס עבור פריטים באחסון שיתופי.
`exportLinks`	`map (key: string, value: string)` פלט בלבד. קישורים לייצוא קבצים בכלי העריכה של Docs לפורמטים ספציפיים. אובייקט שמכיל רשימה של `"key": value` זוגות. לדוגמה: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`parents[]`	`object (ParentReference)` המזהה של תיקיית ההורה שמכילה את הקובץ. לקובץ יכולה להיות רק תיקיית הורה אחת. אי אפשר לציין כמה תיקיות הורה. אם לא מציינים את המיקום כחלק מבקשת הוספה, הקובץ ממוקם ישירות בתיקייה 'האחסון שלי' של המשתמש. אם לא מציינים את ההורה כחלק מבקשת העתקה, הקובץ יורש את כל ההורה שאפשר לגלות של קובץ המקור. בבקשות files.update צריך להשתמש בפרמטרים `addParents` ו-`removeParents` כדי לשנות את רשימת ההורים.
`owners[]`	`object (User)` פלט בלבד. הבעלים של הקובץ. יכול להיות שלקובצי Legacy מסוימים יהיו יותר מבעלים אחד. השדה הזה לא מאוכלס עבור פריטים באחסון שיתופי.
`openWithLinks`	`map (key: string, value: string)` פלט בלבד. מיפוי של המזהה של כל אחת מהאפליקציות של המשתמש לקישור לפתיחת הקובץ הזה באמצעות האפליקציה. המיפוי מתבצע רק כשמשתמשים בהיקף drive.apps.readonly. אובייקט שמכיל רשימה של `"key": value` זוגות. לדוגמה: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`properties[]`	`object (Property)` רשימת הנכסים.
`permissions[]`	`object (Permission)` פלט בלבד. רשימת ההרשאות של משתמשים שיש להם גישה לקובץ הזה. לא מאוכלס עבור פריטים באחסון שיתופי.
`spaces[]`	`string` פלט בלבד. רשימת המרחבים שבהם הקובץ נמצא. הערכים הנתמכים הם `drive`, ‏ `appDataFolder` ו-`photos`.
`permissionIds[]`	`string` פלט בלבד. files.list של מזהי הרשאות למשתמשים עם גישה לקובץ הזה.
`contentRestrictions[]`	`object (ContentRestriction)` הגבלות על הגישה לתוכן הקובץ. השדה יאוכלס רק אם קיימת הגבלה כזו.
`kind`	`string` פלט בלבד. סוג הקובץ. הערך הזה תמיד יהיה `drive#file`.
`userPermission`	`object (Permission)` פלט בלבד. ההרשאות של המשתמש המאומת בקובץ הזה.
`fileExtension`	`string` פלט בלבד. הרכיב האחרון של `fullFileExtension` עם טקסט בסוף שלא נראה כחלק מהתוסף הוסר. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קבצים של כלי העריכה של Docs או קובצי קיצור דרך.
`md5Checksum`	`string` פלט בלבד. סכום ביקורת MD5 של תוכן הקובץ. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קבצים של כלי העריכה של Docs או קובצי קיצור דרך.
`selfLink`	`string` פלט בלבד. קישור חזרה לקובץ הזה.
`lastModifyingUserName`	`string` פלט בלבד. שם המשתמש האחרון שערך את הקובץ.
`editable (deprecated)`	`boolean` הפריט הזה יצא משימוש. פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`capabilities/canEdit`.
`writersCanShare`	`boolean` האם הכותבים יכולים לשתף את המסמך עם משתמשים אחרים. לא מאוכלס עבור פריטים באחסון שיתופי.
`downloadUrl`	`string` פלט בלבד. כתובת אתר להורדה של הקובץ שתהיה זמינה לזמן קצר. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קובצי קיצור דרך או קובצי Google Docs.
`mimeType`	`string` סוג ה-MIME של הקובץ. אפשר לשנות את הערך הזה רק כשמעלים תוכן חדש. אפשר להשאיר את השדה הזה ריק, וסוג ה-MIME ייקבע לפי סוג ה-MIME של התוכן שהועלה.
`driveId`	`string` פלט בלבד. מזהה האחסון השיתופי שבו נמצא הקובץ. השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.
`thumbnailLink`	`string` פלט בלבד. קישור לזמן קצר לתמונה הממוזערת של הקובץ, אם יש כזה. בדרך כלל נמשך כמה שעות. לא מיועד לשימוש ישיר באפליקציות אינטרנט בגלל שיתוף משאבים בין מקורות (CORS), כדאי להשתמש בשרת proxy. השדה הזה מאוכלס רק כשאפליקציית הבקשה יכולה לגשת לתוכן הקובץ. אם הקובץ לא משותף באופן ציבורי, צריך לאחזר את כתובת ה-URL שמוחזרת ב-`Files.thumbnailLink` באמצעות בקשה עם אישורים.
`appDataContents`	`boolean` פלט בלבד. האם הקובץ הזה נמצא בתיקייה Application Data.
`webViewLink`	`string` פלט בלבד. קישור שזמין רק בתיקיות ציבוריות לצפייה בנכסי האינטרנט הסטטיים שלהן (HTML,‏ CSS,‏ JS וכו') דרך אירוח אתרים ב-Google Drive.
`iconLink`	`string` פלט בלבד. קישור לסמל הקובץ.
`shared`	`boolean` פלט בלבד. האם הקובץ שותף. לא מאוכלס עבור פריטים באחסון שיתופי.
`lastModifyingUser`	`object (User)` פלט בלבד. המשתמש האחרון ששינה את הקובץ. השדה הזה מאוכלס רק כשהשינוי האחרון בוצע על ידי משתמש מחובר.
`defaultOpenWithLink`	`string` פלט בלבד. קישור לפתיחת הקובץ באפליקציית ברירת המחדל של המשתמש לקובץ הזה. השדה הזה מאוכלס רק כשמשתמשים בהיקף drive.apps.readonly.
`headRevisionId`	`string` פלט בלבד. המזהה של הגרסה העדכנית של הקובץ. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קבצים של כלי העריכה של Docs או קובצי קיצור דרך.
`copyable (deprecated)`	`boolean` הפריט הזה יצא משימוש. פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`capabilities/canCopy`.
`etag`	`string` פלט בלבד. תג ה-ETag של הקובץ.
`sharingUser`	`object (User)` פלט בלבד. המשתמש ששיתף את הפריט עם המשתמש הנוכחי, אם זמין.
`alternateLink`	`string` פלט בלבד. קישור לפתיחת הקובץ בכלי רלוונטי של Google לעריכה או לצפייה.
`embedLink`	`string` פלט בלבד. קישור להטמעת הקובץ.
`webContentLink`	`string` פלט בלבד. קישור להורדת התוכן של הקובץ בדפדפן באמצעות אימות שמבוסס על קובצי Cookie. במקרים שבהם התוכן משותף באופן גלוי לכולם, אפשר להוריד אותו בלי פרטי כניסה.
`fileSize`	`string (int64 format)` פלט בלבד. הגודל בבייטים של אובייקטים בינאריים גדולים וקבצים של עורך מהדומיין הנוכחי. השדה הזה לא יאוכלס עבור קבצים שאין להם גודל, כמו קיצורי דרך ותיקיות.
`copyRequiresWriterPermission`	`boolean` האם האפשרויות להעתקה, להדפסה או להורדה של הקובץ הזה צריכות להיות מושבתות עבור בעלי הרשאת קריאה והרשאת תגובה.
`hasThumbnail`	`boolean` פלט בלבד. האם יש לקובץ הזה תמונה ממוזערת. ההודעה הזו לא מציינת אם לאפליקציה ששלחה את הבקשה יש גישה לתמונה הממוזערת. כדי לבדוק את הגישה, מחפשים את השדה thumbnailLink.
`folderColorRgb`	`string` צבע התיקייה כמחרוזת הקסדצימלית של RGB אם הקובץ הוא תיקייה או קיצור דרך לתיקייה. רשימת הצבעים הנתמכים זמינה בשדה folderColorPalette של משאב About. אם מציינים צבע שלא נתמך, הוא ישתנה לצבע הכי קרוב בפלטה.
`id`	`string` המזהה של הקובץ.
`title`	`string` השם של הקובץ הזה. שימו לב שהשם של פריטים שלא ניתן לשנות, כמו תיקיות ברמה העליונה של אחסון שיתופי, תיקיית הבסיס ב'האחסון שלי' ותיקיית נתוני האפליקציה, הוא קבוע.
`description`	`string` תיאור קצר של הקובץ.
`labels`	`object` קבוצת תוויות לקובץ.
`labels.viewed`	`boolean` האם המשתמש צפה בקובץ הזה.
`labels.restricted (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`copyRequiresWriterPermission`.
`labels.starred`	`boolean` האם המשתמש סימן את הקובץ בכוכב.
`labels.hidden (deprecated)`	`boolean` פלט בלבד. הוצא משימוש.
`labels.trashed`	`boolean` האם הקובץ הזה הועבר לאשפה. התווית הזו חלה על כל המשתמשים שיש להם גישה לקובץ, אבל רק הבעלים יכולים לראות את הקבצים ולבטל את ההעברה שלהם לאשפה.
`labels.modified`	`boolean` פלט בלבד. האם המשתמש שינה את הקובץ.
`explicitlyTrashed`	`boolean` פלט בלבד. האם הקובץ הזה הועבר לאשפה באופן מפורש, בניגוד להעברה לאשפה באופן רקורסיבי.
`createdDate`	`string` פלט בלבד. זמן היצירה של הקובץ הזה (חותמת זמן בפורמט RFC 3339).
`modifiedDate`	`string` התאריך האחרון שבו מישהו שינה את הקובץ (חותמת זמן בפורמט RFC 3339). אפשר לשנות את הערך הזה רק בעדכון, כשהפרמטר setModifiedDate מוגדר.
`modifiedByMeDate`	`string` פלט בלבד. הפעם האחרונה שבה המשתמש שינה את הקובץ (חותמת זמן בפורמט RFC 3339). שימו לב: הגדרת modifiedDate תעדכן גם את התאריך modifiedByMe של המשתמש שהגדיר את התאריך.
`lastViewedByMeDate`	`string` הפעם האחרונה שהמשתמש צפה בקובץ הזה (חותמת זמן בפורמט RFC 3339).
`markedViewedByMeDate (deprecated)`	`string` הפריט הזה יצא משימוש. פלט בלבד. הוצא משימוש.
`sharedWithMeDate`	`string` פלט בלבד. השעה שבה הקובץ הזה שותף עם המשתמש (חותמת זמן בפורמט RFC 3339).
`quotaBytesUsed`	`string (int64 format)` פלט בלבד. מספר הבייטים של המכסה שנעשה בהם שימוש בקובץ הזה.
`version`	`string (int64 format)` פלט בלבד. מספר גרסה שגדל באופן מונוטוני של הקובץ. השינוי הזה משקף כל שינוי שבוצע בקובץ בשרת, גם אם הוא לא גלוי למשתמש ששלח את הבקשה.
`indexableText`	`object` מאפייני טקסט שאפשר להוסיף לאינדקס בקובץ (אפשר רק לכתוב)
`indexableText.text`	`string` הטקסט שיתווסף לאינדקס עבור הקובץ הזה.
`originalFilename`	`string` שם הקובץ המקורי של התוכן שהועלה, אם הוא זמין, או הערך המקורי של השדה `title`. האפשרות הזו זמינה רק לקבצים עם תוכן בינארי ב-Google Drive.
`ownedByMe`	`boolean` פלט בלבד. האם הקובץ בבעלות המשתמש הנוכחי. לא מאוכלס עבור פריטים באחסון שיתופי.
`canComment (deprecated)`	`boolean` הפריט הזה יצא משימוש. פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`capabilities/canComment`.
`shareable (deprecated)`	`boolean` הפריט הזה יצא משימוש. פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`capabilities/canShare`.
`fullFileExtension`	`string` פלט בלבד. סיומת הקובץ המלאה, שחולצה מהשם. יכול להכיל כמה סיומות מחוברות, כמו tar.gz. הסרת סיומת מהשם לא מוחקת את השדה הזה, אבל שינוי הסיומת בשם כן מעדכן את השדה הזה. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קבצים של כלי העריכה של Docs או קובצי קיצור דרך.
`isAppAuthorized`	`boolean` פלט בלבד. האם הקובץ נוצר או נפתח על ידי האפליקציה ששלחה את הבקשה.
`teamDriveId (deprecated)`	`string` הפריט הזה יצא משימוש. פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`driveId`.
`capabilities`	`object` פלט בלבד. היכולות שיש למשתמש הנוכחי בקובץ הזה. כל יכולת מתאימה לפעולה מדויקת שהמשתמש יכול לבצע.
`capabilities.canChangeRestrictedDownload (deprecated)`	`boolean` פלט בלבד. הוצא משימוש.
`capabilities.canMoveChildrenOutOfDrive`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להעביר פריטי צאצא של התיקייה הזו מחוץ לאחסון השיתופי. הערך הוא false אם הפריט הוא לא תיקייה. השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.
`capabilities.canReadDrive`	`boolean` פלט בלבד. האם למשתמש הנוכחי יש הרשאת קריאה באחסון השיתופי שאליו הקובץ הזה שייך. השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.
`capabilities.canEdit`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול לערוך את הקובץ הזה. יש גורמים אחרים שיכולים להגביל את סוג השינויים שמשתמש יכול לבצע בקובץ. לדוגמה, ראו `canChangeCopyRequiresWriterPermission` או `canModifyContent`.
`capabilities.canCopy`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להעתיק את הקובץ הזה. אם מדובר בפריט באחסון שיתופי, האם המשתמש הנוכחי יכול להעתיק צאצאים של הפריט הזה שהם לא תיקיות, או את הפריט עצמו אם הוא לא תיקייה.
`capabilities.canComment`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להגיב על הקובץ הזה.
`capabilities.canAddChildren`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להוסיף תיקיות צאצא לתיקייה הזו. הערך שיוחזר במאפיין הזה תמיד יהיה false אם הפריט הוא לא תיקייה.
`capabilities.canDelete`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול למחוק את הקובץ הזה.
`capabilities.canDownload`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להוריד את הקובץ הזה.
`capabilities.canListChildren`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להציג את תיקיות המשנה של התיקייה הזו. הערך שיוחזר במאפיין הזה תמיד יהיה false אם הפריט הוא לא תיקייה.
`capabilities.canRemoveChildren`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להסיר תיקיות צאצא מהתיקייה הזו. הערך שיוחזר במאפיין הזה תמיד יהיה false אם הפריט הוא לא תיקייה. במקרה של תיקייה באחסון שיתופי, משתמשים במקום זאת ב-`canDeleteChildren` או ב-`canTrashChildren`.
`capabilities.canRename`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול לשנות את השם של הקובץ הזה.
`capabilities.canTrash`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להעביר את הקובץ הזה לאשפה.
`capabilities.canReadRevisions`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול לקרוא את משאב הגרסאות של הקובץ הזה. לפריט באחסון שיתופי, האם אפשר לקרוא את הגרסאות של צאצאים שאינם תיקיות של הפריט הזה, או את הפריט עצמו אם הוא לא תיקייה.
`capabilities.canReadTeamDrive (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`canReadDrive`.
`capabilities.canMoveTeamDriveItem (deprecated)`	`boolean` פלט בלבד. הוצאה משימוש: במקומה יש להשתמש ב-`canMoveItemWithinDrive` או ב-`canMoveItemOutOfDrive`.
`capabilities.canChangeCopyRequiresWriterPermission`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול לשנות את ההגבלה של הקובץ הזה ב-`copyRequiresWriterPermission`.
`capabilities.canMoveItemIntoTeamDrive (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`canMoveItemOutOfDrive`.
`capabilities.canUntrash`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול לשחזר את הקובץ הזה מהאשפה.
`capabilities.canModifyContent`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול לשנות את התוכן של הקובץ הזה.
`capabilities.canMoveItemWithinTeamDrive (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`canMoveItemWithinDrive`.
`capabilities.canMoveItemOutOfTeamDrive (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`canMoveItemOutOfDrive`.
`capabilities.canDeleteChildren`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול למחוק תיקיות משנה של התיקייה הזו. הערך הוא false אם הפריט הוא לא תיקייה. השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.
`capabilities.canMoveChildrenOutOfTeamDrive (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`canMoveChildrenOutOfDrive`.
`capabilities.canMoveChildrenWithinTeamDrive (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`canMoveChildrenWithinDrive`.
`capabilities.canTrashChildren`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להעביר לאשפה את הפריטים שמוכלים בתיקייה הזו. הערך הוא false אם הפריט הוא לא תיקייה. השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.
`capabilities.canMoveItemOutOfDrive`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להעביר את הפריט הזה מחוץ לכונן הזה על ידי שינוי ההורה שלו. שימו לב: יכול להיות שבקשה לשינוי החשבון הראשי של הפריט תידחה, בהתאם לחשבון הראשי החדש שמתווסף.
`capabilities.canAddMyDriveParent`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להוסיף הורה לפריט בלי להסיר הורה קיים באותה בקשה. לא מאוכלס עבור קבצים באחסון שיתופי.
`capabilities.canRemoveMyDriveParent`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להסיר הורה מהפריט בלי להוסיף הורה אחר באותה בקשה. לא מאוכלס עבור קבצים באחסון שיתופי.
`capabilities.canMoveItemWithinDrive`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להעביר את הפריט הזה בתוך ה-Drive הזה. שימו לב: יכול להיות שהבקשה לשינוי ההורה של הפריט תיכשל בכל זאת, בהתאם להורה החדש שמוסיפים ולהורה שמסירים.
`capabilities.canShare`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול לשנות את הגדרות השיתוף של הקובץ הזה.
`capabilities.canMoveChildrenWithinDrive`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להעביר פריטים בתיקייה הזו ב-Drive. הערך הוא false אם הפריט הוא לא תיקייה. שימו לב: יכול להיות שבקשה להעברת הילד עדיין תיכשל, בהתאם לגישה של המשתמש הנוכחי לילד ולתיקיית היעד.
`capabilities.canModifyContentRestriction (deprecated)`	`boolean` הוצא משימוש: פלט בלבד. משתמשים באחת מהאפשרויות: `canModifyEditorContentRestriction`, `canModifyOwnerContentRestriction` או `canRemoveContentRestriction`.
`capabilities.canAddFolderFromAnotherDrive`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להוסיף תיקייה מ-Drive אחר (אחסון שיתופי אחר או 'האחסון שלי') לתיקייה הזו. הערך הוא false אם הפריט הוא לא תיקייה. השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.
`capabilities.canChangeSecurityUpdateEnabled`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול לשנות את השדה securityUpdateEnabled במטא-נתונים של שיתוף הקישור.
`capabilities.canAcceptOwnership`	`boolean` פלט בלבד. האם המשתמש הנוכחי הוא בהמתנה לאישור הבעלות של הקובץ. לא מאוכלס עבור קבצים באחסון שיתופי.
`capabilities.canReadLabels`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול לקרוא את התוויות בקובץ.
`capabilities.canModifyLabels`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול לשנות את התוויות בקובץ.
`capabilities.canModifyEditorContentRestriction`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להוסיף או לשנות הגבלות על התוכן בקובץ, שהן הגבלות לעורכים.
`capabilities.canModifyOwnerContentRestriction`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להוסיף או לשנות הגבלות תוכן שמוגבלות לבעלים.
`capabilities.canRemoveContentRestriction`	`boolean` פלט בלבד. האם יש הגבלת תוכן בקובץ שהמשתמש הנוכחי יכול להסיר.
`capabilities.canDisableInheritedPermissions`	`boolean` פלט בלבד. האם משתמש יכול להשבית הרשאות שעברו בירושה.
`capabilities.canEnableInheritedPermissions`	`boolean` פלט בלבד. האם משתמש יכול להפעיל מחדש הרשאות שעברו בירושה.
`hasAugmentedPermissions`	`boolean` פלט בלבד. האם יש הרשאות ישירות לקובץ הזה. השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.
`trashingUser`	`object (User)` פלט בלבד. אם הקובץ הועבר במפורש לאשפה, המשתמש שהעביר אותו לאשפה. השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.
`canReadRevisions (deprecated)`	`boolean` הפריט הזה יצא משימוש. פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`capabilities/canReadRevisions`.
`thumbnailVersion`	`string (int64 format)` פלט בלבד. גרסת התמונה הממוזערת לשימוש בביטול תוקף של מטמון התמונות הממוזערות.
`trashedDate`	`string` פלט בלבד. השעה שבה הפריט הועבר לאשפה (חותמת זמן בפורמט RFC 3339). השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.
`thumbnail`	`object` תמונה ממוזערת של הקובץ. התמונה הזו תשמש רק אם לא תהיה אפשרות ליצור תמונה ממוזערת רגילה.
`thumbnail.image`	`string (bytes format)` הבייטים של התמונה הממוזערת בקידוד Base64 בטוח לכתובות URL. היא צריכה להיות תואמת לתקן RFC 4648 סעיף 5. מחרוזת בקידוד Base64.
`thumbnail.mimeType`	`string` סוג ה-MIME של התמונה הממוזערת.
`imageMediaMetadata`	`object` פלט בלבד. מטא-נתונים על מדיית תמונות. המאפיין הזה יופיע רק עבור סוגי תמונות, והתוכן שלו יהיה תלוי במה שאפשר לנתח מתוכן התמונה.
`imageMediaMetadata.flashUsed`	`boolean` פלט בלבד. האם נעשה שימוש בפלאש כדי ליצור את התמונה.
`imageMediaMetadata.meteringMode`	`string` פלט בלבד. מצב המדידה ששימש ליצירת התמונה.
`imageMediaMetadata.sensor`	`string` פלט בלבד. סוג החיישן ששימש ליצירת התמונה.
`imageMediaMetadata.exposureMode`	`string` פלט בלבד. מצב החשיפה שבו צולמה התמונה.
`imageMediaMetadata.colorSpace`	`string` פלט בלבד. מרחב הצבעים של התמונה.
`imageMediaMetadata.whiteBalance`	`string` פלט בלבד. מצב איזון הלבן שבו השתמשו כדי ליצור את התמונה.
`imageMediaMetadata.width`	`integer` פלט בלבד. רוחב התמונה בפיקסלים.
`imageMediaMetadata.height`	`integer` פלט בלבד. גובה התמונה בפיקסלים.
`imageMediaMetadata.location`	`object` פלט בלבד. פרטי המיקום הגיאוגרפי שמאוחסנים בתמונה.
`imageMediaMetadata.location.latitude`	`number` פלט בלבד. קו הרוחב שמאוחסן בתמונה.
`imageMediaMetadata.location.longitude`	`number` פלט בלבד. קו האורך שמאוחסן בתמונה.
`imageMediaMetadata.location.altitude`	`number` פלט בלבד. הגובה מעל פני הים שמאוחסן בתמונה.
`imageMediaMetadata.rotation`	`integer` פלט בלבד. מספר הסיבובים ב-90 מעלות בכיוון השעון שבוצעו מהכיוון המקורי של התמונה.
`imageMediaMetadata.date`	`string` פלט בלבד. התאריך והשעה שבהם צולמה התמונה (חותמת זמן בפורמט EXIF).
`imageMediaMetadata.cameraMake`	`string` פלט בלבד. יצרן המצלמה שבה צולמה התמונה.
`imageMediaMetadata.cameraModel`	`string` פלט בלבד. דגם המצלמה שבה צולמה התמונה.
`imageMediaMetadata.exposureTime`	`number` פלט בלבד. משך החשיפה, בשניות.
`imageMediaMetadata.aperture`	`number` פלט בלבד. הצמצם ששימש ליצירת התמונה (מספר הצמצם).
`imageMediaMetadata.focalLength`	`number` פלט בלבד. אורך המוקד ששימש ליצירת התמונה, במילימטרים.
`imageMediaMetadata.isoSpeed`	`integer` פלט בלבד. מהירות ה-ISO ששימשה ליצירת התמונה.
`imageMediaMetadata.exposureBias`	`number` פלט בלבד. פיצוי החשיפה של התמונה (ערך APEX).
`imageMediaMetadata.maxApertureValue`	`number` פלט בלבד. מספר ה-f הקטן ביותר של העדשה באורך המוקד ששימש ליצירת התמונה (ערך APEX).
`imageMediaMetadata.subjectDistance`	`integer` פלט בלבד. המרחק מנושא הצילום, במטרים.
`imageMediaMetadata.lens`	`string` פלט בלבד. העדשה ששימשה ליצירת התמונה.
`videoMediaMetadata`	`object` פלט בלבד. מטא-נתונים על מדיה של סרטונים. האפשרות הזו תופיע רק בסוגי סרטונים.
`videoMediaMetadata.width`	`integer` פלט בלבד. רוחב הסרטון בפיקסלים.
`videoMediaMetadata.height`	`integer` פלט בלבד. הגובה של הסרטון בפיקסלים.
`videoMediaMetadata.durationMillis`	`string (int64 format)` פלט בלבד. משך הסרטון באלפיות השנייה.
`shortcutDetails`	`object` פרטי קובץ של קיצור דרך. השדה הזה מאוכלס רק בקבצים של קיצורי דרך, שבהם השדה mimeType מוגדר ל-`application/vnd.google-apps.shortcut`. אפשר להגדיר רק בבקשות `files.insert`.
`shortcutDetails.targetId`	`string` המזהה של הקובץ שקיצור הדרך מצביע עליו. אפשר להגדיר רק בבקשות `files.insert`.
`shortcutDetails.targetMimeType`	`string` פלט בלבד. סוג ה-MIME של הקובץ שאליו מפנה קיצור הדרך. הערך של השדה הזה הוא תמונת מצב של סוג ה-MIME של היעד, שצולמה כשהקיצור נוצר.
`shortcutDetails.targetResourceKey`	`string` פלט בלבד. מפתח המשאב של קובץ היעד.
`resourceKey`	`string` פלט בלבד. מפתח שנדרש כדי לגשת לפריט דרך קישור משותף.
`linkShareMetadata`	`object` פלט בלבד. פרטים שקשורים ל-LinkShare. המאפיין מכיל פרטים על כתובות ה-URL של הקישורים שבהם הלקוחות משתמשים כדי להפנות למוצר הזה.
`linkShareMetadata.securityUpdateEligible`	`boolean` פלט בלבד. האם הקובץ עומד בדרישות לעדכון אבטחה.
`linkShareMetadata.securityUpdateEnabled`	`boolean` פלט בלבד. האם עדכון האבטחה מופעל בקובץ הזה.
`labelInfo`	`object` פלט בלבד. סקירה כללית של התוויות בקובץ.
`labelInfo.labels[]`	`object (Label)` פלט בלבד. קבוצת התוויות בקובץ כפי שנדרש על ידי מזהי התוויות בפרמטר `includeLabels`. כברירת מחדל, לא מוחזרות תוויות.
`sha1Checksum`	`string` פלט בלבד. סכום הביקורת SHA1 שמשויך לקובץ הזה, אם הוא זמין. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קבצים של כלי העריכה של Docs או קובצי קיצור דרך.
`sha256Checksum`	`string` פלט בלבד. סכום הבדיקה SHA256 שמשויך לקובץ הזה, אם הוא זמין. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קבצים של כלי העריכה של Docs או קובצי קיצור דרך.
`inheritedPermissionsDisabled`	`boolean` האם ההרשאות שהקובץ קיבל בירושה מושבתות. ההרשאות שעוברות בירושה מופעלות כברירת מחדל.

ContentRestriction

הגבלה על הגישה לתוכן של הקובץ.

ייצוג ב-JSON
{ "readOnly": boolean, "reason": string, "type": string, "restrictingUser": { object (`User`) }, "restrictionDate": string, "ownerRestricted": boolean, "systemRestricted": boolean }

שדות
`readOnly`	`boolean` האם התוכן של הקובץ הוא לקריאה בלבד. אם קובץ הוא לקריאה בלבד, יכול להיות שלא תהיה אפשרות להוסיף גרסה חדשה של הקובץ, להוסיף או לשנות תגובות או לשנות את שם הקובץ.
`reason`	`string` הסיבה להגבלת התוכן בקובץ. אפשר לשנות את הערך הזה רק בבקשות שמוגדר בהן גם `readOnly=true`.
`type`	`string` פלט בלבד. סוג הגבלת התוכן. הערך האפשרי היחיד בשלב הזה הוא `globalContentRestriction`.
`restrictingUser`	`object (User)` פלט בלבד. המשתמש שהגדיר את הגבלת התוכן. המאפיין הזה מאוכלס רק אם `readOnly` הוא True.
`restrictionDate`	`string` פלט בלבד. השעה שבה הוגבלה הגישה לתוכן (חותמת זמן בפורמט RFC 3339). המאפיין הזה מאוכלס רק אם `readOnly` הוא True.
`ownerRestricted`	`boolean` האם רק משתמש שהוא הבעלים של הקובץ יכול לשנות או להסיר את הגבלת התוכן. בקבצים בתיקיות אחסון שיתופי, כל משתמש עם יכולות `organizer` יכול לשנות או להסיר את הגבלת התוכן הזו.
`systemRestricted`	`boolean` פלט בלבד. האם הגבלת התוכן הוחלה על ידי המערכת, למשל בגלל חתימה אלקטרונית. המשתמשים לא יכולים לשנות או להסיר הגבלות תוכן שמוגבלות על ידי המערכת.

Methods
`copy`	יוצרת עותק של הקובץ שצוין.
`delete`	מחיקה סופית של קובץ שבבעלות המשתמש בלי להעביר אותו לאשפה.
`emptyTrash`	מחיקה סופית של כל הקבצים של המשתמש שהועברו לאשפה.
`export`	מייצא מסמך Google Workspace לסוג ה-MIME המבוקש ומחזיר את תוכן הבייט המיוצא.
`generateIds`	מערכת Drive יוצרת קבוצה של מזהי קבצים שאפשר לציין בבקשות להוספה או להעתקה.
`get`	אחזור מטא-נתונים או תוכן של קובץ לפי מזהה.
`insert`	הוספה של קובץ חדש.
`list`	רשימת הקבצים של המשתמש.
`listLabels`	רשימת התוויות בקובץ.
`modifyLabels`	משנה את קבוצת התוויות שמוחלות על קובץ.
`patch`	עדכון המטא-נתונים או התוכן של קובץ.
`touch`	הגדרת זמן העדכון של הקובץ לזמן הנוכחי בשרת.
`trash`	העברת קובץ לאשפה.
`untrash`	שחזור קובץ מהאשפה.
`update`	עדכון של המטא-נתונים, התוכן או שניהם של קובץ.
`watch`	הרשמה לקבלת עדכונים על שינויים בקובץ.

REST Resource: files

משאב: קובץ

ContentRestriction

Methods

`copy`

`delete`

`emptyTrash`

`export`

`generateIds`

`get`

`insert`

`list`

`listLabels`

`modifyLabels`

`patch`

`touch`

`trash`

`untrash`

`update`

`watch`

REST Resource: files קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

משאב: קובץ

ContentRestriction

Methods

REST Resource: files