REST Resource: files

משאב: קובץ

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

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

ייצוג 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

פלט בלבד. מזהה את סוג המשאב הזה. ערך: המחרוזת הקבועה "drive#file".

driveId

string

פלט בלבד. המזהה של האחסון השיתופי שהקובץ נמצא בו. השדה מאוכלס רק לפריטים בתיקיות אחסון שיתופי.

fileExtension

string

פלט בלבד. הרכיב האחרון של fullFileExtension. אפשרות זו זמינה רק לקבצים עם תוכן בינארי ב-Google Drive.

copyRequiresWriterPermission

boolean

צריך להשבית את האפשרויות להעתיק, להדפיס או להוריד את הקובץ הזה לקוראים ולבעלי הרשאת תגובה.

md5Checksum

string

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

אם נוצר קובץ מסוג Google Docs MIME, התוכן שהועלה מיובא, אם אפשר. הפורמטים הנתמכים לייבוא מופיעים במשאב 'מידע כללי'.

parents[]

string

המזהים של תיקיות ההורה שמכילות את הקובץ.

אם לא מציינים שום אפשרות כחלק מבקשת היצירה, הקובץ ימוקם ישירות בתיקייה 'האחסון שלי' של המשתמש. אם קובץ המקור לא צוין כחלק מבקשת ההעתקה, הקובץ יורש את כל תבניות ההורה הגלויות של קובץ המקור. בקשות מסוג files.update חייבות להשתמש בפרמטרים addParents ו-removeParents כדי לשנות את רשימת תבניות ההורה.

shared

boolean

פלט בלבד. האם הקובץ שותף. לא מאוכלס עבור פריטים בתיקיות אחסון שיתופי.

lastModifyingUser

object (User)

פלט בלבד. המשתמש האחרון שביצע שינויים בקובץ.

owners[]

object (User)

פלט בלבד. הבעלים של הקובץ. רק לקבצים מסוימים מדור קודם יכול להיות יותר מבעלים אחד. השדה הזה לא מאוכלס בפריטים בתיקיות אחסון שיתופי.

headRevisionId

string

פלט בלבד. מזהה של גרסת ה-head של הקובץ. אפשרות זו זמינה כרגע רק לקבצים עם תוכן בינארי ב-Google Drive.

sharingUser

object (User)

פלט בלבד. המשתמש ששיתף את הקובץ עם המשתמש ששלח את הבקשה, אם הדבר רלוונטי.

size

string (int64 format)

פלט בלבד. הגודל בבייטים של blobs וקובצי עריכה של צד ראשון. לא יאוכלסו בקבצים שאין להם גודל, כמו קיצורי דרך ותיקיות.

viewersCanCopyContent
(deprecated)

boolean

הוצאה משימוש: יש להשתמש במקום זאת ב-copyRequiresWriterPermission.

permissions[]

object (Permission)

פלט בלבד. רשימת ההרשאות המלאה לקובץ. האפשרות הזו תהיה זמינה רק אם המשתמש ששלח את הבקשה יכול לשתף את הקובץ. לא מאוכלס עבור פריטים בתיקיות אחסון שיתופי.

hasThumbnail

boolean

פלט בלבד. אם הקובץ הזה כולל תמונה ממוזערת. לא ניתן לדעת אם לאפליקציה שביקשה גישה יש גישה לתמונה הממוזערת. כדי לבדוק את הגישה, מחפשים את השדה imageLink [קישור_תמונה].

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 date-time).

modifiedTime

string

הפעם האחרונה שבה הקובץ שונה על ידי מישהו (RFC 3339 תאריך ושעה).

חשוב לשים לב שההגדרה של modifiedTime גם מעדכנת את modifiedByMeTime עבור המשתמש.

modifiedByMeTime

string

פלט בלבד. הפעם האחרונה שהמשתמש שינה את הקובץ (RFC 3339 date-time).

viewedByMeTime

string

הפעם האחרונה שהמשתמש צפה בקובץ (RFC 3339 date-time).

sharedWithMeTime

string

פלט בלבד. השעה שבה הקובץ שותף עם המשתמש, אם רלוונטי (RFC 3339 תאריך ושעה).

quotaBytesUsed

string (int64 format)

פלט בלבד. מספר הבייטים של מכסת האחסון שהקובץ משתמש בהם. ההרשאה הזו כוללת את גרסת ה-head וגם גרסאות קודמות שבהן האפשרות 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))

אוסף של צמדי מפתח/ערך שרירותיים שגלויים לכל האפליקציות.

רשומות עם ערכי null נמחקות בבקשות לעדכון ולהעתקה.

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }

appProperties

map (key: string, value: value (Value format))

אוסף של צמדי מפתח/ערך שרירותיים פרטיים לאפליקציה המבקשת.

רשומות עם ערכי null נמחקות בבקשות לעדכון ולהעתקה.

ניתן לאחזר את המאפיינים האלה רק באמצעות בקשה מאומתת. בבקשה מאומתת נעשה שימוש באסימון גישה שהתקבל עם מזהה לקוח של OAuth 2. לא ניתן להשתמש במפתח API כדי לאחזר נכסים פרטיים.

אובייקט שמכיל רשימה של "key": value זוגות. דוגמה: { "name": "wrench", "mass": "1.3kg", "count": "3" }

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 date-time). השדה מאוכלס רק לפריטים בתיקיות אחסון שיתופי.

modifiedByMe

boolean

פלט בלבד. האם הקובץ השתנה על ידי המשתמש הזה.

permissionIds[]

string

פלט בלבד. files.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-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.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)
  },
  "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

נרשמת לשינויים בקובץ.