Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

REST Resource: files

משאב: File
Methods

משאב: קובץ

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

חלק מהשיטות של משאבים (כמו 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, "canChangeItemDownloadRestriction": boolean, "canStartApproval": boolean, "canAccessViaGenAi": 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, "downloadRestrictions": { object (`DownloadRestrictionsMetadata`) }, "clientEncryptionDetails": { object (`ClientEncryptionDetails`) } }

{
  "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,
    "canChangeItemDownloadRestriction": boolean,
    "canStartApproval": boolean,
    "canAccessViaGenAi": 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,
  "downloadRestrictions": {
    object (DownloadRestrictionsMetadata)
  },
  "clientEncryptionDetails": {
    object (ClientEncryptionDetails)
  }
}

שדות
`kind`	`string` פלט בלבד. מזהה את סוג המשאב. הערך: המחרוזת הקבועה `"drive#file"`.
`driveId`	`string` פלט בלבד. המזהה של האחסון השיתופי שבו נמצא הקובץ. השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.
`fileExtension`	`string` פלט בלבד. הרכיב האחרון של `fullFileExtension`. האפשרות הזו זמינה רק לקבצים עם תוכן בינארי ב-Google Drive.
`copyRequiresWriterPermission`	`boolean` האם האפשרויות להעתקה, להדפסה או להורדה של הקובץ הזה צריכות להיות מושבתות עבור בעלי הרשאת קריאה והרשאת תגובה.
`md5Checksum`	`string` פלט בלבד. סכום הביקורת MD5 של תוכן הקובץ. ההגדרה הזו רלוונטית רק לקבצים עם תוכן בינארי ב-Google Drive.
`contentHints`	`object` מידע נוסף על תוכן הקובץ. השדות האלה אף פעם לא מאוכלסים בתגובות.
`contentHints.indexableText`	`string` הטקסט שיעבור אינדוקס בקובץ כדי לשפר את השאילתות של fullText. האורך המקסימלי של המחרוזת הוא 128 KB והיא יכולה להכיל רכיבי 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, התוכן שהועלה מיובא, אם אפשר. הפורמטים הנתמכים לייבוא מפורסמים במשאב `about`.
`exportLinks`	`map (key: string, value: string)` פלט בלבד. קישורים לייצוא קבצים בכלי העריכה של Docs לפורמטים ספציפיים. אובייקט שמכיל רשימה של `"key": value` זוגות. דוגמה: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`parents[]`	`string` המזהה של תיקיית ההורה שמכילה את הקובץ. לקובץ יכולה להיות רק תיקיית הורה אחת. אי אפשר לציין כמה תיקיות הורה. אם לא מציינים את התיקייה כחלק מבקשת יצירה, הקובץ ממוקם ישירות בתיקייה 'האחסון שלי' של המשתמש. אם לא מציינים את התיקייה כחלק מבקשת העתקה, הקובץ מקבל בירושה את כל תיקיית ההורה שאפשר לגלות של קובץ המקור. כדי לשנות את רשימת ההורים, צריך להשתמש בפרמטרים `addParents` ו-`removeParents` בבקשות העדכון.
`thumbnailLink`	`string` פלט בלבד. קישור זמני לתמונה הממוזערת של הקובץ, אם יש כזה. בדרך כלל נמשך כמה שעות. לא מיועד לשימוש ישיר באפליקציות אינטרנט בגלל מדיניות שיתוף משאבים בין מקורות (CORS). כדאי להשתמש בשרת Proxy. השדה הזה מאוכלס רק כשאפליקציית הבקשה יכולה לגשת לתוכן הקובץ. אם הקובץ לא שותף באופן ציבורי, צריך לאחזר את כתובת ה-URL שמוחזרת ב-`files.thumbnailLink` באמצעות בקשה עם אישורים.
`iconLink`	`string` פלט בלבד. קישור סטטי לא מאומת לסמל הקובץ.
`shared`	`boolean` פלט בלבד. האם הקובץ שותף. לא מאוכלס עבור פריטים באחסון שיתופי.
`lastModifyingUser`	`object (User)` פלט בלבד. המשתמש האחרון שערך את הקובץ. השדה הזה מאוכלס רק כשהשינוי האחרון בוצע על ידי משתמש מחובר.
`owners[]`	`object (User)` פלט בלבד. הבעלים של הקובץ. יכול להיות שלקובצי Legacy מסוימים יהיו יותר מבעלים אחד. השדה הזה לא מאוכלס עבור פריטים באחסון שיתופי.
`headRevisionId`	`string` פלט בלבד. המזהה של הגרסה העדכנית של הקובץ. האפשרות הזו זמינה כרגע רק לקבצים עם תוכן בינארי ב-Google Drive.
`sharingUser`	`object (User)` פלט בלבד. המשתמש ששיתף את הקובץ עם המשתמש ששלח את הבקשה, אם רלוונטי.
`webViewLink`	`string` פלט בלבד. קישור לפתיחת הקובץ בכלי רלוונטי של Google לעריכה או לצפייה בדפדפן.
`webContentLink`	`string` פלט בלבד. קישור להורדת תוכן הקובץ בדפדפן. האפשרות הזו זמינה רק לקבצים עם תוכן בינארי ב-Google Drive.
`size`	`string (int64 format)` פלט בלבד. הגודל בבייטים של אובייקטים בינאריים גדולים וקבצים של כלי העריכה של Google Workspace. השדה הזה לא יאוכלס עבור קבצים שאין להם גודל, כמו קיצורי דרך ותיקיות.
`viewersCanCopyContent (deprecated)`	`boolean` הפריט הזה יצא משימוש. הוצא משימוש: במקומו, צריך להשתמש ב-`copyRequiresWriterPermission`.
`permissions[]`	`object (Permission)` פלט בלבד. הרשימה המלאה של ההרשאות לקובץ. האפשרות הזו זמינה רק אם המשתמש ששולח את הבקשה יכול לשתף את הקובץ. לא מאוכלס עבור פריטים באחסון שיתופי.
`hasThumbnail`	`boolean` פלט בלבד. האם יש לקובץ הזה תמונה ממוזערת. ההגדרה הזו לא מציינת אם לאפליקציה ששולחת את הבקשה יש גישה לתמונה הממוזערת. כדי לבדוק את הגישה, מחפשים את השדה thumbnailLink.
`spaces[]`	`string` פלט בלבד. רשימת המרחבים שבהם נמצא הקובץ. הערכים הנתמכים כרגע הם `drive`,‏ `appDataFolder` ו-`photos`.
`folderColorRgb`	`string` הצבע של תיקייה או קיצור דרך לתיקייה כמחרוזת הקסדצימלית של RGB. הצבעים הנתמכים מפורסמים בשדה `folderColorPalette` של משאב `about`. אם מציינים צבע שלא נתמך, המערכת משתמשת בצבע הכי קרוב בפלטה.
`id`	`string` המזהה של הקובץ.
`name`	`string` שם הקובץ. השם לא חייב להיות ייחודי בתוך תיקייה. שימו לב: עבור פריטים שלא ניתן לשנות, כמו תיקיות ברמה העליונה של תיקיות אחסון שיתופי, תיקיית הבסיס של 'האחסון שלי' והתיקייה 'נתוני אפליקציות', השם הוא קבוע.
`description`	`string` תיאור קצר של הקובץ.
`starred`	`boolean` האם המשתמש סימן את הקובץ בכוכב.
`trashed`	`boolean` האם הקובץ הועבר לאשפה, באופן מפורש או מתיקיית אב שהועברה לאשפה. רק הבעלים יכול להעביר קובץ לפח, אבל משתמשים אחרים עדיין יכולים לגשת לקובץ בפח של הבעלים עד שהוא נמחק באופן סופי.
`explicitlyTrashed`	`boolean` פלט בלבד. האם הקובץ הועבר במפורש לאשפה, בניגוד להעברה לאשפה באופן רקורסיבי מתיקיית האב.
`createdTime`	`string` השעה שבה הקובץ נוצר (תאריך ושעה בפורמט RFC 3339).
`modifiedTime`	`string` התאריך והשעה שבהם בוצע השינוי האחרון בקובץ על ידי משתמש כלשהו (RFC 3339 date-time). שימו לב שההגדרה `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.0. אי אפשר להשתמש במפתח 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` פלט בלבד. האם המשתמש הנוכחי יכול להעביר פריטי צאצא של התיקייה הזו מחוץ לאחסון השיתופי. הערך הוא `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` האם משתמש יכול להפעיל מחדש הרשאות שעברו בירושה.
`capabilities.canChangeItemDownloadRestriction`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול לשנות את ההגבלות על הורדת הקובץ שהוגדרו על ידי הבעלים או המארגן.
`capabilities.canStartApproval`	`boolean` האם המשתמש הנוכחי יכול להתחיל תהליך אישור בקובץ.
`capabilities.canAccessViaGenAi`	`boolean` האם המשתמש הנוכחי יכול לגשת לקובץ הזה באמצעות תכונות של Gen AI. מידע נוסף זמין במאמר בנושא התאמה של קובץ MCP ב-Drive.
`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` פלט בלבד. הצמצם ששימש ליצירת התמונה (מספר הצמצם).
`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` פלט בלבד. סכום הבדיקה של SHA1 שמשויך לקובץ הזה, אם הוא זמין. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קבצים של עורכי Google Docs או קובצי קיצור דרך.
`sha256Checksum`	`string` פלט בלבד. סכום הבדיקה SHA256 שמשויך לקובץ הזה, אם הוא זמין. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קבצים של עורכי Google Docs או קובצי קיצור דרך.
`inheritedPermissionsDisabled`	`boolean` האם ההרשאות שהקובץ קיבל בירושה מושבתות. ההרשאות שעוברות בירושה מופעלות כברירת מחדל.
`downloadRestrictions`	`object (DownloadRestrictionsMetadata)` הגבלות על הורדה חלות על הקובץ.
`clientEncryptionDetails`	`object (ClientEncryptionDetails)` פרטים שקשורים להצפנה מצד הלקוח. הקובץ מכיל פרטים על מצב ההצפנה של הקובץ ופרטים לגבי מנגנון ההצפנה שבו הלקוחות צריכים להשתמש כדי לפענח את התוכן של הפריט הזה. האפשרות הזו תופיע רק בקבצים ולא בתיקיות או בקיצורי דרך.

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 date-time). השדה הזה מאוכלס רק אם `readOnly=true`.
`ownerRestricted`	`boolean` האם רק משתמש שהוא הבעלים של הקובץ יכול לשנות או להסיר את הגבלת התוכן. בקבצים בתיקיות אחסון שיתופי, כל משתמש עם הרשאות `organizer` יכול לשנות או להסיר את הגבלת התוכן הזו.
`systemRestricted`	`boolean` פלט בלבד. האם הגבלת התוכן הוחלה על ידי המערכת, למשל בגלל חתימה אלקטרונית. המשתמשים לא יכולים לשנות או להסיר הגבלות על תוכן שמוגבל על ידי המערכת.

DownloadRestrictionsMetadata

הגבלות על הורדה חלות על הקובץ.

ייצוג ב-JSON
{ "itemDownloadRestriction": { object (`DownloadRestriction`) }, "effectiveDownloadRestrictionWithContext": { object (`DownloadRestriction`) } }

שדות

itemDownloadRestriction

object (DownloadRestriction)

הגבלת ההורדה של הקובץ הוחלה ישירות על ידי הבעלים או המארגן. החישוב הזה לא מתבסס על הגדרות האחסון השיתופי או על כללי DLP.

effectiveDownloadRestrictionWithContext

object (DownloadRestriction)

פלט בלבד. ההגבלה על ההורדה שחלה על הקובץ הזה. ההגדרה הזו מתייחסת לכל הגדרות ההגבלה ולכללי DLP.

DownloadRestriction

הגבלה על העתקה והורדה של הקובץ.

ייצוג ב-JSON
{ "restrictedForReaders": boolean, "restrictedForWriters": boolean }

שדות

שדות
`restrictedForReaders`	`boolean` האם ההורדה וההעתקה מוגבלות לקוראים.
`restrictedForWriters`	`boolean` האם האפשרות להוריד ולהעתיק מוגבלת לבעלי הרשאת כתיבה. אם הערך הוא True, גם הקוראים לא יכולים להוריד את הספר.

restrictedForReaders

boolean

האם ההורדה וההעתקה מוגבלות לקוראים.

restrictedForWriters

boolean

האם האפשרות להוריד ולהעתיק מוגבלת לבעלי הרשאת כתיבה. אם הערך הוא True, גם הקוראים לא יכולים להוריד את הספר.

ClientEncryptionDetails

פרטים על ההצפנה מצד הלקוח שהוחלה על הקובץ.

ייצוג ב-JSON
{ "encryptionState": string, "decryptionMetadata": { object (`DecryptionMetadata`) } }

שדות

שדות
`encryptionState`	`string` מצב ההצפנה של הקובץ. הערכים הצפויים כאן הם: `encrypted` `unencrypted`
`decryptionMetadata`	`object (DecryptionMetadata)` המטא-נתונים שמשמשים לפעולות בצד הלקוח.

encryptionState

string

מצב ההצפנה של הקובץ. הערכים הצפויים כאן הם:

encrypted
unencrypted

decryptionMetadata

object (DecryptionMetadata)

המטא-נתונים שמשמשים לפעולות בצד הלקוח.

DecryptionMetadata

ייצוג של DecryptionMetadata של הצפנה מצד הלקוח (CSE).

ייצוג ב-JSON
{ "wrappedKey": string, "kaclsId": string, "kaclsName": string, "aes256GcmChunkSize": string, "jwt": string, "keyFormat": string, "encryptionResourceKeyHash": string }

שדות
`wrappedKey`	`string` המפתח העטוף בקידוד Base64 שמתאים לכתובות URL, שמשמש להצפנת התוכן של הקובץ.
`kaclsId`	`string (int64 format)` המזהה של KACLS (השירות למפתחות הרשאות גישה) שמשמש להצפנת הקובץ.
`kaclsName`	`string` השם של KACLS (שירות ACL למפתחות) שמשמש להצפנת הקובץ.
`aes256GcmChunkSize`	`string` גודל החלק שבו נעשה שימוש אם התוכן הוצפן באמצעות הצפנה מסוג AES 256 GCM. הערכים האפשריים הם: `default` `small`
`jwt`	`string` אסימון JWT (‏JSON Web Token) חתום שאפשר להשתמש בו כדי להעניק הרשאה למשתמש ששולח את הבקשה באמצעות שירות ה-ACL של המפתח (KACLS). ב-JWT מצוין שלמשתמש ששולח את הבקשה יש לפחות הרשאות קריאה בקובץ.
`keyFormat`	`string` פורמט המפתח של המפתח שלא עבר הסרה של העטיפה. חייב להיות `tinkAesGcmKey`.
`encryptionResourceKeyHash`	`string` תמצית הגיבוב (digest) של מטא-נתוני המשאב בפורמט HMAC-SHA256 בקידוד Base64 שמתאים לכתובות URL, עם מפתח ה-DEK (מפתח להצפנת נתונים) שלו. מידע נוסף זמין בכתובת https://developers.google.com/workspace/cse/reference

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

REST Resource: files

משאב: קובץ

ContentRestriction

DownloadRestrictionsMetadata

DownloadRestriction

ClientEncryptionDetails

DecryptionMetadata

Methods

`copy`

`create`

`delete`

`download`

`emptyTrash`

`export`

`generateCseToken`

`generateIds`

`get`

`list`

`listLabels`

`modifyLabels`

`update`

`watch`

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

משאב: קובץ

ContentRestriction

DownloadRestrictionsMetadata

DownloadRestriction

ClientEncryptionDetails

DecryptionMetadata

Methods

REST Resource: files