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

REST Resource: files

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

משאב: קובץ

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

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

ייצוג JSON

ייצוג JSON
{ "kind": string, "userPermission": { object (`Permission`) }, "fileExtension": string, "md5Checksum": string, "selfLink": string, "ownerNames": [ string ], "lastModifyingUserName": string, "editable": boolean, "writersCanShare": boolean, "downloadUrl": string, "mimeType": string, "exportLinks": { string: string, ... }, "driveId": string, "parents": [ { object (`ParentReference`) } ], "thumbnailLink": string, "appDataContents": boolean, "webViewLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "owners": [ { object (`User`) } ], "openWithLinks": { string: string, ... }, "defaultOpenWithLink": string, "headRevisionId": string, "properties": [ { object (`Property`) } ], "copyable": boolean, "etag": string, "sharingUser": { object (`User`) }, "alternateLink": string, "embedLink": string, "webContentLink": string, "fileSize": string, "copyRequiresWriterPermission": boolean, "permissions": [ { object (`Permission`) } ], "hasThumbnail": boolean, "spaces": [ string ], "folderColorRgb": string, "id": string, "title": string, "description": string, "labels": { "viewed": boolean, "restricted": boolean, "starred": boolean, "hidden": boolean, "trashed": boolean, "modified": boolean }, "explicitlyTrashed": boolean, "createdDate": string, "modifiedDate": string, "modifiedByMeDate": string, "lastViewedByMeDate": string, "markedViewedByMeDate": string, "sharedWithMeDate": string, "quotaBytesUsed": string, "version": string, "indexableText": { "text": string }, "originalFilename": string, "ownedByMe": boolean, "canComment": boolean, "shareable": boolean, "fullFileExtension": string, "isAppAuthorized": boolean, "teamDriveId": string, "capabilities": { "canChangeRestrictedDownload": boolean, "canMoveChildrenOutOfDrive": boolean, "canReadDrive": boolean, "canEdit": boolean, "canCopy": boolean, "canComment": boolean, "canAddChildren": boolean, "canDelete": boolean, "canDownload": boolean, "canListChildren": boolean, "canRemoveChildren": boolean, "canRename": boolean, "canTrash": boolean, "canReadRevisions": boolean, "canReadTeamDrive": boolean, "canMoveTeamDriveItem": boolean, "canChangeCopyRequiresWriterPermission": boolean, "canMoveItemIntoTeamDrive": boolean, "canUntrash": boolean, "canModifyContent": boolean, "canMoveItemWithinTeamDrive": boolean, "canMoveItemOutOfTeamDrive": boolean, "canDeleteChildren": boolean, "canMoveChildrenOutOfTeamDrive": boolean, "canMoveChildrenWithinTeamDrive": boolean, "canTrashChildren": boolean, "canMoveItemOutOfDrive": boolean, "canAddMyDriveParent": boolean, "canRemoveMyDriveParent": boolean, "canMoveItemWithinDrive": boolean, "canShare": boolean, "canMoveChildrenWithinDrive": boolean, "canModifyContentRestriction": boolean, "canAddFolderFromAnotherDrive": boolean, "canChangeSecurityUpdateEnabled": boolean, "canAcceptOwnership": boolean, "canReadLabels": boolean, "canModifyLabels": boolean, "canModifyEditorContentRestriction": boolean, "canModifyOwnerContentRestriction": boolean, "canRemoveContentRestriction": boolean }, "hasAugmentedPermissions": boolean, "trashingUser": { object (`User`) }, "canReadRevisions": boolean, "thumbnailVersion": string, "trashedDate": string, "permissionIds": [ string ], "thumbnail": { "image": string, "mimeType": string }, "imageMediaMetadata": { "flashUsed": boolean, "meteringMode": string, "sensor": string, "exposureMode": string, "colorSpace": string, "whiteBalance": string, "width": integer, "height": integer, "location": { "latitude": number, "longitude": number, "altitude": number }, "rotation": integer, "date": string, "cameraMake": string, "cameraModel": string, "exposureTime": number, "aperture": number, "focalLength": number, "isoSpeed": integer, "exposureBias": number, "maxApertureValue": number, "subjectDistance": integer, "lens": string }, "videoMediaMetadata": { "width": integer, "height": integer, "durationMillis": string }, "shortcutDetails": { "targetId": string, "targetMimeType": string, "targetResourceKey": string }, "contentRestrictions": [ { object (`ContentRestriction`) } ], "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean }, "labelInfo": { "labels": [ { object (`Label`) } ] }, "sha1Checksum": string, "sha256Checksum": string }

{
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "ownerNames": [
    string
  ],
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "driveId": string,
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "properties": [
    {
      object (Property)
    }
  ],
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "title": string,
  "description": string,
  "labels": {
    "viewed": boolean,
    "restricted": boolean,
    "starred": boolean,
    "hidden": boolean,
    "trashed": boolean,
    "modified": boolean
  },
  "explicitlyTrashed": boolean,
  "createdDate": string,
  "modifiedDate": string,
  "modifiedByMeDate": string,
  "lastViewedByMeDate": string,
  "markedViewedByMeDate": string,
  "sharedWithMeDate": string,
  "quotaBytesUsed": string,
  "version": string,
  "indexableText": {
    "text": string
  },
  "originalFilename": string,
  "ownedByMe": boolean,
  "canComment": boolean,
  "shareable": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeRestrictedDownload": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": string,
  "permissionIds": [
    string
  ],
  "thumbnail": {
    "image": string,
    "mimeType": string
  },
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "date": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string
}

שדות
`kind`	`string` פלט בלבד. סוג הקובץ. הערך הוא תמיד `drive#file`.
`userPermission`	`object (Permission)` פלט בלבד. ההרשאות של המשתמש המאומת בקובץ הזה.
`fileExtension`	`string` פלט בלבד. הרכיב האחרון של `fullFileExtension` עם טקסט בסוף שלא נראה שהוא חלק מהתוסף. השדה הזה יאוכלס רק בקבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס בעורכי Docs או בקובצי קיצור דרך.
`md5Checksum`	`string` פלט בלבד. סיכום ביקורת (checksum) MD5 לתוכן של הקובץ הזה. השדה הזה יאוכלס רק בקבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס בעורכי Docs או בקובצי קיצור דרך.
`selfLink`	`string` פלט בלבד. קישור בחזרה לקובץ הזה.
`ownerNames[]`	`string` פלט בלבד. שמות הבעלים של הקובץ הזה. לא מאוכלס עבור פריטים בתיקיות אחסון שיתופי.
`lastModifyingUserName`	`string` פלט בלבד. שם המשתמש האחרון שיבצע שינויים בקובץ.
`editable (deprecated)`	`boolean` הפריט הזה הוצא משימוש. פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב `capabilities/canEdit`.
`writersCanShare`	`boolean` האם כותבים יכולים לשתף את המסמך עם משתמשים אחרים. לא מאוכלס עבור פריטים בתיקיות אחסון שיתופי.
`downloadUrl`	`string` פלט בלבד. כתובת URL להורדה של הקובץ, לטווח קצר. השדה הזה יאוכלס רק בקבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס עבור Google Docs או קובצי קיצור.
`mimeType`	`string` סוג ה-MIME של הקובץ. אפשר לשנות את זה רק כשמעלים תוכן חדש. אפשר להשאיר את השדה הזה ריק, וה-mimetype ייקבע לפי סוג ה-MIME של התוכן שהועלה.
`exportLinks`	`map (key: string, value: string)` פלט בלבד. קישורים לייצוא קבצים של עורכי Docs לפורמטים ספציפיים. אובייקט שמכיל רשימה של `"key": value` זוגות. לדוגמה: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`driveId`	`string` פלט בלבד. המזהה של האחסון השיתופי שהקובץ נמצא בו. השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`parents[]`	`object (ParentReference)` המזהה של תיקיית ההורה שמכילה את הקובץ. לקובץ יכולה להיות רק תיקיית הורה אחת. אי אפשר לציין כמה הורים. אם לא מציינים זאת כחלק מבקשת הוספה, הקובץ ימוקם ישירות בתיקייה 'האחסון שלי' של המשתמש. אם לא מציינים את זה כחלק מבקשת העתקה, הקובץ יורש כל הורה של קובץ המקור שגלוי לכולם. כדי לשנות את רשימת ההורים, בקשות מסוג files.update חייבות להשתמש בפרמטרים `addParents` ו-`removeParents`.
`thumbnailLink`	`string` פלט בלבד. קישור לטווח קצר לתמונה הממוזערת של הקובץ, אם יש קישור. בדרך כלל נמשך לפי סדר השעות. לא מיועד לשימוש ישיר באפליקציות אינטרנט בגלל שיתוף משאבים בין מקורות (CORS), כדאי להשתמש בשרת proxy. השדה הזה מאוכלס רק כשהאפליקציה ששלחה את הבקשה יכולה לגשת לתוכן של הקובץ. אם הקובץ לא משותף באופן ציבורי, צריך לאחזר את כתובת ה-URL שהוחזרה ב-`Files.thumbnailLink` באמצעות בקשה עם פרטי כניסה.
`appDataContents`	`boolean` פלט בלבד. האם הקובץ הזה נמצא בתיקייה Application Data (נתוני אפליקציה).
`webViewLink`	`string` פלט בלבד. קישור זמין רק בתיקיות ציבוריות לצפייה בנכסי האינטרנט הסטטיים שלהן (HTML, CSS, JS וכו') באמצעות אירוח אתרים ב-Google Drive.
`iconLink`	`string` פלט בלבד. קישור לסמל של הקובץ.
`shared`	`boolean` פלט בלבד. האם הקובץ שותף. לא מאוכלס עבור פריטים בתיקיות אחסון שיתופי.
`lastModifyingUser`	`object (User)` פלט בלבד. המשתמש האחרון שביצע שינוי בקובץ הזה. השדה הזה יאוכלס רק כאשר השינוי האחרון בוצע על ידי משתמש שמחובר לחשבון.
`owners[]`	`object (User)` פלט בלבד. הבעלים של הקובץ הזה. רק לקבצים מסוימים מדור קודם יכול להיות יותר מבעלים אחד. השדה הזה לא מאוכלס בפריטים בתיקיות אחסון שיתופי.
`openWithLinks`	`map (key: string, value: string)` פלט בלבד. מפה של המזהה של כל אחת מהאפליקציות של המשתמש לקישור לפתיחת הקובץ הזה באותה אפליקציה. השדה מאוכלס רק כשמשתמשים בהיקף drive.apps.readonly. אובייקט שמכיל רשימה של `"key": value` זוגות. לדוגמה: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`defaultOpenWithLink`	`string` פלט בלבד. קישור לפתיחת הקובץ הזה עם אפליקציית ברירת המחדל של המשתמש לקובץ הזה. השדה מאוכלס רק כשמשתמשים בהיקף drive.apps.readonly.
`headRevisionId`	`string` פלט בלבד. מזהה הגרסה הראשית של הקובץ. השדה הזה יאוכלס רק בקבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס בעורכי Docs או בקובצי קיצור דרך.
`properties[]`	`object (Property)` רשימת הנכסים.
`copyable (deprecated)`	`boolean` הפריט הזה הוצא משימוש. פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב `capabilities/canCopy`.
`etag`	`string` פלט בלבד. ה-ETag של הקובץ.
`sharingUser`	`object (User)` פלט בלבד. המשתמש ששיתף את הפריט עם המשתמש הנוכחי, אם הוא זמין.
`alternateLink`	`string` פלט בלבד. קישור לפתיחת הקובץ בעורך או במציג רלוונטיים של Google.
`embedLink`	`string` פלט בלבד. קישור להטמעת הקובץ.
`webContentLink`	`string` פלט בלבד. קישור להורדת תוכן הקובץ בדפדפן באמצעות אימות שמבוסס על קובצי Cookie. במקרים שבהם התוכן משותף באופן ציבורי, ניתן להוריד את התוכן ללא פרטי כניסה.
`fileSize`	`string (int64 format)` פלט בלבד. גודל בבייטים של blobs וקובצי עורך צד ראשון. לא יאוכלסו בקבצים ללא גודל, כמו קיצורי דרך ותיקיות.
`copyRequiresWriterPermission`	`boolean` האפשרויות של העתקה, הדפסה או הורדה של הקובץ הזה צריכות להיות מושבתות עבור קוראים ומגיבים.
`permissions[]`	`object (Permission)` פלט בלבד. רשימת ההרשאות למשתמשים שיש להם גישה לקובץ הזה. לא מאוכלס עבור פריטים בתיקיות אחסון שיתופי.
`hasThumbnail`	`boolean` פלט בלבד. האם לקובץ הזה יש תמונה ממוזערת. האפשרות הזו לא מציינת אם לאפליקציה ששלחה את הבקשה יש גישה לתמונה הממוזערת. כדי לבדוק את הגישה, מחפשים את השדה JPEGLink.
`spaces[]`	`string` פלט בלבד. רשימת המרחבים המשותפים שמכילים את הקובץ. הערכים הנתמכים הם `drive`, `appDataFolder` ו-`photos`.
`folderColorRgb`	`string` צבע התיקייה כמחרוזת הקסדצימלית של RGB אם הקובץ הוא תיקייה או קיצור דרך לתיקייה. רשימת הצבעים הנתמכים זמינה בשדה FolderColorPalette במשאב 'מידע כללי'. אם צוין צבע שלא נתמך, הוא יוחלף לצבע הקרוב ביותר בלוח.
`id`	`string` המזהה של הקובץ.
`title`	`string` הכותרת של הקובץ הזה. חשוב לשים לב: לפריטים שלא ניתנים לשינוי, כמו תיקיות ברמה העליונה של תיקיות אחסון שיתופי, תיקיית הבסיס של 'האחסון שלי' ותיקיית Application Data, שם הקובץ נשאר קבוע.
`description`	`string` תיאור קצר של הקובץ.
`labels`	`object` קבוצה של תוויות לקובץ.
`labels.viewed`	`boolean` האם הקובץ נצפה על ידי המשתמש הזה.
`labels.restricted (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב `copyRequiresWriterPermission`.
`labels.starred`	`boolean` האם המשתמש סימן את הקובץ הזה בכוכב.
`labels.hidden (deprecated)`	`boolean` פלט בלבד. הוצא משימוש.
`labels.trashed`	`boolean` האם הקובץ הזה הועבר לאשפה. התווית הזאת חלה על כל המשתמשים שניגשים לקובץ. עם זאת, רק הבעלים יכולים לראות קבצים ולבטל אותם לאשפה.
`labels.modified`	`boolean` פלט בלבד. האם הקובץ שינה את הקובץ על ידי המשתמש הזה.
`explicitlyTrashed`	`boolean` פלט בלבד. האם הקובץ הזה הועבר לאשפה באופן מפורש ולא לאשפה באופן רקורסיבי.
`createdDate`	`string` פלט בלבד. שעת היצירה של הקובץ הזה (חותמת זמן בפורמט RFC 3339).
`modifiedDate`	`string` הפעם האחרונה שבה מישהו שינה את הקובץ הזה (חותמת זמן בפורמט RFC 3339). אפשר לשנות את ההגדרה הזו רק בעדכון כשמוגדר הפרמטר setAdjustDate.
`modifiedByMeDate`	`string` פלט בלבד. הפעם האחרונה שהמשתמש שינה את הקובץ הזה (חותמת זמן בפורמט RFC 3339). הערה: ההגדרה changedDate תעדכן גם את התאריך changedByMe עבור המשתמש שהגדיר את התאריך.
`lastViewedByMeDate`	`string` הפעם האחרונה שהמשתמש צפה בקובץ הזה (חותמת זמן בפורמט RFC 3339).
`markedViewedByMeDate (deprecated)`	`string` הפריט הזה הוצא משימוש. פלט בלבד. הוצא משימוש.
`sharedWithMeDate`	`string` פלט בלבד. השעה שבה הקובץ הזה שותף עם המשתמש (חותמת זמן בפורמט RFC 3339).
`quotaBytesUsed`	`string (int64 format)` פלט בלבד. מספר הבייטים במכסה שמשמש את הקובץ הזה.
`version`	`string (int64 format)` פלט בלבד. מספר גרסה של הקובץ עולה באופן מונוטוני. השינוי הזה משקף את כל השינויים שבוצעו בקובץ בשרת, גם שינויים שלא גלויים למשתמש ששלח את הבקשה.
`indexableText`	`object` מאפייני טקסט של הקובץ שניתן להוסיף לאינדקס (ניתן לכתיבה בלבד)
`indexableText.text`	`string` הטקסט שיש להוסיף לאינדקס עבור הקובץ הזה.
`originalFilename`	`string` שם הקובץ המקורי של התוכן שהועלה אם הוא זמין, או הערך המקורי בשדה `title`. האפשרות הזו זמינה רק לקבצים ב-Google Drive שמכילים תוכן בינארי.
`ownedByMe`	`boolean` פלט בלבד. האם הקובץ בבעלות המשתמש הנוכחי. לא מאוכלס עבור פריטים בתיקיות אחסון שיתופי.
`canComment (deprecated)`	`boolean` הפריט הזה הוצא משימוש. פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב `capabilities/canComment`.
`shareable (deprecated)`	`boolean` הפריט הזה הוצא משימוש. פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב `capabilities/canShare`.
`fullFileExtension`	`string` פלט בלבד. סיומת הקובץ המלאה; חולץ מהכותרת. עשוי להכיל מספר סיומות מחוברות, כמו 'tar.gz'. הסרת תוסף מהכותרת לא מנקה את השדה הזה. עם זאת, שינוי הסיומת בכותרת כן מעדכן את השדה הזה. השדה הזה יאוכלס רק בקבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס בעורכי Docs או בקובצי קיצור דרך.
`isAppAuthorized`	`boolean` פלט בלבד. האם הקובץ נוצר או פתח על ידי האפליקציה ששלחה את הבקשה.
`teamDriveId (deprecated)`	`string` הפריט הזה הוצא משימוש. פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב `driveId`.
`capabilities`	`object` פלט בלבד. ההרשאות של המשתמש הנוכחי בקובץ הזה. כל יכולת תואמת לפעולה פרטנית שהמשתמשים עשויים לבצע.
`capabilities.canChangeRestrictedDownload (deprecated)`	`boolean` פלט בלבד. הוצא משימוש.
`capabilities.canMoveChildrenOutOfDrive`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להעביר צאצאים של התיקייה אל מחוץ לאחסון השיתופי. הערך הוא False אם הפריט הוא לא תיקייה. השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`capabilities.canReadDrive`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לקרוא את האחסון השיתופי שהקובץ הזה שייך לו. השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`capabilities.canEdit`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לערוך את הקובץ הזה. גורמים אחרים עשויים להגביל את סוג השינויים שמשתמש יכול לבצע בקובץ. לדוגמה, אפשר להיכנס אל `canChangeCopyRequiresWriterPermission` או `canModifyContent`.
`capabilities.canCopy`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להעתיק את הקובץ הזה. לגבי פריט באחסון שיתופי, האם המשתמש הנוכחי יכול להעתיק צאצאים של הפריט הזה שלא נמצאים בתיקייה, או את הפריט עצמו אם הוא לא תיקייה.
`capabilities.canComment`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להגיב על הקובץ הזה.
`capabilities.canAddChildren`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להוסיף ילדים לתיקייה הזו. הערך הזה תמיד מוגדר כ-False אם הפריט אינו תיקייה.
`capabilities.canDelete`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול למחוק את הקובץ הזה.
`capabilities.canDownload`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להוריד את הקובץ.
`capabilities.canListChildren`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להציג את רשימת הצאצאים של התיקייה. הערך הזה תמיד מוגדר כ-False אם הפריט אינו תיקייה.
`capabilities.canRemoveChildren`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להסיר צאצאים מהתיקייה הזו. הערך הזה תמיד מוגדר כ-False אם הפריט אינו תיקייה. אם רוצים להוסיף תיקייה באחסון שיתופי, צריך להשתמש ב-`canDeleteChildren` או ב-`canTrashChildren`.
`capabilities.canRename`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לשנות את השם של הקובץ.
`capabilities.canTrash`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להעביר את הקובץ הזה לאשפה.
`capabilities.canReadRevisions`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לקרוא את משאב הגרסאות של הקובץ הזה. ניתן לקרוא פריט באחסון שיתופי, אם הוא משתנה לצאצאים של הפריט הזה שלא נמצא בתיקייה, או את הפריט עצמו (אם הוא לא תיקייה).
`capabilities.canReadTeamDrive (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב `canReadDrive`.
`capabilities.canMoveTeamDriveItem (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ב-`canMoveItemWithinDrive` או ב-`canMoveItemOutOfDrive`.
`capabilities.canChangeCopyRequiresWriterPermission`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לשנות את ההגבלה `copyRequiresWriterPermission` בקובץ הזה.
`capabilities.canMoveItemIntoTeamDrive (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב `canMoveItemOutOfDrive`.
`capabilities.canUntrash`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לשחזר את הקובץ הזה מהאשפה.
`capabilities.canModifyContent`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לשנות את התוכן של הקובץ הזה.
`capabilities.canMoveItemWithinTeamDrive (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב `canMoveItemWithinDrive`.
`capabilities.canMoveItemOutOfTeamDrive (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב `canMoveItemOutOfDrive`.
`capabilities.canDeleteChildren`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול למחוק צאצאים של התיקייה. הערך הוא False אם הפריט הוא לא תיקייה. השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`capabilities.canMoveChildrenOutOfTeamDrive (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב `canMoveChildrenOutOfDrive`.
`capabilities.canMoveChildrenWithinTeamDrive (deprecated)`	`boolean` פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב `canMoveChildrenWithinDrive`.
`capabilities.canTrashChildren`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להעביר לאשפה את הצאצאים של התיקייה הזו. הערך הוא False אם הפריט הוא לא תיקייה. השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`capabilities.canMoveItemOutOfDrive`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להעביר את הפריט הזה אל מחוץ לאחסון הזה על ידי שינוי ההורה שלו. הערה: בקשה לשינוי ההורה של הפריט עדיין עשויה להיכשל, בהתאם לרכיב ההורה החדש שנוסף.
`capabilities.canAddMyDriveParent`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להוסיף הורה לפריט מבלי להסיר הורה קיים באותה בקשה. לא מאוכלס עבור קבצים באחסון שיתופי.
`capabilities.canRemoveMyDriveParent`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להסיר הורה מהפריט בלי להוסיף עוד הורה באותה בקשה. לא מאוכלס עבור קבצים באחסון שיתופי.
`capabilities.canMoveItemWithinDrive`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להעביר את הפריט בתוך האחסון הזה. הערה: בקשה לשינוי ההורה של הפריט עדיין עשויה להיכשל, בהתאם להורה החדש שמוסיפים ולהורה שהוסר.
`capabilities.canShare`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לשנות את הגדרות השיתוף של הקובץ הזה.
`capabilities.canMoveChildrenWithinDrive`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להעביר צאצאים של התיקייה בתוך האחסון הזה. הערך הוא False אם הפריט הוא לא תיקייה. הערה: יכול להיות שבקשה להעביר את הילד או הילדה עדיין תיכשל, בהתאם לגישה של המשתמש הנוכחי לילד או לתיקיית היעד.
`capabilities.canModifyContentRestriction (deprecated)`	`boolean` הוצא משימוש: פלט בלבד. צריך להשתמש באחד מהערכים `canModifyEditorContentRestriction`, `canModifyOwnerContentRestriction` או `canRemoveContentRestriction`.
`capabilities.canAddFolderFromAnotherDrive`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להוסיף לתיקייה הזו תיקייה מאחסון אחר (אחסון שיתופי אחר או 'האחסון שלי'). הערך הוא False אם הפריט הוא לא תיקייה. השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`capabilities.canChangeSecurityUpdateEnabled`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לשנות את השדה securityUpdateEnabled במטא-נתונים של שיתוף באמצעות קישור.
`capabilities.canAcceptOwnership`	`boolean` פלט בלבד. האם המשתמש הנוכחי הוא הבעלים הממתינים לאישור של הקובץ. לא מאוכלס עבור קבצים באחסון שיתופי.
`capabilities.canReadLabels`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לקרוא את התוויות בקובץ.
`capabilities.canModifyLabels`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לשנות את התוויות בקובץ.
`capabilities.canModifyEditorContentRestriction`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להוסיף או לשנות הגבלות תוכן בקובץ שמוגבלות על ידי העורכים.
`capabilities.canModifyOwnerContentRestriction`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להוסיף או לשנות הגבלות תוכן שמוגבלות על ידי הבעלים.
`capabilities.canRemoveContentRestriction`	`boolean` פלט בלבד. האם יש בקובץ הגבלת תוכן שהמשתמש הנוכחי יכול להסיר.
`hasAugmentedPermissions`	`boolean` פלט בלבד. האם יש הרשאות ישירות בקובץ הזה. השדה הזה יאוכלס רק בפריטים בתיקיות אחסון שיתופי.
`trashingUser`	`object (User)` פלט בלבד. אם הקובץ הועבר לאשפה באופן מפורש, המשתמש שהעביר אותו לאשפה. השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`canReadRevisions (deprecated)`	`boolean` הפריט הזה הוצא משימוש. פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב `capabilities/canReadRevisions`.
`thumbnailVersion`	`string (int64 format)` פלט בלבד. גרסת התמונה הממוזערת לשימוש בביטול תוקף של מטמון תמונות ממוזערות.
`trashedDate`	`string` פלט בלבד. השעה שבה הפריט הועבר לאשפה (חותמת זמן בפורמט RFC 3339). השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`permissionIds[]`	`string` פלט בלבד. file.list של מזהי ההרשאות של המשתמשים שיש להם גישה לקובץ הזה.
`thumbnail`	`object` תמונה ממוזערת של הקובץ. המערכת תשתמש באפשרות הזו רק אם לא ניתן ליצור תמונה ממוזערת רגילה.
`thumbnail.image`	`string (bytes format)` הבייטים של התמונה הממוזערת בקידוד Base64, הבטוחים לכתובות URL. היא צריכה להתאים לתקן RFC 4648 סעיף 5. מחרוזת בקידוד base64.
`thumbnail.mimeType`	`string` סוג ה-MIME של התמונה הממוזערת.
`imageMediaMetadata`	`object` פלט בלבד. מטא-נתונים על מדיה של תמונה. יוצג רק עבור סוגי תמונות, והתוכן שלו יהיה תלוי במה שניתן לנתח מתוכן התמונה.
`imageMediaMetadata.flashUsed`	`boolean` פלט בלבד. האם נעשה שימוש בפלאש כדי ליצור את התמונה.
`imageMediaMetadata.meteringMode`	`string` פלט בלבד. מצב מכסת הנתונים ששימש ליצירת התמונה.
`imageMediaMetadata.sensor`	`string` פלט בלבד. סוג החיישן ששימש ליצירת התמונה.
`imageMediaMetadata.exposureMode`	`string` פלט בלבד. מצב החשיפה ששימש ליצירת התמונה.
`imageMediaMetadata.colorSpace`	`string` פלט בלבד. מרחב הצבעים של התמונה.
`imageMediaMetadata.whiteBalance`	`string` פלט בלבד. מצב איזון הלבן ששימש ליצירת התמונה.
`imageMediaMetadata.width`	`integer` פלט בלבד. רוחב התמונה בפיקסלים.
`imageMediaMetadata.height`	`integer` פלט בלבד. גובה התמונה בפיקסלים.
`imageMediaMetadata.location`	`object` פלט בלבד. פרטי מיקום גיאוגרפי שמאוחסנים בתמונה.
`imageMediaMetadata.location.latitude`	`number` פלט בלבד. קו הרוחב שמאוחסן בתמונה.
`imageMediaMetadata.location.longitude`	`number` פלט בלבד. קו האורך ששמור בתמונה.
`imageMediaMetadata.location.altitude`	`number` פלט בלבד. הגובה שמאוחסן בתמונה.
`imageMediaMetadata.rotation`	`integer` פלט בלבד. מספר הסיבובים ב-90 מעלות בכיוון השעון שבוצעו בכיוון המקורי של התמונה.
`imageMediaMetadata.date`	`string` פלט בלבד. התאריך והשעה שבהם התמונה צולמה (חותמת זמן בפורמט EXIF).
`imageMediaMetadata.cameraMake`	`string` פלט בלבד. יצרן המצלמה ששימשה ליצירת התמונה.
`imageMediaMetadata.cameraModel`	`string` פלט בלבד. מודל המצלמה ששימש ליצירת התמונה.
`imageMediaMetadata.exposureTime`	`number` פלט בלבד. משך החשיפה, בשניות.
`imageMediaMetadata.aperture`	`number` פלט בלבד. מפתח הצמצם ששימש ליצירת התמונה (מספר f).
`imageMediaMetadata.focalLength`	`number` פלט בלבד. רוחק המוקד ששימש ליצירת התמונה, במילימטרים.
`imageMediaMetadata.isoSpeed`	`integer` פלט בלבד. מהירות ה-ISO ששימשה ליצירת התמונה.
`imageMediaMetadata.exposureBias`	`number` פלט בלבד. הטיית החשיפה של התמונה (ערך APEX).
`imageMediaMetadata.maxApertureValue`	`number` פלט בלבד. מספר ה-f הקטן ביותר של העדשה באורך המוקד ששימש ליצירת התמונה (ערך APEX).
`imageMediaMetadata.subjectDistance`	`integer` פלט בלבד. המרחק למושא התמונה במטרים.
`imageMediaMetadata.lens`	`string` פלט בלבד. העדשה ששימשה ליצירת התמונה.
`videoMediaMetadata`	`object` פלט בלבד. מטא-נתונים על מדיה בסרטונים. השדה הזה קיים רק בסוגי סרטונים.
`videoMediaMetadata.width`	`integer` פלט בלבד. רוחב הסרטון בפיקסלים.
`videoMediaMetadata.height`	`integer` פלט בלבד. גובה הסרטון בפיקסלים.
`videoMediaMetadata.durationMillis`	`string (int64 format)` פלט בלבד. משך הסרטון באלפיות השנייה.
`shortcutDetails`	`object` פרטי הקובץ של קיצורי הדרך. השדה הזה מאוכלס רק עבור קבצים של קיצורי דרך, שבהם השדה mimeType מוגדר ל-`application/vnd.google-apps.shortcut`. ניתן להגדיר רק בבקשות `files.insert`.
`shortcutDetails.targetId`	`string` מזהה הקובץ שאליו מפנה קיצור הדרך הזה. ניתן להגדיר רק בבקשות `files.insert`.
`shortcutDetails.targetMimeType`	`string` פלט בלבד. סוג ה-MIME של הקובץ שקיצור הדרך הזה מפנה אליו. הערך בשדה הזה הוא תמונת מצב של סוג ה-MIME של היעד, שמתועד בזמן יצירת קיצור הדרך.
`shortcutDetails.targetResourceKey`	`string` פלט בלבד. מפתח המשאב של קובץ היעד.
`contentRestrictions[]`	`object (ContentRestriction)` הגבלות על גישה לתוכן של הקובץ. השדה הזה מאוכלס רק אם קיימת הגבלה כזו.
`resourceKey`	`string` פלט בלבד. נדרש מפתח כדי לגשת לפריט דרך קישור משותף.
`linkShareMetadata`	`object` פלט בלבד. פרטים קשורים של LinkShare. יש פרטים על כתובות ה-URL של הקישורים שהלקוחות משתמשים בהן כדי להפנות לפריט הזה.
`linkShareMetadata.securityUpdateEligible`	`boolean` פלט בלבד. האם הקובץ עומד בדרישות לעדכון אבטחה.
`linkShareMetadata.securityUpdateEnabled`	`boolean` פלט בלבד. האם עדכון האבטחה מופעל בקובץ הזה.
`labelInfo`	`object` פלט בלבד. סקירה כללית של התוויות בקובץ.
`labelInfo.labels[]`	`object (Label)` פלט בלבד. קבוצת התוויות בקובץ, כפי שנדרש על ידי מזהי התוויות בפרמטר `includeLabels`. כברירת מחדל, לא מוחזרות תוויות.
`sha1Checksum`	`string` פלט בלבד. סיכום הביקורת (checksum) SHA1 שמשויך לקובץ הזה, אם זמין. השדה הזה יאוכלס רק בקבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס בעורכי Docs או בקובצי קיצור דרך.
`sha256Checksum`	`string` פלט בלבד. סיכום הביקורת (checksum) SHA256 שמשויך לקובץ הזה, אם זמין. השדה הזה יאוכלס רק בקבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס בעורכי Docs או בקובצי קיצור דרך.

ContentRestriction

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

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

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

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

REST Resource: files

משאב: קובץ

ContentRestriction

שיטות

`copy`

`delete`

`emptyTrash`

`export`

`generateIds`

`get`

`insert`

`list`

`listLabels`

`modifyLabels`

`patch`

`touch`

`trash`

`untrash`

`update`

`watch`