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

REST Resource: files

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

משאב: קובץ

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

לשיטות משאבים מסוימות (כמו 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` פלט בלבד. בדיקת סיכום של 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` פלט בלבד. קישור לטווח קצר לתמונה הממוזערת של הקובץ, אם הוא זמין. בדרך כלל הבדיקה נמשכת עד כמה שעות. השדה מאוכלס רק כשהאפליקציה ששולחת את הבקשה יכולה לגשת לתוכן של הקובץ. אם הקובץ לא משותף באופן ציבורי, יש לאחזר את כתובת ה-URL שהוחזרה ב-`Files.thumbnailLink` באמצעות בקשה בעלת פרטי כניסה.
`appDataContents`	`boolean` פלט בלבד. האם הקובץ הזה נמצא בתיקייה 'נתוני אפליקציות'.
`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` פלט בלבד. מזהה של גרסת ה-head של הקובץ. השדה הזה מאוכלס רק בקבצים עם תוכן השמור ב-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` פלט בלבד. אם הקובץ הזה כולל תמונה ממוזערת. לא ניתן לדעת אם לאפליקציה שביקשה גישה יש גישה לתמונה הממוזערת. כדי לבדוק את הגישה, מחפשים את השדה imageLink [קישור_תמונה].
`spaces[]`	`string` פלט בלבד. רשימת המרחבים המשותפים שמכילים את הקובץ. הערכים הנתמכים הם `drive`, `appDataFolder` ו-`photos`.
`folderColorRgb`	`string` צבע התיקייה כמחרוזת הקסדצימלית של RGB אם הקובץ הוא תיקייה או קיצור דרך לתיקייה. רשימת הצבעים הנתמכים זמינה בשדה FolderColorPalette של המשאב 'מידע על'. אם יצוין צבע שלא נתמך, הוא ישתנה לצבע הקרוב ביותר בלוח הצבעים.
`id`	`string` מזהה הקובץ.
`title`	`string` שם הקובץ הזה. חשוב לשים לב: לגבי פריטים שלא משתנים, כמו התיקיות ברמה העליונה של תיקיות אחסון שיתופי, תיקיית הבסיס של 'האחסון שלי' ותיקיית נתוני האפליקציה, הכותרת קבועה.
`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). ניתן לשנות זאת רק בעדכון כאשר הפרמטר setשונהDate מוגדר.
`modifiedByMeDate`	`string` פלט בלבד. הפעם האחרונה שהמשתמש שינה את הקובץ (חותמת זמן בפורמט RFC 3339). הערה: ההגדרה modifiedDate תעדכן גם את התאריך modifiedByMe עבור המשתמש שהגדיר את התאריך.
`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` פלט בלבד. files.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-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`.
`shortcutDetails.targetId`	`string` מזהה הקובץ שאליו מפנה קיצור הדרך.
`shortcutDetails.targetMimeType`	`string` פלט בלבד. סוג ה-MIME של הקובץ שקיצור הדרך הזה מפנה אליו. הערך בשדה הזה הוא תמונת מצב של סוג ה-MIME של היעד, שתועדה כשקיצור הדרך נוצר.
`shortcutDetails.targetResourceKey`	`string` פלט בלבד. ה-ResourceKey עבור קובץ היעד.
`contentRestrictions[]`	`object (ContentRestriction)` הגבלות על הגישה לתוכן של הקובץ. השדה יאוכלס רק אם קיימת הגבלה כזו.
`resourceKey`	`string` פלט בלבד. מפתח שנדרש כדי לגשת לפריט דרך קישור משותף.
`linkShareMetadata`	`object` פלט בלבד. פרטים שקשורים ל-LinkShare. כולל פרטים על כתובות ה-URL של הקישורים שבהם הלקוחות משתמשים כדי להתייחס לפריט הזה.
`linkShareMetadata.securityUpdateEligible`	`boolean` פלט בלבד. האם הקובץ מתאים לעדכון אבטחה.
`linkShareMetadata.securityUpdateEnabled`	`boolean` פלט בלבד. האם עדכון האבטחה מופעל בקובץ הזה.
`labelInfo`	`object` פלט בלבד. סקירה כללית של התוויות בקובץ.
`labelInfo.labels[]`	`object (Label)` פלט בלבד. קבוצת התוויות בקובץ, כפי שהתבקשו לפי מזהי התוויות בפרמטר `includeLabels`. כברירת מחדל, לא מוחזרות תוויות.
`sha1Checksum`	`string` פלט בלבד. סכום הביקורת SHA1 שמשויך לקובץ הזה, אם הוא זמין. השדה הזה מאוכלס רק בקבצים עם תוכן השמור ב-Google Drive. הוא לא מאוכלס בעורכי Docs או בקובצי קיצורי דרך.
`sha256Checksum`	`string` פלט בלבד. סכום הביקורת 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`