REST Resource: files

משאב: File
Methods

משאב: קובץ

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

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

ייצוג ב-JSON

ייצוג ב-JSON
{ "exportLinks": { string: string, ... }, "parents": [ string ], "owners": [ { object (`User`) } ], "permissions": [ { object (`Permission`) } ], "spaces": [ string ], "properties": { string: value, ... }, "appProperties": { string: value, ... }, "permissionIds": [ string ], "contentRestrictions": [ { object (`ContentRestriction`) } ], "kind": string, "driveId": string, "fileExtension": string, "copyRequiresWriterPermission": boolean, "md5Checksum": string, "contentHints": { "indexableText": string, "thumbnail": { "image": string, "mimeType": string } }, "writersCanShare": boolean, "viewedByMe": boolean, "mimeType": string, "thumbnailLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "headRevisionId": string, "sharingUser": { object (`User`) }, "webViewLink": string, "webContentLink": string, "size": string, "viewersCanCopyContent": boolean, "hasThumbnail": boolean, "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, "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 }, "hasAugmentedPermissions": boolean, "trashingUser": { object (`User`) }, "thumbnailVersion": string, "trashedTime": string, "modifiedByMe": boolean, "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 }, "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean }, "labelInfo": { "labels": [ { object (`Label`) } ] }, "sha1Checksum": string, "sha256Checksum": string, "inheritedPermissionsDisabled": boolean, "downloadRestrictions": { object (`DownloadRestrictionsMetadata`) } }

{
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "hasThumbnail": boolean,
  "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,
  "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
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean,
  "downloadRestrictions": {
    object (DownloadRestrictionsMetadata)
  }
}

שדות
`exportLinks`	`map (key: string, value: string)` פלט בלבד. קישורים לייצוא קבצים בכלי העריכה של Docs לפורמטים ספציפיים. אובייקט שמכיל רשימה של `"key": value` זוגות. לדוגמה: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`parents[]`	`string` המזהה של תיקיית ההורה שמכילה את הקובץ. לקובץ יכולה להיות רק תיקיית הורה אחת. אי אפשר לציין כמה תיקיות הורה. אם לא מציינים את התיקייה כחלק מבקשת יצירה, הקובץ ממוקם ישירות בתיקייה 'האחסון שלי' של המשתמש. אם לא מציינים את התיקייה כחלק מבקשת העתקה, הקובץ מקבל בירושה את תיקיית ההורה של קובץ המקור שאפשר לגלות. כדי לשנות את רשימת ההורים, צריך להשתמש בפרמטרים `addParents` ו-`removeParents` בבקשות העדכון.
`owners[]`	`object (User)` פלט בלבד. הבעלים של הקובץ. יכול להיות שלקובצי Legacy מסוימים יהיו יותר מבעלים אחד. השדה הזה לא מאוכלס עבור פריטים באחסון שיתופי.
`permissions[]`	`object (Permission)` פלט בלבד. הרשימה המלאה של ההרשאות לקובץ. האפשרות הזו זמינה רק אם למשתמש ששולח את הבקשה יש אפשרות לשתף את הקובץ. לא מאוכלס עבור פריטים באחסון שיתופי.
`spaces[]`	`string` פלט בלבד. רשימת המרחבים שבהם הקובץ נמצא. הערכים הנתמכים כרגע הם `drive`,‏ `appDataFolder` ו-`photos`.
`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" }`.
`permissionIds[]`	`string` פלט בלבד. רשימה של מזהי הרשאות של משתמשים שיש להם גישה לקובץ הזה.
`contentRestrictions[]`	`object (ContentRestriction)` הגבלות על הגישה לתוכן הקובץ. השדה יאוכלס רק אם קיימת הגבלה כזו.
`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`.
`thumbnailLink`	`string` פלט בלבד. קישור לזמן קצר לתמונה הממוזערת של הקובץ, אם יש כזה. בדרך כלל נמשך כמה שעות. לא מיועד לשימוש ישיר באפליקציות אינטרנט בגלל מדיניות שיתוף משאבים בין מקורות (CORS). כדאי להשתמש בשרת proxy. השדה הזה מאוכלס רק כשאפליקציית הבקשה יכולה לגשת לתוכן הקובץ. אם הקובץ לא משותף באופן ציבורי, צריך לאחזר את כתובת ה-URL שמוחזרת ב-`files.thumbnailLink` באמצעות בקשה עם אישורים.
`iconLink`	`string` פלט בלבד. קישור סטטי לא מאומת לסמל הקובץ.
`shared`	`boolean` פלט בלבד. האם הקובץ שותף. לא מאוכלס עבור פריטים באחסון שיתופי.
`lastModifyingUser`	`object (User)` פלט בלבד. המשתמש האחרון ששינה את הקובץ. השדה הזה מאוכלס רק כשהשינוי האחרון בוצע על ידי משתמש מחובר.
`headRevisionId`	`string` פלט בלבד. המזהה של הגרסה העדכנית של הקובץ. האפשרות הזו זמינה כרגע רק לקבצים עם תוכן בינארי ב-Google Drive.
`sharingUser`	`object (User)` פלט בלבד. המשתמש ששיתף את הקובץ עם המשתמש ששלח את הבקשה, אם רלוונטי.
`webViewLink`	`string` פלט בלבד. קישור לפתיחת הקובץ בכלי רלוונטי של Google לעריכה או לצפייה בדפדפן.
`webContentLink`	`string` פלט בלבד. קישור להורדת התוכן של הקובץ בדפדפן. האפשרות הזו זמינה רק לקבצים עם תוכן בינארי ב-Google Drive.
`size`	`string (int64 format)` פלט בלבד. הגודל בבייטים של אובייקטים בינאריים גדולים וקבצים בכלי העריכה של Google Workspace. השדה הזה לא יאוכלס עבור קבצים שאין להם גודל, כמו קיצורי דרך ותיקיות.
`viewersCanCopyContent (deprecated)`	`boolean` הפריט הזה יצא משימוש. הוצא משימוש: במקומו צריך להשתמש ב-`copyRequiresWriterPermission`.
`hasThumbnail`	`boolean` פלט בלבד. האם יש לקובץ הזה תמונה ממוזערת. ההודעה הזו לא מציינת אם לאפליקציה ששולחת את הבקשה יש גישה לתמונה הממוזערת. כדי לבדוק את הגישה, מחפשים את השדה thumbnailLink.
`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`, אבל הוא לא מתרוקן אם השם החדש לא מכיל סיומת תקינה.
`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` פלט בלבד. האם המשתמש הנוכחי יכול לשנות את הגבלות ההורדה של הקובץ שהוגדרו על ידי הבעלים או המארגן.
`hasAugmentedPermissions`	`boolean` פלט בלבד. האם יש הרשאות ישירות לקובץ הזה. השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.
`trashingUser`	`object (User)` פלט בלבד. אם הקובץ הועבר במפורש לאשפה, המשתמש שהעביר אותו לאשפה. השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.
`thumbnailVersion`	`string (int64 format)` פלט בלבד. גרסת התמונה הממוזערת לשימוש בביטול תוקף של מטמון התמונות הממוזערות.
`trashedTime`	`string` פלט בלבד. השעה שבה הפריט הועבר לאשפה (תאריך ושעה בפורמט RFC 3339). השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.
`modifiedByMe`	`boolean` פלט בלבד. האם המשתמש שינה את הקובץ.
`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` של היעד.
`resourceKey`	`string` פלט בלבד. מפתח שנדרש כדי לגשת לפריט דרך קישור משותף.
`linkShareMetadata`	`object` פלט בלבד. פרטים שקשורים ל-LinkShare. המאפיין מכיל פרטים על כתובות ה-URL של הקישורים שבהם הלקוחות משתמשים כדי להפנות למוצר הזה.
`linkShareMetadata.securityUpdateEligible`	`boolean` פלט בלבד. האם הקובץ עומד בדרישות לעדכון אבטחה.
`linkShareMetadata.securityUpdateEnabled`	`boolean` פלט בלבד. האם עדכון האבטחה מופעל בקובץ הזה.
`labelInfo`	`object` פלט בלבד. סקירה כללית של התוויות בקובץ.
`labelInfo.labels[]`	`object (Label)` פלט בלבד. קבוצת התוויות בקובץ, כפי שנדרש על ידי מזהי התוויות בפרמטר `includeLabels`. כברירת מחדל, לא מוחזרות תוויות.
`sha1Checksum`	`string` פלט בלבד. סכום הביקורת SHA1 שמשויך לקובץ הזה, אם הוא זמין. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קבצים של עורכי Docs או קובצי קיצור דרך.
`sha256Checksum`	`string` פלט בלבד. סכום הבדיקה SHA256 שמשויך לקובץ הזה, אם הוא זמין. השדה הזה מאוכלס רק עבור קבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור קבצים של עורכי Docs או קובצי קיצור דרך.
`inheritedPermissionsDisabled`	`boolean` האם ההרשאות שהקובץ קיבל בירושה מושבתות. ההרשאות שעוברות בירושה מופעלות כברירת מחדל.
`downloadRestrictions`	`object (DownloadRestrictionsMetadata)` הגבלות על הורדה חלות על הקובץ.

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, גם הקוראים לא יכולים להוריד את הספר.

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

REST Resource: files

משאב: קובץ

ContentRestriction

DownloadRestrictionsMetadata

DownloadRestriction

Methods

`copy`

`create`

`delete`

`download`

`emptyTrash`

`export`

`generateIds`

`get`

`list`

`listLabels`

`modifyLabels`

`update`

`watch`

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

משאב: קובץ

ContentRestriction

DownloadRestrictionsMetadata

DownloadRestriction

Methods

REST Resource: files