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

REST Resource: files

משאב: קובץ
- ייצוג JSON
  - ייצוג ב-JSON
  - ייצוג ב-JSON
- ContentRestriction
  - ייצוג ב-JSON
שיטות

משאב: קובץ

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

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "kind": string, "driveId": string, "fileExtension": string, "copyRequiresWriterPermission": boolean, "md5Checksum": string, "contentHints": { "indexableText": string, "thumbnail": { "image": string, "mimeType": string } }, "writersCanShare": boolean, "viewedByMe": boolean, "mimeType": string, "exportLinks": { string: string, ... }, "parents": [ string ], "thumbnailLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "owners": [ { object (`User`) } ], "headRevisionId": string, "sharingUser": { object (`User`) }, "webViewLink": string, "webContentLink": string, "size": string, "viewersCanCopyContent": boolean, "permissions": [ { object (`Permission`) } ], "hasThumbnail": boolean, "spaces": [ string ], "folderColorRgb": string, "id": string, "name": string, "description": string, "starred": boolean, "trashed": boolean, "explicitlyTrashed": boolean, "createdTime": string, "modifiedTime": string, "modifiedByMeTime": string, "viewedByMeTime": string, "sharedWithMeTime": string, "quotaBytesUsed": string, "version": string, "originalFilename": string, "ownedByMe": boolean, "fullFileExtension": string, "properties": { string: value, ... }, "appProperties": { string: value, ... }, "isAppAuthorized": boolean, "teamDriveId": string, "capabilities": { "canChangeViewersCanCopyContent": 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`) }, "thumbnailVersion": string, "trashedTime": string, "modifiedByMe": boolean, "permissionIds": [ 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, "time": 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 }, "contentRestrictions": [ { object (`ContentRestriction`) } ], "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean }, "labelInfo": { "labels": [ { object (`Label`) } ] }, "sha1Checksum": string, "sha256Checksum": string, "inheritedPermissionsDisabled": boolean }

{
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "name": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "createdTime": string,
  "modifiedTime": string,
  "modifiedByMeTime": string,
  "viewedByMeTime": string,
  "sharedWithMeTime": string,
  "quotaBytesUsed": string,
  "version": string,
  "originalFilename": string,
  "ownedByMe": boolean,
  "fullFileExtension": string,
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": 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)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "permissionIds": [
    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,
    "time": 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
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}

שדות
`kind`	`string` פלט בלבד. מזהה את סוג המשאב. ערך: המחרוזת הקבועה `"drive#file"`.
`driveId`	`string` פלט בלבד. המזהה של האחסון השיתופי שבו נמצא הקובץ. השדה מאוכלס רק לגבי פריטים באחסון שיתופי.
`fileExtension`	`string` פלט בלבד. הרכיב האחרון של `fullFileExtension`. האפשרות הזו זמינה רק לקבצים עם תוכן בינארי ב-Google Drive.
`copyRequiresWriterPermission`	`boolean` האם להשבית את האפשרויות להעתקה, להדפסה או להורדה של הקובץ הזה עבור הקוראים והמגיבים.
`md5Checksum`	`string` פלט בלבד. סיכום הביקורת מסוג MD5 של תוכן הקובץ. האפשרות הזו רלוונטית רק לקבצים עם תוכן בינארי ב-Google Drive.
`contentHints`	`object` מידע נוסף על תוכן הקובץ. השדות האלה אף פעם לא מאוכלסים בתשובות.
`contentHints.indexableText`	`string` טקסט שרוצים להוסיף לאינדקס של הקובץ כדי לשפר שאילתות fullText. האורך של הקטע הזה מוגבל ל-128KB, והוא יכול להכיל רכיבי HTML.
`contentHints.thumbnail`	`object` תמונה ממוזערת של הקובץ. המערכת תשתמש בתמונה הזו רק אם Google Drive לא תוכל ליצור תמונה ממוזערת רגילה.
`contentHints.thumbnail.image`	`string (bytes format)` נתוני התמונה הממוזערת שמקודדים באמצעות Base64 ללא סיכון לכתובות URL (RFC 4648, סעיף 5). מחרוזת בקידוד Base64.
`contentHints.thumbnail.mimeType`	`string` סוג ה-MIME של התמונה הממוזערת.
`writersCanShare`	`boolean` אם משתמשים עם הרשאת `writer` בלבד יכולים לשנות את הרשאות הקובץ. לא מאוכלס בפריטים באחסון שיתופי.
`viewedByMe`	`boolean` פלט בלבד. האם המשתמש הזה צפה בקובץ.
`mimeType`	`string` סוג ה-MIME של הקובץ. אם לא מציינים ערך, מערכת Google Drive מנסה לזהות ערך מתאים מהתוכן שהועלו באופן אוטומטי. אי אפשר לשנות את הערך אלא אם מעלים גרסה חדשה. אם הקובץ נוצר עם סוג MIME של Google Docs, התוכן שיועלו ייובא, אם הדבר אפשרי. הפורמטים הנתמכים לייבוא מפורטים במאמר 'מידע על המשאב'.
`exportLinks`	`map (key: string, value: string)` פלט בלבד. קישורים לייצוא קבצים מ-Docs Editors לפורמטים ספציפיים. אובייקט שמכיל רשימה של זוגות `"key": value`. דוגמה: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`parents[]`	`string` המזהה של תיקיית ההורה שמכילה את הקובץ. לקובץ יכולה להיות רק תיקיית הורה אחת. לא ניתן לציין כמה הורים. אם לא צוין כחלק מבקשת יצירה, הקובץ יוצב ישירות בתיקייה 'האחסון שלי' של המשתמש. אם לא מציינים את ההורה כחלק מבקשת ההעתקה, הקובץ יורש כל הורה גלוי של קובץ המקור. בבקשות files.update צריך להשתמש בפרמטרים `addParents` ו-`removeParents` כדי לשנות את רשימת ההורים.
`thumbnailLink`	`string` פלט בלבד. קישור לטווח קצר לתמונה הממוזערת של הקובץ, אם יש כזו. בדרך כלל התהליך נמשך כמה שעות. לא מיועד לשימוש ישיר באפליקציות אינטרנט עקב מדיניות שיתוף משאבים בין מקורות (CORS). מומלץ להשתמש בשרת proxy. השדה מאוכלס רק אם לאפליקציה המבקשת יש גישה לתוכן הקובץ. אם הקובץ לא משותף באופן ציבורי, צריך לאחזר את כתובת ה-URL שמוחזרת ב-`Files.thumbnailLink` באמצעות בקשה עם פרטי כניסה.
`iconLink`	`string` פלט בלבד. קישור סטטי לא מאומת לסמל של הקובץ.
`shared`	`boolean` פלט בלבד. האם הקובץ שותף. לא מאוכלס בפריטים באחסון שיתופי.
`lastModifyingUser`	`object (User)` פלט בלבד. המשתמש האחרון ששינה את הקובץ. השדה הזה מאוכלס רק אם השינוי האחרון בוצע על ידי משתמש שמחובר לחשבון.
`owners[]`	`object (User)` פלט בלבד. הבעלים של הקובץ. רק לקבצים מסוימים מדור קודם יכולים להיות כמה בעלים. השדה הזה לא מאוכלס בפריטים שבתיקיות אחסון שיתופי.
`headRevisionId`	`string` פלט בלבד. המזהה של גרסת ה-head של הקובץ. האפשרות הזו זמינה כרגע רק לקבצים עם תוכן בינארי ב-Google Drive.
`sharingUser`	`object (User)` פלט בלבד. המשתמש ששיתף את הקובץ עם המשתמש המבקש, אם רלוונטי.
`webViewLink`	`string` פלט בלבד. קישור לפתיחת הקובץ בכלי עריכה או צפייה רלוונטי של Google בדפדפן.
`webContentLink`	`string` פלט בלבד. קישור להורדת התוכן של הקובץ בדפדפן. האפשרות הזו זמינה רק לקבצים עם תוכן בינארי ב-Google Drive.
`size`	`string (int64 format)` פלט בלבד. הגודל בבייטים של blobs וקבצים של עורך מהדומיין הנוכחי. לא יאוכלס בקבצים שאין להם גודל, כמו קיצורי דרך ותיקיות.
`viewersCanCopyContent (deprecated)`	`boolean` הפריט הזה הוצא משימוש! האפשרות הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-`copyRequiresWriterPermission`.
`permissions[]`	`object (Permission)` פלט בלבד. רשימת ההרשאות המלאה של הקובץ. האפשרות הזו זמינה רק אם המשתמש המבקש יכול לשתף את הקובץ. לא מאוכלס בפריטים באחסון שיתופי.
`hasThumbnail`	`boolean` פלט בלבד. אם לקובץ יש תמונה ממוזערת. הסטטוס הזה לא מציין אם לאפליקציה המבקשת יש גישה לתמונה הממוזערת. כדי לבדוק את הגישה, מחפשים את השדה thumbnailLink.
`spaces[]`	`string` פלט בלבד. רשימת המרחבים המשותפים שמכילים את הקובץ. הערכים הנתמכים כרגע הם 'drive',‏ 'appDataFolder' ו-'photos'.
`folderColorRgb`	`string` הצבע של תיקייה או קיצור דרך לתיקייה כמחרוזת 16-ביט של RGB. הצבעים הנתמכים מתפרסמים בשדה `folderColorPalette` של משאב About. אם צוין צבע שאינו נתמך, המערכת תשתמש במקום זאת בצבע הקרוב ביותר בצבעים הזמינים.
`id`	`string` המזהה של הקובץ.
`name`	`string` שם הקובץ. השם הזה לא חייב להיות ייחודי בתוך התיקייה. שימו לב: השם של פריטים שלא ניתן לשנות, כמו התיקיות ברמה העליונה של האחסונים השיתופיים, התיקייה הבסיסית (root) של 'האחסון שלי' והתיקייה Application Data, הוא קבוע.
`description`	`string` תיאור קצר של הקובץ.
`starred`	`boolean` אם המשתמש סימן את הקובץ בכוכב.
`trashed`	`boolean` האם הקובץ הועבר לאשפה, באופן מפורש או מתיקיית הורה שהועברה לאשפה. רק הבעלים יכול להעביר קובץ לאשפה, ומשתמשים אחרים לא יכולים לראות קבצים באשפה של הבעלים.
`explicitlyTrashed`	`boolean` פלט בלבד. האם הקובץ הועבר לאשפה באופן מפורש, בניגוד להעברה רפרסיבית לאשפה מתיקיית הורה.
`createdTime`	`string` השעה שבה הקובץ נוצר (תאריך ושעה בפורמט RFC 3339).
`modifiedTime`	`string` הפעם האחרונה שבה מישהו שינה את הקובץ (תאריך ושעה בפורמט RFC 3339). שימו לב שהגדרת `modifiedTime` מעדכנת גם את `modifiedByMeTime` עבור המשתמש.
`modifiedByMeTime`	`string` פלט בלבד. הפעם האחרונה שבה המשתמש שינה את הקובץ (תאריך ושעה בפורמט RFC 3339).
`viewedByMeTime`	`string` הפעם האחרונה שהמשתמש צפה בקובץ (תאריך ושעה בפורמט RFC 3339).
`sharedWithMeTime`	`string` פלט בלבד. השעה שבה הקובץ שותף עם המשתמש, אם רלוונטי (תאריך ושעה בפורמט RFC 3339).
`quotaBytesUsed`	`string (int64 format)` פלט בלבד. מספר הבייטים במכסת האחסון שנעשה בהם שימוש בקובץ. הרשימה הזו כוללת את הגרסה הראשית וגם גרסאות קודמות עם `keepForever` מופעל.
`version`	`string (int64 format)` פלט בלבד. מספר גרסה של הקובץ שגדל באופן מונוטוני. הוא משקף כל שינוי שבוצע בקובץ בשרת, גם שינויים שלא גלויים למשתמש.
`originalFilename`	`string` שם הקובץ המקורי של התוכן שהועל, אם הוא זמין, או הערך המקורי של השדה `name`. האפשרות הזו זמינה רק לקבצים עם תוכן בינארי ב-Google Drive.
`ownedByMe`	`boolean` פלט בלבד. אם הקובץ נמצא בבעלות המשתמש. לא מאוכלס בפריטים באחסון שיתופי.
`fullFileExtension`	`string` פלט בלבד. סיומת הקובץ המלאה שחולצה מהשדה `name`. יכול להכיל כמה סיומת מחוברות, למשל 'tar.gz'. האפשרות הזו זמינה רק לקבצים עם תוכן בינארי ב-Google Drive. השדה הזה מתעדכן באופן אוטומטי כשהשדה `name` משתנה, אבל הוא לא נמחק אם השם החדש לא מכיל סיומת תקינה.
`properties`	`map (key: string, value: value (Value format))` אוסף של צמדי מפתח/ערך שרירותיים שגלויים לכל האפליקציות. רשומות עם ערכים null נמחקות בבקשות עדכון והעתקה. אובייקט שמכיל רשימה של זוגות `"key": value`. דוגמה: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`appProperties`	`map (key: string, value: value (Value format))` אוסף של צמדי מפתח/ערך שרירותיים, שהם פרטיים לאפליקציה המבקשת. רשומות עם ערכים null נמחקות בבקשות עדכון והעתקה. אפשר לאחזר את המאפיינים האלה רק באמצעות בקשה מאומתת. בבקשה מאומתת נעשה שימוש באסימון גישה שהתקבל באמצעות מזהה לקוח ב-OAuth 2. אי אפשר להשתמש במפתח API כדי לאחזר נכסים פרטיים. אובייקט שמכיל רשימה של זוגות `"key": value`. דוגמה: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`isAppAuthorized`	`boolean` פלט בלבד. האם הקובץ נוצר או נפתח על ידי האפליקציה המבקשת.
`teamDriveId (deprecated)`	`string` הפריט הזה הוצא משימוש! הוצא משימוש: פלט בלבד. במקום זאת, אתם צריכים להשתמש ב-`driveId`.
`capabilities`	`object` פלט בלבד. הרשאות המשתמש הנוכחי בקובץ הזה. כל יכולת תואמת לפעולה מפורטת שמשתמש יכול לבצע.
`capabilities.canChangeViewersCanCopyContent (deprecated)`	`boolean` הוצא משימוש: פלט בלבד.
`capabilities.canMoveChildrenOutOfDrive`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להעביר תיקיות צאצא של התיקייה הזו מחוץ לאחסון השיתופי. הערך הוא שקר אם הפריט הוא לא תיקייה. השדה מאוכלס רק לגבי פריטים באחסון שיתופי.
`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` פלט בלבד. האם המשתמש הנוכחי יכול למחוק צאצאים של התיקייה הזו. הערך הוא שקר אם הפריט הוא לא תיקייה. השדה מאוכלס רק לגבי פריטים באחסון שיתופי.
`capabilities.canMoveChildrenOutOfTeamDrive (deprecated)`	`boolean` הוצא משימוש: פלט בלבד. במקום זאת, אתם צריכים להשתמש ב-`canMoveChildrenOutOfDrive`.
`capabilities.canMoveChildrenWithinTeamDrive (deprecated)`	`boolean` הוצא משימוש: פלט בלבד. במקום זאת, אתם צריכים להשתמש ב-`canMoveChildrenWithinDrive`.
`capabilities.canTrashChildren`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להעביר לאשפה צאצאים של התיקייה הזו. הערך הוא שקר אם הפריט הוא לא תיקייה. השדה מאוכלס רק לגבי פריטים באחסון שיתופי.
`capabilities.canMoveItemOutOfDrive`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להעביר את הפריט הזה מחוץ להתקן האחסון הזה על ידי שינוי ההורה שלו. חשוב לזכור שבקשה לשינוי ההורה של הפריט עדיין עשויה להיכשל, בהתאם להורה החדש שנוסף.
`capabilities.canAddMyDriveParent`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להוסיף פריט הורה לפריט בלי להסיר פריט הורה קיים באותה בקשה. לא מאוכלס בקבצים מאחסון שיתופי.
`capabilities.canRemoveMyDriveParent`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להסיר הורה מהפריט בלי להוסיף הורה אחר באותה בקשה. לא מאוכלס בקבצים מאחסון שיתופי.
`capabilities.canMoveItemWithinDrive`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להעביר את הפריט הזה בתוך האחסון הזה. שימו לב: יכול להיות שבקשה לשינוי ההורה של הפריט עדיין תיכשל, בהתאם להורה החדש שנוסף ולהורה שמתבקש להסיר.
`capabilities.canShare`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול לשנות את הגדרות השיתוף של הקובץ הזה.
`capabilities.canMoveChildrenWithinDrive`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להעביר תיקיות צאצאיות של התיקייה הזו בתוך האחסון הזה. הערך הוא שקר אם הפריט הוא לא תיקייה. שימו לב: בקשה להעברת הצאצא עדיין עשויה להיכשל, בהתאם לגישה של המשתמש הנוכחי לצאצא ולתיקיית היעד.
`capabilities.canModifyContentRestriction (deprecated)`	`boolean` הוצא משימוש: פלט בלבד. משתמשים ב-`canModifyEditorContentRestriction`, ב-`canModifyOwnerContentRestriction` או ב-`canRemoveContentRestriction`.
`capabilities.canAddFolderFromAnotherDrive`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להוסיף לתיקייה הזו תיקייה מאחסון אחר (אחסון שיתופי אחר או 'האחסון שלי'). הערך הוא שקר אם הפריט הוא לא תיקייה. השדה מאוכלס רק לגבי פריטים באחסון שיתופי.
`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)` פלט בלבד. אם הקובץ הועבר לאשפה באופן מפורש, המשתמש שהעביר אותו לאשפה. השדה מאוכלס רק לגבי פריטים באחסון שיתופי.
`thumbnailVersion`	`string (int64 format)` פלט בלבד. גרסת התמונה הממוזערת לשימוש בביטול התוקף של מטמון התמונות הממוזערות.
`trashedTime`	`string` פלט בלבד. השעה שבה הפריט הועבר לאשפה (תאריך ושעה בפורמט RFC 3339). השדה מאוכלס רק לגבי פריטים באחסון שיתופי.
`modifiedByMe`	`boolean` פלט בלבד. האם המשתמש הזה שינה את הקובץ.
`permissionIds[]`	`string` פלט בלבד. רשימת מזהי ההרשאות של משתמשים שיש להם גישה לקובץ הזה.
`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.time`	`string` פלט בלבד. התאריך והשעה שבהם צולמה התמונה (EXIF DateTime).
`imageMediaMetadata.cameraMake`	`string` פלט בלבד. היצרן של המצלמה ששימשה ליצירת התמונה.
`imageMediaMetadata.cameraModel`	`string` פלט בלבד. הדגם של המצלמה ששימשה ליצירת התמונה.
`imageMediaMetadata.exposureTime`	`number` פלט בלבד. משך החשיפה, בשניות.
`imageMediaMetadata.aperture`	`number` פלט בלבד. הצמצם ששימש ליצירת התמונה (מספר f).
`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.create`.
`shortcutDetails.targetId`	`string` המזהה של הקובץ שאליו מפנה קיצור הדרך הזה. אפשר להגדיר את האפשרות הזו רק לבקשות `files.create`.
`shortcutDetails.targetMimeType`	`string` פלט בלבד. סוג ה-MIME של הקובץ שאליו מפנה קיצור הדרך הזה. הערך של השדה הזה הוא תמונת מצב של סוג ה-MIME של היעד, שצולמה כשיוצרים את קיצור הדרך.
`shortcutDetails.targetResourceKey`	`string` פלט בלבד. ResourceKey של קובץ היעד.
`contentRestrictions[]`	`object (ContentRestriction)` הגבלות על הגישה לתוכן של הקובץ. השדה מאוכלס רק אם קיימת הגבלה כזו.
`resourceKey`	`string` פלט בלבד. מפתח שנחוץ כדי לגשת לפריט דרך קישור משותף.
`linkShareMetadata`	`object` פלט בלבד. פרטים שקשורים ל-LinkShare. מכיל פרטים על כתובות ה-URL של הקישורים שבהם הלקוחות משתמשים כדי להפנות לפריט הזה.
`linkShareMetadata.securityUpdateEligible`	`boolean` פלט בלבד. אם הקובץ עומד בדרישות לקבלת עדכון אבטחה.
`linkShareMetadata.securityUpdateEnabled`	`boolean` פלט בלבד. אם עדכון האבטחה מופעל בקובץ הזה.
`labelInfo`	`object` פלט בלבד. סקירה כללית של התוויות בקובץ.
`labelInfo.labels[]`	`object (Label)` פלט בלבד. קבוצת התוויות בקובץ, כפי שביקשת לפי מזהי התוויות בפרמטר `includeLabels`. כברירת מחדל, לא מוחזר אף תווית.
`sha1Checksum`	`string` פלט בלבד. סיכום הביקורת (checksum) מסוג SHA1 שמשויך לקובץ הזה, אם הוא זמין. השדה הזה מאוכלס רק בקבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס בקבצים של עורכי Docs או בקבצי קיצור דרך.
`sha256Checksum`	`string` פלט בלבד. סיכום הביקורת (checksum) של SHA256 שמשויך לקובץ הזה, אם הוא זמין. השדה הזה מאוכלס רק בקבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס בקבצים של עורכי Docs או בקבצי קיצור דרך.
`inheritedPermissionsDisabled`	`boolean` אם ההרשאות שעברו בירושה בקובץ הזה מושבתות. הרשאות שעברו בירושה מופעלות כברירת מחדל.

ContentRestriction

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

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

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

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

REST Resource: files

משאב: קובץ

ContentRestriction

Methods

`copy`

`create`

`delete`

`download`

`emptyTrash`

`export`

`generateIds`

`get`

`list`

`listLabels`

`modifyLabels`

`update`

`watch`