Struct google_drive::File

pub struct File {

    pub mime_type: String,
    pub modified_by_me_time: String,
    pub thumbnail_link: String,
    pub thumbnail_version: String,
    pub viewed_by_me_time: String,
    pub id: String,
    pub sharing_user: Option<User>,
    pub size: String,
    pub video_media_metadata: Option<FileVideoMediaMetadata>,
    pub last_modifying_user: Option<User>,
    pub folder_color_rgb: String,
    pub app_properties: HashMap<String, String>,
    pub capabilities: Option<FileCapabilities>,
    pub properties: HashMap<String, String>,
    pub web_view_link: String,
    pub version: String,
    pub parents: Vec<String>,
    pub md5_checksum: String,
    pub export_links: HashMap<String, String>,
    pub copy_requires_writer_permission: bool,
    pub full_file_extension: String,
    pub original_filename: String,
    pub image_media_metadata: Option<FileImageMediaMetadata>,
    pub description: String,
    pub modified_time: String,
    pub kind: String,
    pub created_time: String,
    pub quota_bytes_used: String,
    pub trashed_time: String,
    pub shared_with_me_time: String,
    pub icon_link: String,
    pub owners: Vec<User>,
    pub name: String,
    pub web_content_link: String,
    pub trashing_user: Option<User>,
    pub drive_id: String,
    pub spaces: Vec<String>,
    pub permission_ids: Vec<String>,
    pub content_hints: Option<FileContentHints>,
    pub file_extension: String,
    pub starred: bool,
    pub head_revision_id: String,
    pub permissions: Vec<Permission>,
}

A file.

From: https://developers.google.com/drive/api/v3/reference/files#resource

Fields

mime_type: String

Whether this file has a thumbnail. This does not indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field. The MIME type of the file. Google Drive will attempt to automatically detect an appropriate value from uploaded content if no value is provided. The value cannot be changed unless a new revision is uploaded. If a file is created with a Google Doc MIME type, the uploaded content will be imported if possible. The supported import formats are published in the About resource.

modified_by_me_time: String

The last time the file was modified by the user (RFC 3339 date-time).

thumbnail_link: String

A short-lived link to the file’s thumbnail, if available. Typically lasts on the order of hours. Only populated when the requesting app can access the file’s content.

thumbnail_version: String

The thumbnail version for use in thumbnail cache invalidation.

viewed_by_me_time: String

Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder. Whether the file was created or opened by the requesting app. Whether users with only writer permission can modify the file’s permissions. Not populated for items in shared drives. Whether the user owns the file. Not populated for items in shared drives. The last time the file was viewed by the user (RFC 3339 date-time).

id: String

The ID of the file.

sharing_user: Option<User>

The user who shared the file with the requesting user, if applicable.

size: String

The size of the file’s content in bytes. This is only applicable to files with binary content in Google Drive.

video_media_metadata: Option<FileVideoMediaMetadata>

Additional metadata about video media. This may not be available immediately upon upload.

last_modifying_user: Option<User>

The last user to modify the file.

folder_color_rgb: String

The color for a folder as an RGB hex string. The supported colors are published in the folderColorPalette field of the About resource. If an unsupported color is specified, the closest color in the palette will be used instead.

app_properties: HashMap<String, String>

A collection of arbitrary key-value pairs which are private to the requesting app. Entries with null values are cleared in update and copy requests.

capabilities: Option<FileCapabilities>

Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take.

properties: HashMap<String, String>

A collection of arbitrary key-value pairs which are visible to all apps. Entries with null values are cleared in update and copy requests.

web_view_link: String

A link for opening the file in a relevant Google editor or viewer in a browser.

version: String

A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the user.

parents: Vec<String>

The IDs of the parent folders which contain the file. If not specified as part of a create request, the file will be placed directly in the user’s My Drive folder. If not specified as part of a copy request, the file will inherit any discoverable parents of the source file. Update requests must use the addParents and removeParents parameters to modify the parents list.

md5_checksum: String

The MD5 checksum for the content of the file. This is only applicable to files with binary content in Google Drive.

export_links: HashMap<String, String>

Links for exporting Google Docs to specific formats.

copy_requires_writer_permission: bool

Whether the file has been shared. Not populated for items in shared drives. Whether the options to copy, print, or download this file, should be disabled for readers and commenters.

full_file_extension: String

The full file extension extracted from the name field. May contain multiple concatenated extensions, such as “tar.gz”. This is only available for files with binary content in Google Drive. This is automatically updated when the name field changes, however it is not cleared if the new name does not contain a valid extension.

original_filename: String

The original filename of the uploaded content if available, or else the original value of the name field. This is only available for files with binary content in Google Drive.

image_media_metadata: Option<FileImageMediaMetadata>

Additional metadata about image media, if available.

description: String

A short description of the file.

modified_time: String

The last time the file was modified by anyone (RFC 3339 date-time). Note that setting modifiedTime will also update modifiedByMeTime for the user.

kind: String

Whether the file has been viewed by this user. Whether the file has been modified by this user. Identifies what kind of resource this is. Value: the fixed string “drive#file”.

created_time: String

The time at which the file was created (RFC 3339 date-time).

quota_bytes_used: String

The number of storage quota bytes used by the file. This includes the head revision as well as previous revisions with keepForever enabled.

trashed_time: String

The time that the item was trashed (RFC 3339 date-time). Only populated for items in shared drives.

shared_with_me_time: String

The time at which the file was shared with the user, if applicable (RFC 3339 date-time).

icon_link: String

A static, unauthenticated link to the file’s icon.

owners: Vec<User>

The owners of the file. Currently, only certain legacy files may have more than one owner. Not populated for items in shared drives.

name: String

The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant.

web_content_link: String

A link for downloading the content of the file in a browser. This is only available for files with binary content in Google Drive.

trashing_user: Option<User>

If the file has been explicitly trashed, the user who trashed it. Only populated for items in shared drives.

drive_id: String

ID of the shared drive the file resides in. Only populated for items in shared drives.

spaces: Vec<String>

The list of spaces which contain the file. The currently supported values are ‘drive’, ‘appDataFolder’ and ‘photos’.

permission_ids: Vec<String>

List of permission IDs for users with access to this file.

content_hints: Option<FileContentHints>

Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file, and other users cannot see files in the owner’s trash. Additional information about the content of the file. These fields are never populated in responses.

file_extension: String

The final component of fullFileExtension. This is only available for files with binary content in Google Drive.

starred: bool

Whether any users are granted file access directly on this file. This field is only populated for shared drive files. Whether the user has starred the file.

head_revision_id: String

The ID of the file’s head revision. This is currently only available for files with binary content in Google Drive.

permissions: Vec<Permission>

The full list of permissions for the file. This is only available if the requesting user can share the file. Not populated for items in shared drives.

Trait Implementations

impl Clone for File

fn clone(&self) -> File

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for File

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for File

fn default() -> File

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for File

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Serialize for File

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.