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

REST Resource: files

Resource: File
שיטות

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

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

חלק מהשיטות של משאבים (כמו 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` המזהה של תיקיית ההורה שמכילה את הקובץ. לקובץ יכולה להיות רק תיקיית הורה אחת. אי אפשר לציין כמה תיקיות הורה. אם לא מציינים את המיקום כחלק מבקשת יצירה, הקובץ ממוקם ישירות בתיקייה 'האחסון שלי' של המשתמש. אם לא מציינים את התיקייה כחלק מבקשת העתקה, הקובץ יורש את כל תיקיות ההורה שאפשר לגלות של קובץ המקור. בבקשות files.update צריך להשתמש בפרמטרים `addParents` ו-`removeParents` כדי לשנות את רשימת תיקיות ההורה.
`owners[]`	`object (User)` פלט בלבד. הבעלים של הקובץ. רק לקבצים מסוימים מדור קודם יכולים להיות יותר מבעלים אחד. השדה הזה לא מאוכלס עבור פריטים באחסון שיתופי.
`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. אי אפשר להשתמש במפתח API כדי לאחזר נכסים פרטיים. אובייקט שמכיל רשימה של `"key": value` זוגות. דוגמה: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`
`permissionIds[]`	`string` פלט בלבד. files.list of permission IDs for users with access to this file.
`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` הטקסט שיעבור אינדוקס בקובץ כדי לשפר את השאילתות של חיפוש טקסט מלא. האורך המקסימלי של הערך הוא 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, התוכן שהועלה מיובא, אם אפשר. הפורמטים הנתמכים לייבוא מפורסמים במשאב About.
`thumbnailLink`	`string` פלט בלבד. קישור לזמן קצר לתמונה הממוזערת של הקובץ, אם יש כזו. בדרך כלל נמשך כמה שעות. השימוש ב-API הזה לא מיועד לאפליקציות אינטרנט ישירות בגלל מדיניות שיתוף משאבים בין מקורות (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)` פלט בלבד. הגודל בבייטים של אובייקטים בינאריים גדולים וקבצים של עורך מהדומיין הנוכחי. השדה הזה לא יאוכלס עבור קבצים ללא גודל, כמו קיצורי דרך ותיקיות.
`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). שימו לב שההגדרה `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`	`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)` הגבלות על הורדה חלות על הקובץ.

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` פלט בלבד. האם הגבלת התוכן הוחלה על ידי המערכת, למשל בגלל חתימה אלקטרונית. משתמשים לא יכולים לשנות או להסיר הגבלות על תוכן שמוגבל על ידי המערכת.

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