REST Resource: files

משאב: קובץ

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

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

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

פלט בלבד. סוג הקובץ. הערך הוא תמיד drive#file.

userPermission

object (Permission)

פלט בלבד. ההרשאות של המשתמש המאומת בקובץ הזה.

fileExtension

string

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

md5Checksum

string

פלט בלבד. סיכום ביקורת (checksum) MD5 לתוכן של הקובץ הזה. השדה הזה יאוכלס רק בקבצים עם תוכן שמאוחסן ב-Google Drive. הוא לא מאוכלס בעורכי Docs או בקובצי קיצור דרך.

ownerNames[]

string

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

lastModifyingUserName

string

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

editable
(deprecated)

boolean

פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב capabilities/canEdit.

writersCanShare

boolean

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

downloadUrl

string

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

mimeType

string

סוג ה-MIME של הקובץ. אפשר לשנות את זה רק כשמעלים תוכן חדש. אפשר להשאיר את השדה הזה ריק, וה-mimetype ייקבע לפי סוג ה-MIME של התוכן שהועלה.

driveId

string

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

parents[]

object (ParentReference)

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

לקובץ יכולה להיות רק תיקיית הורה אחת. אי אפשר לציין כמה הורים.

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

appDataContents

boolean

פלט בלבד. האם הקובץ הזה נמצא בתיקייה Application Data (נתוני אפליקציה).

shared

boolean

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

lastModifyingUser

object (User)

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

owners[]

object (User)

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

headRevisionId

string

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

properties[]

object (Property)

רשימת הנכסים.

copyable
(deprecated)

boolean

פלט בלבד. הוצא משימוש: במקומו צריך להשתמש ברכיב capabilities/canCopy.

etag

string

פלט בלבד. ה-ETag של הקובץ.

sharingUser

object (User)

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

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.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

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