File

Document file.

Name	Description	Type
`file_ver`	The file version.	FileVer
`title`	The title of the file.	string
`extension`	File extension, not including the dot (e.g. "doc").	string
`size`	The logical size of the file in bytes. The efspSizePrecision value describes how the size information should be understood.	number
`size_precision`	The file size precision. If the file size precision is 'exact', the size can be used for reading the file content. If the precision is 'unknown', the size field should not be used at all.	FileSizePrecision
`created_at_utc`	The time in UTC the file was originally created.	google.protobuf.Timestamp
`accessed_at_utc`	The time in UTC the file was last accessed (e.g. read).	google.protobuf.Timestamp
`written_at_utc`	The time in UTC the file was last written to.	google.protobuf.Timestamp
`changed_at_utc`	The time in UTC the file was last written to or its attributes were changed.	google.protobuf.Timestamp
`guid`	GUID of the file.	string
`md5_checksum`	MD5 checksum of the file if available. Can be null.	string
`is_missing`	True, if the file is missing.	boolean
`is_content_volatile`	True if the file's physical content may change without a version number change, as long as the logical content remains the same. Physical consistency is only guaranteed within a single download session.	boolean
`flags`	Object file flags.	OBJECTFILEFLAGS
`master_storage_file_ref`	An optional File reference (GUID) to external Master Storage API. Only used with Master Storage, otherwise empty.	string

Example

{
  "file_ver": {
    "file_id": {
      "type": 3 /* Enum: FileIDType */,
      "internal_id": 0,
      "external_repository_id": "<external repository id>"
    },
    "type": 3 /* Enum: FileVerType */,
    "internal_version": 0,
    "external_repository_version": "<external repository version>",
    "external_repository_sort_key": 0
  },
  "title": "<title>",
  "extension": "<extension>",
  "size": 0,
  "size_precision": 2 /* Enum: FileSizePrecision */,
  "created_at_utc": {
    "seconds": 0,
    "nanos": 0
  } /* google.protobuf.Timestamp */,
  "accessed_at_utc": {
    "seconds": 0,
    "nanos": 0
  } /* google.protobuf.Timestamp */,
  "written_at_utc": {
    "seconds": 0,
    "nanos": 0
  } /* google.protobuf.Timestamp */,
  "changed_at_utc": {
    "seconds": 0,
    "nanos": 0
  } /* google.protobuf.Timestamp */,
  "guid": "<guid>",
  "md5_checksum": "<md5 checksum>",
  "is_missing": false,
  "is_content_volatile": false,
  "flags": {
    "all": false,
    "can_be_edited_externally": false
  },
  "master_storage_file_ref": "<master storage file ref>"
}

File

Example​

Example