sheets

Google Sheets 的完全生成、具有意见的 API 客户端库。

API 详细信息

读取和写入 Google Sheets。

API 服务条款

联系方式

许可证

客户端详细信息

此客户端基于 API 规范版本 v4 从 Google Sheets OpenAPI 规范 生成。这样，它将随着新功能的添加而保持最新。库的文档与代码一起生成，以便轻松使用。

要安装库，请将以下内容添加到您的 Cargo.toml 文件中。

[dependencies]
sheets = "0.7.0"

基本示例

典型使用需要初始化一个 Client。这需要一个用户代理字符串和一组凭证。

use sheets::Client;

let google sheets = Client::new(
    String::from("client-id"),
    String::from("client-secret"),
    String::from("redirect-uri"),
    String::from("token"),
    String::from("refresh-token")
);

或者，库可以在环境中搜索客户端所需的大部分变量

• GOOGLE SHEETS_CLIENT_ID
• GOOGLE SHEETS_CLIENT_SECRET
• GOOGLE SHEETS_REDIRECT_URI

然后您可以从环境中创建客户端。

use sheets::Client;

let google sheets = Client::new_from_env(
    String::from("token"),
    String::from("refresh-token")
);

对于 token 和 refresh_token，传递空值是可以的。在客户端的初始状态下，您将不知道这些值。

要启动新的客户端并获取 token 和 refresh_token，请使用以下命令。

use sheets::Client;

async fn do_call() {
    let mut google sheets = 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 sheets.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 sheets.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 sheets.refresh_access_token().await.unwrap();
}