drive-v3

A Rust library to send request to the Google Drive v3 API.

Warning

As of right now the only supported endpoints are about and files (except for the modifyLabels and watch functions).

Installation

Use cargo to add drive-v3 to your project:

[dependencies]
drive-v3 = "0.3.0"

Usage

use std::path::PathBuf;
use drive_v3::{Error, Credentials, Drive};

fn main() -> Result<(), Error> {
    // Path to the client_secrets file created when enabling the Drive API in Google Cloud
    // if you do not have a client secrets file, follow the steps to setup an environment in this link:
    // https://developers.google.com/drive/api/quickstart/python#set_up_your_environment
    // after completing 'Authorize credentials for a desktop application' you can save the secrets file
    let client_secrets = "my_client_secrets.json";

    // Path where created credentials will be stored
    // if there are no stored credentials the user will be prompted to authorize via the browser when
    // the user authorizes the app the credentials will be stored in this path
    let credentials_storage = PathBuf::from("my_super_secret_credentials.json");

    // The scopes that the API can access
    // these are the only scopes currently used in the library, if you just want to read the files in
    // a drive only the first one is required
    let my_scopes: [&'static str; 2] = [
        "https://www.googleapis.com/auth/drive.metadata.readonly",
        "https://www.googleapis.com/auth/drive.file",
    ];

    let mut credentials = None;

    // Check if there are stored credentials
    if credentials_storage.exists() {
        let mut stored_credentials = Credentials::from_file(&credentials_storage, &my_scopes)?;

        // Refresh the credentials if they have expired
        if !stored_credentials.are_valid() {
            stored_credentials.refresh()?;

            // Save them so we don't have to refresh them every time
            stored_credentials.store(&credentials_storage)?;
        }

        // Set the credentials
        credentials = Some(stored_credentials);
    }

    // We'll have to prompt the user for authorization if the stored credentials don't work
    if credentials.is_none() {
        let created_credentials = Credentials::from_client_secrets_file(&client_secrets, &my_scopes)?;

        // Save them so we don't have to prompt the user again
        created_credentials.store(&credentials_storage)?;

        // Set the credentials
        credentials = Some(created_credentials);
    }

    // Create a Drive
    // this class makes all the request to the Google Drive API
    let my_drive = Drive::new( &credentials.unwrap() );

    // Lets list the files in a Drive
    let file_list = my_drive.files.list()
        .fields("files(name, id, mimeType)") // Set what fields will be returned
        .q("name = 'file_im_looking_for' and not trashed") // search for specific files
        .execute()?;

    if let Some(files) = file_list.files {
       for file in &files {
            println!("{}", file);
        }
    }

    Ok(())
}

Contributing

Pull requests are welcome. For major changes, please open an issue first.

License

MIT