用 Rust 玩转 Google Sheets API

在构建最小化可行产品 (MVP) 或原型时，Google Sheets API 堪称神器。它不仅免去了数据库的繁琐设置，还提供了 Google Sheets 这一强大的前端界面，让你轻松管理数据。本文将带你一步步使用 Rust 语言，解锁 Google Sheets API 的强大功能。

项目搭建

首先，创建一个新的 Rust 项目：

cargo new sheets_api_rust

接下来，在 Cargo.toml 文件中添加必要的依赖：

[package]
name = "sheets_api_rust"
version = "0.1.0"
edition = "2018"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

[dependencies]
google-sheets4 = "*"
hyper = "^0.14"
hyper-rustls = "^0.22"
serde = "^1.0"
serde_json = "^1.0"
yup-oauth2 = "^5.0"
tokio = { version = "~1.2", features = [
    "macros",
    "io-util",
    "rt",
    "rt-multi-thread",
    "fs",
] }

API 密钥和凭据

在使用 Google Sheets API 之前，你需要获取 Google Cloud Platform 项目的 API 密钥。

1. 访问 Google Cloud Console (https://console.cloud.google.com/) 并创建一个新项目。
2. 在项目中启用 Google Sheets API。
3. 创建一个服务帐户并下载 JSON 格式的凭据文件。

将下载的凭据文件重命名为 credentials.json 并放置在项目根目录下。该文件的内容应类似于：

{
  "installed": {
    "client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
    "project_id": "YOUR_PROJECT_ID",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://accounts.google.com/o/oauth2/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uris": ["urn:ietf:wg:oauth:2.0:oob", "http://localhost"]
  }
}

Rust 代码实现

最后，打开 src/main.rs 文件，并将以下代码粘贴进去：

// This is a modified version of the example at:
// https://github.com/Byron/google-apis-rs/tree/main/gen/sheets4

extern crate google_sheets4 as sheets4;
extern crate hyper;
extern crate hyper_rustls;
extern crate yup_oauth2 as oauth2;
use sheets4::Error;
use sheets4::Sheets;

#[tokio::main]
async fn main() {
    // 读取应用密钥
    let secret = yup_oauth2::read_application_secret("credentials.json")
        .await
        .expect("无法读取应用密钥");

    // 实例化身份验证器
    let auth = yup_oauth2::InstalledFlowAuthenticator::builder(
        secret,
        yup_oauth2::InstalledFlowReturnMethod::HTTPRedirect,
    )
    .persist_tokens_to_disk("tokencache.json")
    .build()
    .await
    .unwrap();

    // 创建 Sheets 服务客户端
    let hub = Sheets::new(
        hyper::Client::builder().build(hyper_rustls::HttpsConnector::with_native_roots()),
        auth,
    );

    // 获取指定电子表格的信息
    let result = hub
        .spreadsheets()
        .get("YOUR_SPREADSHEET_ID") // 替换为你的电子表格 ID
        .doit()
        .await;

    // 处理结果
    match result {
        Err(e) => match e {
            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!("操作成功: {:?}", res),
    }
}

请将代码中的 YOUR_SPREADSHEET_ID 替换为你的 Google Sheets 电子表格 ID。 你可以在浏览器地址栏中找到它，格式类似于 https://docs.google.com/spreadsheets/d/YOUR_SPREADSHEET_ID/edit#gid=0。

运行程序

完成以上步骤后，运行以下命令即可体验 Google Sheets API 的强大功能:

cargo run

程序会尝试获取指定电子表格的信息，并在控制台输出结果。

探索更多功能

现在你已经成功使用 Rust 连接到 Google Sheets API，可以进一步探索 sheets4  crate 提供的更多功能，例如读取、写入、更新和删除电子表格数据等。

• sheets4 文档: https://docs.rs/google-sheets4/latest/google_sheets4/

通过学习和使用 Google Sheets API，你可以更高效地构建数据驱动的应用程序，并充分利用 Google Sheets 强大的功能。