REST Resource: files

מקור מידע: קובץ

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

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

ייצוג ב-JSON
{
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "hasThumbnail": boolean,
  "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,
  "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,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean,
    "canChangeItemDownloadRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean,
  "downloadRestrictions": {
    object (DownloadRestrictionsMetadata)
  }
}
שדות
parents[]

string

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

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

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

owners[]

object (User)

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

permissions[]

object (Permission)

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

spaces[]

string

פלט בלבד. רשימת המרחבים שבהם הקובץ נמצא. הערכים הנתמכים כרגע הם drive,‏ appDataFolder ו-photos.

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" }

permissionIds[]

string

פלט בלבד. files.list of permission IDs for users with access to this file.

contentRestrictions[]

object (ContentRestriction)

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

kind

string

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

driveId

string

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

fileExtension

string

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

copyRequiresWriterPermission

boolean

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

md5Checksum

string

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

contentHints

object

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

contentHints.indexableText

string

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

shared

boolean

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

lastModifyingUser

object (User)

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

headRevisionId

string

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

sharingUser

object (User)

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

size

string (int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

הוצא משימוש: במקומו צריך להשתמש ב-copyRequiresWriterPermission.

hasThumbnail

boolean

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

folderColorRgb

string

הצבע של תיקייה או קיצור דרך לתיקייה כמחרוזת הקסדצימלית של RGB. הצבעים הנתמכים מפורסמים בשדה folderColorPalette של המשאב About.

אם מציינים צבע שלא נתמך, המערכת משתמשת בצבע הכי קרוב בפלטה.

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 משתנה, אבל הוא לא מתרוקן אם השם החדש לא מכיל סיומת תקינה.

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

פלט בלבד. האם המשתמש הנוכחי יכול להעביר את הפריט הזה בתוך ה-Drive הזה. שימו לב: יכול להיות שבקשה לשינוי ההורה של הפריט תיכשל בכל זאת, בהתאם להורה החדש שמוסיפים ולהורה שמסירים.

capabilities.canShare

boolean

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

capabilities.canMoveChildrenWithinDrive

boolean

פלט בלבד. האם המשתמש הנוכחי יכול להעביר פריטים בתיקייה הזו ב-Drive. הערך הוא false אם הפריט הוא לא תיקייה. שימו לב: יכול להיות שבקשה להעברת הילד עדיין תיכשל, בהתאם לגישה של המשתמש הנוכחי לילד ולתיקיית היעד.

capabilities.canModifyContentRestriction
(deprecated)

boolean

הוצא משימוש: פלט בלבד. אפשר להשתמש ב-canModifyEditorContentRestriction, ב-canModifyOwnerContentRestriction או ב-canRemoveContentRestriction.

capabilities.canAddFolderFromAnotherDrive

boolean

פלט בלבד. האם המשתמש הנוכחי יכול להוסיף תיקייה מ-Drive אחר (תיקייה אחרת באחסון השיתופי או תיקיית 'האחסון שלי') לתיקייה הזו. הערך הוא false אם הפריט הוא לא תיקייה. השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.

capabilities.canChangeSecurityUpdateEnabled

boolean

פלט בלבד. האם המשתמש הנוכחי יכול לשנות את השדה securityUpdateEnabled במטא-נתונים של שיתוף הקישור.

capabilities.canAcceptOwnership

boolean

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

capabilities.canReadLabels

boolean

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

capabilities.canModifyLabels

boolean

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

capabilities.canModifyEditorContentRestriction

boolean

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

capabilities.canModifyOwnerContentRestriction

boolean

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

capabilities.canRemoveContentRestriction

boolean

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

capabilities.canDisableInheritedPermissions

boolean

האם משתמש יכול להשבית הרשאות שעברו בירושה.

capabilities.canEnableInheritedPermissions

boolean

האם משתמש יכול להפעיל מחדש הרשאות שעברו בירושה.

capabilities.canChangeItemDownloadRestriction

boolean

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

hasAugmentedPermissions

boolean

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

trashingUser

object (User)

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

thumbnailVersion

string (int64 format)

פלט בלבד. גרסת התמונה הממוזערת לשימוש בביטול תוקף של מטמון התמונות הממוזערות.

trashedTime

string

פלט בלבד. השעה שבה הפריט הועבר לאשפה (תאריך ושעה בפורמט RFC 3339). השדה הזה מאוכלס רק עבור פריטים באחסון שיתופי.

modifiedByMe

boolean

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

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

פלט בלבד. הצמצם ששימש ליצירת התמונה (מספר הצמצם).

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

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

resourceKey

string

פלט בלבד. מפתח שנדרש כדי לגשת לפריט דרך קישור משותף.

linkShareMetadata.securityUpdateEligible

boolean

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

linkShareMetadata.securityUpdateEnabled

boolean

פלט בלבד. האם עדכון האבטחה מופעל בקובץ הזה.

labelInfo

object

פלט בלבד. סקירה כללית של התוויות בקובץ.

labelInfo.labels[]

object (Label)

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

sha1Checksum

string

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

sha256Checksum

string

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

inheritedPermissionsDisabled

boolean

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

downloadRestrictions

object (DownloadRestrictionsMetadata)

הגבלות על הורדה חלות על הקובץ.

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

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

DownloadRestrictionsMetadata

הגבלות על הורדה חלות על הקובץ.

ייצוג ב-JSON
{
  "itemDownloadRestriction": {
    object (DownloadRestriction)
  },
  "effectiveDownloadRestrictionWithContext": {
    object (DownloadRestriction)
  }
}
שדות
itemDownloadRestriction

object (DownloadRestriction)

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

effectiveDownloadRestrictionWithContext

object (DownloadRestriction)

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

DownloadRestriction

הגבלה על העתקה והורדה של הקובץ.

ייצוג ב-JSON
{
  "restrictedForReaders": boolean,
  "restrictedForWriters": boolean
}
שדות
restrictedForReaders

boolean

האם ההורדה וההעתקה מוגבלות לקוראים.

restrictedForWriters

boolean

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

Methods

copy

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

create

יצירת קובץ חדש.

delete

מחיקה סופית של קובץ שבבעלות המשתמש בלי להעביר אותו לאשפה.

download

הורדת תוכן של קובץ.

emptyTrash

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

export

מייצאים מסמך Google Workspace לסוג ה-MIME המבוקש ומחזירים את תוכן הבייטים המיוצא.

generateIds

יוצרת קבוצה של מזהי קבצים שאפשר לספק בבקשות ליצירה או להעתקה.

get

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

list

רשימה של הקבצים של המשתמש.

listLabels

רשימת התוויות בקובץ.

modifyLabels

משנה את קבוצת התוויות שמוחלות על קובץ.

update

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

watch

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