google-drive3 库允许访问 Google drive 服务的所有功能。

此文档是从 drive crate 版本 3.0.0+20220225 生成的，其中 20220225 是由 mako 代码生成器 v3.0.0 构建的 drive:v3 方案的精确修订。

有关 drive v3 API 的其他所有信息，请参阅 官方文档网站。

补丁详情

我们对原始 crate 进行了修复，以添加对 Range 头的支持，该头用于 get 操作。

功能

从中央 中心 轻松处理以下 资源 ...

• 关于
• 获取
• 更改
• 获取起始页令牌，列表 和 监控
• 频道
• 停止
• 评论
• 创建，删除，获取，列表 和 更新
• 驱动器
• 创建，删除，获取，隐藏，列出，取消隐藏和更新
• 文件
• 复制，创建，删除，清空回收站，导出，生成ID，获取，列出，更新和监视
• 权限
• 创建，删除，获取，列出和更新
• 回复
• 创建，删除，获取，列出和更新
• 修订版
• 删除，获取，列出和更新
• 团队驱动器
• 创建，删除，获取，列出和更新

由...支持的上传

• 创建文件
• 更新文件

由...支持的下载数据

• 导出文件
• 获取文件
• 监视文件
• 获取修订版

由...支持的订阅

• 列出更改
• 监视更改
• 创建文件
• 获取文件
• 监视文件

此库的结构

API结构如下几个主要项目

• 枢纽
  • 一个中心对象，用于维护状态并允许访问所有活动
  • 创建方法构建器，它允许访问单个调用构建器
• 资源
  • 可以应用活动的主要类型
  • 一系列属性和部分
  • 部分
    • 一系列属性
    • 永远不会直接在活动中使用
• 活动
  • 应用于资源的操作

所有结构都带有适用的特性和标记，以进一步分类它们并方便浏览。

一般来说，您可以这样调用活动

let r = hub.resource().activity(...).doit().await

或者具体来说...

let r = hub.files().copy(...).doit().await
let r = hub.files().create(...).doit().await
let r = hub.files().delete(...).doit().await
let r = hub.files().empty_trash(...).doit().await
let r = hub.files().export(...).doit().await
let r = hub.files().generate_ids(...).doit().await
let r = hub.files().get(...).doit().await
let r = hub.files().list(...).doit().await
let r = hub.files().update(...).doit().await
let r = hub.files().watch(...).doit().await

resource()和activity(...)调用创建构建器。第二个处理Activities，支持各种方法来配置即将进行的操作（此处未显示）。它设计为必须立即指定所有必需的参数（即(...)），而所有可选的可以按照需求构建。doit()方法执行与服务器的实际通信并返回相应的结果。

用法

设置您的项目

要使用此库，您需要将以下行放入您的Cargo.toml文件中

[dependencies]
google-drive3 = "*"
serde = "^1.0"
serde_json = "^1.0"

一个完整的示例

extern crate hyper;
extern crate hyper_rustls;
extern crate google_drive3 as drive3;
use drive3::{Result, Error};
use std::default::Default;
use drive3::{DriveHub, oauth2, hyper, hyper_rustls};

// Get an ApplicationSecret instance by some means. It contains the `client_id` and 
// `client_secret`, among other things.
let secret: oauth2::ApplicationSecret = Default::default();
// Instantiate the authenticator. It will choose a suitable authentication flow for you, 
// unless you replace  `None` with the desired Flow.
// Provide your own `AuthenticatorDelegate` to adjust the way it operates and get feedback about 
// what's going on. You probably want to bring in your own `TokenStorage` to persist tokens and
// retrieve them from storage.
let auth = oauth2::InstalledFlowAuthenticator::builder(
        secret,
        oauth2::InstalledFlowReturnMethod::HTTPRedirect,
    ).build().await.unwrap();
let mut hub = DriveHub::new(hyper::Client::builder().build(hyper_rustls::HttpsConnector::with_native_roots()), auth);
// You can configure optional parameters by calling the respective setters at will, and
// execute the final call using `doit()`.
// Values shown here are possibly random and not representative !
let result = hub.files().list()
             .team_drive_id("et")
             .supports_team_drives(true)
             .supports_all_drives(false)
             .spaces("amet.")
             .q("takimata")
             .page_token("amet.")
             .page_size(-20)
             .order_by("ipsum")
             .include_team_drive_items(true)
             .include_permissions_for_view("Lorem")
             .include_items_from_all_drives(false)
             .drive_id("dolor")
             .corpus("ea")
             .corpora("ipsum")
             .doit().await;

match result {
    Err(e) => match e {
        // The Error enum provides details about what exactly happened.
        // You can also just use its `Debug`, `Display` or `Error` traits
         Error::HttpError(_)
        |Error::Io(_)
        |Error::MissingAPIKey
        |Error::MissingToken(_)
        |Error::Cancelled
        |Error::UploadSizeLimitExceeded(_, _)
        |Error::Failure(_)
        |Error::BadRequest(_)
        |Error::FieldClash(_)
        |Error::JsonDecodeError(_, _) => println!("{}", e),
    },
    Ok(res) => println!("Success: {:?}", res),
}

处理错误

系统产生的所有错误都作为Result枚举提供，作为doit()方法的返回值，或者作为可能的中继结果传递给Hub Delegate或Authenticator Delegate。