דף זה תורגם על ידי Cloud Translation API.

REST Resource: files

Resource: File
- ייצוג JSON
  - ייצוג JSON
- ContentRestriction
  - ייצוג JSON
שיטות

מקור מידע: קובץ

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

חלק מהשיטות של משאבים (כמו 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)` פלט בלבד. הבעלים של הקובץ. רק לקבצים מסוימים מדור קודם יכולים להיות יותר מבעלים אחד. השדה הזה לא מאוכלס עבור פריטים באחסון שיתופי.
`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 of permission IDs for users with access to this file.
`contentRestrictions[]`	`object (ContentRestriction)` הגבלות על הגישה לתוכן הקובץ. השדה יאוכלס רק אם קיימת הגבלה כזו.
`kind`	`string` פלט בלבד. סוג הקובץ. הנתיב הזה תמיד `drive#file`.
`userPermission`	`object (Permission)` פלט בלבד. ההרשאות של המשתמש המאומת בקובץ הזה.
`fileExtension`	`string` פלט בלבד. הרכיב האחרון של `fullFileExtension` עם טקסט בסוף שלא נראה כחלק מהתוסף הוסר. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קבצים של עורכי Google Docs או קבצי קיצור דרך.
`md5Checksum`	`string` פלט בלבד. סכום ביקורת MD5 של תוכן הקובץ. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קבצים של עורכי Google Docs או קבצי קיצור דרך.
`selfLink`	`string` פלט בלבד. קישור חזרה לקובץ הזה.
`lastModifyingUserName`	`string` פלט בלבד. שם המשתמש האחרון שערך את הקובץ.
`editable (deprecated)`	`boolean` הפריט הזה יצא משימוש. פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`capabilities/canEdit`.
`writersCanShare`	`boolean` האם משתמשים עם הרשאת כתיבה יכולים לשתף את המסמך עם משתמשים אחרים. לא מאוכלס עבור פריטים באחסון שיתופי.
`downloadUrl`	`string` פלט בלבד. כתובת URL להורדה של הקובץ שתוקפה מוגבל. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-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. הוא לא מאוכלס עבור קבצים של עורכי Google 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. הוא לא מאוכלס עבור קבצים של עורכי Google 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. הוא לא מאוכלס עבור קבצים של עורכי Google Docs או קבצי קיצור דרך.
`sha256Checksum`	`string` פלט בלבד. סכום הבדיקה של SHA256 שמשויך לקובץ הזה, אם הוא זמין. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קבצים של עורכי Google 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`	יוצרת קבוצה של מזהי קבצים שאפשר לספק בבקשות להוספה או להעתקה.
`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