44 releases
0.7.0 | Jul 19, 2023 |
---|---|
0.6.0 | Mar 31, 2023 |
0.5.1 | Nov 18, 2022 |
0.4.1 | Jul 13, 2022 |
0.1.2 | Jul 10, 2020 |
#1449 in Web programming
1,384 downloads per month
Used in cio-api
310KB
6.5K
SLoC
google-drive
A fully generated, opinionated API client library for Google Drive.
API Details
Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.
Contact
name | url |
---|---|
https://google.com |
License
name | url |
---|---|
Creative Commons Attribution 3.0 | http://creativecommons.org/licenses/by/3.0/ |
Client Details
This client is generated from the Google Drive OpenAPI
specs based on API spec version v3
. This way it will remain
up to date as features are added. The documentation for the crate is generated
along with the code to make this library easy to use.
To install the library, add the following to your Cargo.toml
file.
[dependencies]
google-drive = "0.7.0"
Basic example
Typical use will require intializing a Client
. This requires
a user agent string and set of credentials.
use google_drive::Client;
let google drive = Client::new(
String::from("client-id"),
String::from("client-secret"),
String::from("redirect-uri"),
String::from("token"),
String::from("refresh-token")
);
Alternatively, the library can search for most of the variables required for the client in the environment:
GOOGLE DRIVE_CLIENT_ID
GOOGLE DRIVE_CLIENT_SECRET
GOOGLE DRIVE_REDIRECT_URI
And then you can create a client from the environment.
use google_drive::Client;
let google drive = Client::new_from_env(
String::from("token"),
String::from("refresh-token")
);
It is okay to pass empty values for token
and refresh_token
. In
the initial state of the client, you will not know these values.
To start off a fresh client and get a token
and refresh_token
, use the following.
use google_drive::Client;
async fn do_call() {
let mut google drive = Client::new_from_env("", "");
// Get the URL to request consent from the user.
// You can optionally pass in scopes. If none are provided, then the
// resulting URL will not have any scopes.
let user_consent_url = google drive.user_consent_url(&["some-scope".to_string()]);
// In your redirect URL capture the code sent and our state.
// Send it along to the request for the token.
let code = "thing-from-redirect-url";
let state = "state-from-redirect-url";
let mut access_token = google drive.get_access_token(code, state).await.unwrap();
// You can additionally refresh the access token with the following.
// You must have a refresh token to be able to call this function.
access_token = google drive.refresh_access_token().await.unwrap();
}
Dependencies
~22–38MB
~725K SLoC