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

REST Resource: files

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

משאב: קובץ

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

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

ייצוג JSON

ייצוג JSON
{ "kind": string, "driveId": string, "fileExtension": string, "copyRequiresWriterPermission": boolean, "md5Checksum": string, "contentHints": { "indexableText": string, "thumbnail": { "image": string, "mimeType": string } }, "writersCanShare": boolean, "viewedByMe": boolean, "mimeType": string, "exportLinks": { string: string, ... }, "parents": [ string ], "thumbnailLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "owners": [ { object (`User`) } ], "headRevisionId": string, "sharingUser": { object (`User`) }, "webViewLink": string, "webContentLink": string, "size": string, "viewersCanCopyContent": boolean, "permissions": [ { object (`Permission`) } ], "hasThumbnail": boolean, "spaces": [ string ], "folderColorRgb": string, "id": string, "name": string, "description": string, "starred": boolean, "trashed": boolean, "explicitlyTrashed": boolean, "createdTime": string, "modifiedTime": string, "modifiedByMeTime": string, "viewedByMeTime": string, "sharedWithMeTime": string, "quotaBytesUsed": string, "version": string, "originalFilename": string, "ownedByMe": boolean, "fullFileExtension": string, "properties": { string: value, ... }, "appProperties": { string: value, ... }, "isAppAuthorized": boolean, "teamDriveId": string, "capabilities": { "canChangeViewersCanCopyContent": boolean, "canMoveChildrenOutOfDrive": boolean, "canReadDrive": boolean, "canEdit": boolean, "canCopy": boolean, "canComment": boolean, "canAddChildren": boolean, "canDelete": boolean, "canDownload": boolean, "canListChildren": boolean, "canRemoveChildren": boolean, "canRename": boolean, "canTrash": boolean, "canReadRevisions": boolean, "canReadTeamDrive": boolean, "canMoveTeamDriveItem": boolean, "canChangeCopyRequiresWriterPermission": boolean, "canMoveItemIntoTeamDrive": boolean, "canUntrash": boolean, "canModifyContent": boolean, "canMoveItemWithinTeamDrive": boolean, "canMoveItemOutOfTeamDrive": boolean, "canDeleteChildren": boolean, "canMoveChildrenOutOfTeamDrive": boolean, "canMoveChildrenWithinTeamDrive": boolean, "canTrashChildren": boolean, "canMoveItemOutOfDrive": boolean, "canAddMyDriveParent": boolean, "canRemoveMyDriveParent": boolean, "canMoveItemWithinDrive": boolean, "canShare": boolean, "canMoveChildrenWithinDrive": boolean, "canModifyContentRestriction": boolean, "canAddFolderFromAnotherDrive": boolean, "canChangeSecurityUpdateEnabled": boolean, "canAcceptOwnership": boolean, "canReadLabels": boolean, "canModifyLabels": boolean, "canModifyEditorContentRestriction": boolean, "canModifyOwnerContentRestriction": boolean, "canRemoveContentRestriction": boolean }, "hasAugmentedPermissions": boolean, "trashingUser": { object (`User`) }, "thumbnailVersion": string, "trashedTime": string, "modifiedByMe": boolean, "permissionIds": [ string ], "imageMediaMetadata": { "flashUsed": boolean, "meteringMode": string, "sensor": string, "exposureMode": string, "colorSpace": string, "whiteBalance": string, "width": integer, "height": integer, "location": { "latitude": number, "longitude": number, "altitude": number }, "rotation": integer, "time": string, "cameraMake": string, "cameraModel": string, "exposureTime": number, "aperture": number, "focalLength": number, "isoSpeed": integer, "exposureBias": number, "maxApertureValue": number, "subjectDistance": integer, "lens": string }, "videoMediaMetadata": { "width": integer, "height": integer, "durationMillis": string }, "shortcutDetails": { "targetId": string, "targetMimeType": string, "targetResourceKey": string }, "contentRestrictions": [ { object (`ContentRestriction`) } ], "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean }, "labelInfo": { "labels": [ { object (`Label`) } ] }, "sha1Checksum": string, "sha256Checksum": string }

{
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "name": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "createdTime": string,
  "modifiedTime": string,
  "modifiedByMeTime": string,
  "viewedByMeTime": string,
  "sharedWithMeTime": string,
  "quotaBytesUsed": string,
  "version": string,
  "originalFilename": string,
  "ownedByMe": boolean,
  "fullFileExtension": string,
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "permissionIds": [
    string
  ],
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "time": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string
}

שדות
`kind`	`string` פלט בלבד. מזהה את סוג המשאב הזה. ערך: המחרוזת הקבועה `"drive#file"`.
`driveId`	`string` פלט בלבד. המזהה של האחסון השיתופי שהקובץ נמצא בו. השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`fileExtension`	`string` פלט בלבד. הרכיב האחרון של `fullFileExtension`. האפשרות הזו זמינה רק לקבצים ב-Google Drive שמכילים תוכן בינארי.
`copyRequiresWriterPermission`	`boolean` האפשרויות של העתקה, הדפסה או הורדה של הקובץ הזה צריכות להיות מושבתות עבור קוראים ומגיבים.
`md5Checksum`	`string` פלט בלבד. סיכום הביקורת (checksum) MD5 של תוכן הקובץ. האפשרות הזו רלוונטית רק לקבצים ב-Google Drive עם תוכן בינארי.
`contentHints`	`object` מידע נוסף על תוכן הקובץ. השדות האלה אף פעם לא יאוכלסו בתשובות.
`contentHints.indexableText`	`string` הטקסט שיתווסף לאינדקס עבור הקובץ כדי לשפר שאילתות fullText. האורך מוגבל ל-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, המערכת תייבא את התוכן המועלה, במידת האפשר. הפורמטים הנתמכים של הייבוא מתפרסמים במשאב 'מידע כללי'.
`exportLinks`	`map (key: string, value: string)` פלט בלבד. קישורים לייצוא קבצים של עורכי Docs לפורמטים ספציפיים. אובייקט שמכיל רשימה של `"key": value` זוגות. לדוגמה: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`parents[]`	`string` המזהה של תיקיית ההורה שמכילה את הקובץ. לקובץ יכולה להיות רק תיקיית הורה אחת. אי אפשר לציין כמה הורים. אם לא מציינים את זה כחלק מבקשת יצירה, הקובץ ימוקם ישירות בתיקייה 'האחסון שלי' של המשתמש. אם לא מציינים את זה כחלק מבקשת העתקה, הקובץ יורש כל הורה של קובץ המקור שגלוי לכולם. כדי לשנות את רשימת ההורים, בקשות מסוג files.update חייבות להשתמש בפרמטרים `addParents` ו-`removeParents`.
`thumbnailLink`	`string` פלט בלבד. קישור לטווח קצר לתמונה הממוזערת של הקובץ, אם יש קישור. בדרך כלל נמשך לפי סדר השעות. לא מיועד לשימוש ישיר באפליקציות אינטרנט בגלל מדיניות שיתוף משאבים בין מקורות (CORS), כדאי להשתמש בשרת proxy. השדה הזה מאוכלס רק כשהאפליקציה ששלחה את הבקשה יכולה לגשת לתוכן של הקובץ. אם הקובץ לא משותף באופן ציבורי, צריך לאחזר את כתובת ה-URL שהוחזרה ב-`Files.thumbnailLink` באמצעות בקשה עם פרטי כניסה.
`iconLink`	`string` פלט בלבד. קישור סטטי ולא מאומת לסמל הקובץ.
`shared`	`boolean` פלט בלבד. האם הקובץ שותף. לא מאוכלס עבור פריטים בתיקיות אחסון שיתופי.
`lastModifyingUser`	`object (User)` פלט בלבד. המשתמש האחרון שביצע שינויים בקובץ. השדה הזה יאוכלס רק כאשר השינוי האחרון בוצע על ידי משתמש שמחובר לחשבון.
`owners[]`	`object (User)` פלט בלבד. הבעלים של הקובץ הזה. רק לקבצים מסוימים מדור קודם יכול להיות יותר מבעלים אחד. השדה הזה לא מאוכלס בפריטים בתיקיות אחסון שיתופי.
`headRevisionId`	`string` פלט בלבד. מזהה הגרסה הראשית של הקובץ. האפשרות הזו זמינה כרגע רק לקבצים ב-Google Drive שמכילים תוכן בינארי.
`sharingUser`	`object (User)` פלט בלבד. המשתמש ששיתף את הקובץ עם המשתמש שהגיש את הבקשה, אם רלוונטי.
`webViewLink`	`string` פלט בלבד. קישור לפתיחת הקובץ בעורך או במציג רלוונטי של Google בדפדפן.
`webContentLink`	`string` פלט בלבד. קישור להורדת התוכן של הקובץ בדפדפן. האפשרות הזו זמינה רק לקבצים ב-Google Drive שמכילים תוכן בינארי.
`size`	`string (int64 format)` פלט בלבד. גודל בבייטים של blobs וקובצי עורך צד ראשון. לא יאוכלסו בקבצים ללא גודל, כמו קיצורי דרך ותיקיות.
`viewersCanCopyContent (deprecated)`	`boolean` הפריט הזה הוצא משימוש. הוצא משימוש: במקומו צריך להשתמש ברכיב `copyRequiresWriterPermission`.
`permissions[]`	`object (Permission)` פלט בלבד. רשימת ההרשאות המלאה לקובץ. האפשרות הזו זמינה רק אם המשתמש ששלח את הבקשה יכול לשתף את הקובץ. לא מאוכלס עבור פריטים בתיקיות אחסון שיתופי.
`hasThumbnail`	`boolean` פלט בלבד. האם לקובץ הזה יש תמונה ממוזערת. האפשרות הזו לא מציינת אם לאפליקציה ששלחה את הבקשה יש גישה לתמונה הממוזערת. כדי לבדוק את הגישה, מחפשים את השדה JPEGLink.
`spaces[]`	`string` פלט בלבד. רשימת המרחבים המשותפים שמכילים את הקובץ. הערכים הנתמכים כרגע הם 'drive', 'appDataFolder' ו-'photos'.
`folderColorRgb`	`string` הצבע של תיקייה או קיצור דרך לתיקייה כמחרוזת הקסדצימלית של RGB. הצבעים הנתמכים מוצגים בשדה `folderColorPalette` של המשאב 'מידע כללי'. אם צוין צבע שלא נתמך, המערכת תשתמש בצבע הקרוב ביותר בלוח הצבעים.
`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` משתנה, אבל הוא לא נמחק אם השם החדש לא מכיל סיומת חוקית.
`properties`	`map (key: string, value: value (Value format))` אוסף של צמדי מפתח/ערך שרירותיים שגלויים לכל האפליקציות. רשומות עם ערכים ריקים יוסרו בבקשות לעדכון והעתקה. אובייקט שמכיל רשימה של `"key": value` זוגות. לדוגמה: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`appProperties`	`map (key: string, value: value (Value format))` אוסף של צמדי מפתח-ערך שרירותיים שהוגדרו כפרטיים לאפליקציה ששולחת את הבקשה. רשומות עם ערכים ריקים יוסרו בבקשות לעדכון והעתקה. אפשר לאחזר את המאפיינים האלה רק באמצעות בקשה מאומתת. בקשה מאומתת משתמשת באסימון גישה שהתקבל עם מזהה לקוח OAuth 2. לא ניתן להשתמש במפתח API כדי לאחזר נכסים פרטיים. אובייקט שמכיל רשימה של `"key": value` זוגות. לדוגמה: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`isAppAuthorized`	`boolean` פלט בלבד. האם הקובץ נוצר או פתח על ידי האפליקציה ששלחה את הבקשה.
`teamDriveId (deprecated)`	`string` הפריט הזה הוצא משימוש. הוצא משימוש: פלט בלבד. במקום זאת, אתם צריכים להשתמש ב-`driveId`.
`capabilities`	`object` פלט בלבד. ההרשאות של המשתמש הנוכחי בקובץ הזה. כל יכולת תואמת לפעולה פרטנית שהמשתמשים עשויים לבצע.
`capabilities.canChangeViewersCanCopyContent (deprecated)`	`boolean` הוצא משימוש: פלט בלבד.
`capabilities.canMoveChildrenOutOfDrive`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להעביר צאצאים של התיקייה אל מחוץ לאחסון השיתופי. הערך הוא False אם הפריט הוא לא תיקייה. השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`capabilities.canReadDrive`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לקרוא את האחסון השיתופי שהקובץ הזה שייך לו. השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`capabilities.canEdit`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לערוך את הקובץ הזה. גורמים אחרים עשויים להגביל את סוג השינויים שמשתמש יכול לבצע בקובץ. לדוגמה, אפשר להיכנס אל `canChangeCopyRequiresWriterPermission` או `canModifyContent`.
`capabilities.canCopy`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להעתיק את הקובץ הזה. לגבי פריט באחסון שיתופי, האם המשתמש הנוכחי יכול להעתיק צאצאים של הפריט הזה שלא נמצאים בתיקייה, או את הפריט עצמו אם הוא לא תיקייה.
`capabilities.canComment`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להגיב על הקובץ הזה.
`capabilities.canAddChildren`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להוסיף ילדים לתיקייה הזו. הערך הזה תמיד מוגדר כ-False אם הפריט אינו תיקייה.
`capabilities.canDelete`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול למחוק את הקובץ הזה.
`capabilities.canDownload`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להוריד את הקובץ.
`capabilities.canListChildren`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להציג את רשימת הצאצאים של התיקייה. הערך הזה תמיד מוגדר כ-False אם הפריט אינו תיקייה.
`capabilities.canRemoveChildren`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להסיר צאצאים מהתיקייה הזו. הערך הזה תמיד מוגדר כ-False אם הפריט אינו תיקייה. אם רוצים להוסיף תיקייה באחסון שיתופי, צריך להשתמש ב-`canDeleteChildren` או ב-`canTrashChildren`.
`capabilities.canRename`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לשנות את השם של הקובץ.
`capabilities.canTrash`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להעביר את הקובץ הזה לאשפה.
`capabilities.canReadRevisions`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לקרוא את משאב הגרסאות של הקובץ הזה. ניתן לקרוא פריט באחסון שיתופי, אם הוא משתנה לצאצאים של הפריט הזה שלא נמצא בתיקייה, או את הפריט עצמו (אם הוא לא תיקייה).
`capabilities.canReadTeamDrive (deprecated)`	`boolean` הוצא משימוש: פלט בלבד. במקום זאת, אתם צריכים להשתמש ב-`canReadDrive`.
`capabilities.canMoveTeamDriveItem (deprecated)`	`boolean` הוצא משימוש: פלט בלבד. במקומו צריך להשתמש ב-`canMoveItemWithinDrive` או ב-`canMoveItemOutOfDrive`.
`capabilities.canChangeCopyRequiresWriterPermission`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לשנות את ההגבלה `copyRequiresWriterPermission` בקובץ הזה.
`capabilities.canMoveItemIntoTeamDrive (deprecated)`	`boolean` הוצא משימוש: פלט בלבד. במקום זאת, אתם צריכים להשתמש ב-`canMoveItemOutOfDrive`.
`capabilities.canUntrash`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לשחזר את הקובץ הזה מהאשפה.
`capabilities.canModifyContent`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול לשנות את התוכן של הקובץ הזה.
`capabilities.canMoveItemWithinTeamDrive (deprecated)`	`boolean` הוצא משימוש: פלט בלבד. במקום זאת, אתם צריכים להשתמש ב-`canMoveItemWithinDrive`.
`capabilities.canMoveItemOutOfTeamDrive (deprecated)`	`boolean` הוצא משימוש: פלט בלבד. במקום זאת, אתם צריכים להשתמש ב-`canMoveItemOutOfDrive`.
`capabilities.canDeleteChildren`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול למחוק צאצאים של התיקייה. הערך הוא False אם הפריט הוא לא תיקייה. השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`capabilities.canMoveChildrenOutOfTeamDrive (deprecated)`	`boolean` הוצא משימוש: פלט בלבד. במקום זאת, אתם צריכים להשתמש ב-`canMoveChildrenOutOfDrive`.
`capabilities.canMoveChildrenWithinTeamDrive (deprecated)`	`boolean` הוצא משימוש: פלט בלבד. במקום זאת, אתם צריכים להשתמש ב-`canMoveChildrenWithinDrive`.
`capabilities.canTrashChildren`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להעביר לאשפה את הצאצאים של התיקייה הזו. הערך הוא False אם הפריט הוא לא תיקייה. השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`capabilities.canMoveItemOutOfDrive`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להעביר את הפריט הזה אל מחוץ לאחסון הזה על ידי שינוי ההורה שלו. הערה: בקשה לשינוי ההורה של הפריט עדיין עשויה להיכשל, בהתאם לרכיב ההורה החדש שנוסף.
`capabilities.canAddMyDriveParent`	`boolean` פלט בלבד. האם המשתמש הנוכחי יכול להוסיף הורה לפריט מבלי להסיר הורה קיים באותה בקשה. לא מאוכלס עבור קבצים באחסון שיתופי.
`capabilities.canRemoveMyDriveParent`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להסיר הורה מהפריט בלי להוסיף עוד הורה באותה בקשה. לא מאוכלס עבור קבצים באחסון שיתופי.
`capabilities.canMoveItemWithinDrive`	`boolean` פלט בלבד. אם המשתמש הנוכחי יכול להעביר את הפריט בתוך האחסון הזה. הערה: בקשה לשינוי ההורה של הפריט עדיין עשויה להיכשל, בהתאם להורה החדש שמוסיפים ולהורה שהוסר.
`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)` פלט בלבד. אם הקובץ הועבר לאשפה באופן מפורש, המשתמש שהעביר אותו לאשפה. השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`thumbnailVersion`	`string (int64 format)` פלט בלבד. גרסת התמונה הממוזערת לשימוש בביטול תוקף של מטמון תמונות ממוזערות.
`trashedTime`	`string` פלט בלבד. השעה שבה הפריט הועבר לאשפה (תאריך ושעה של RFC 3339). השדה הזה מאוכלס רק עבור פריטים בתיקיות אחסון שיתופי.
`modifiedByMe`	`boolean` פלט בלבד. האם הקובץ שינה את הקובץ על ידי המשתמש הזה.
`permissionIds[]`	`string` פלט בלבד. file.list של מזהי ההרשאות של המשתמשים שיש להם גישה לקובץ הזה.
`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` פלט בלבד. מפתח הצמצם ששימש ליצירת התמונה (מספר 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.create`.
`shortcutDetails.targetId`	`string` מזהה הקובץ שאליו מפנה קיצור הדרך הזה. ניתן להגדיר רק בבקשות `files.create`.
`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`) }, "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` פלט בלבד. אם הגבלת התוכן חלה על המערכת, למשל בגלל חתימה דיגיטלית. המשתמשים לא יכולים לשנות או להסיר את הגבלות התוכן המוגבל על ידי המערכת.

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

REST Resource: files

משאב: קובץ

ContentRestriction

שיטות

`copy`

`create`

`delete`

`emptyTrash`

`export`

`generateIds`

`get`

`list`

`listLabels`

`modifyLabels`

`update`

`watch`