REST Resource: files

משאב: קובץ

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

ל-methods מסוימות של משאבים (כמו 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

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

parents[]

string

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

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

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

shared

boolean

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

lastModifyingUser

object (User)

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

owners[]

object (User)

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

headRevisionId

string

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

sharingUser

object (User)

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

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

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