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 physical content is volatile. I.e. the physical content can change without the version number change, as long as the logical content is same. The file content is guaranteed to stay physically consistent within single download session only. | boolean |
Example
{
"file_ver": {
"file_id": {
"type": 3 /* Enum: FileIDType */,
"internal_id": 0,
"external_repository_id": "<!< External file id.>"
},
"type": 3 /* Enum: FileVerType */,
"internal_version": 0,
"external_repository_version": "<external_repository_version>",
"external_repository_sort_key": 0
},
"title": "<!< The title of the file.>",
"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 of the file.>",
"md5_checksum": "<md5_checksum>",
"is_missing": false,
"is_content_volatile": false
}