open_lark/service/cloud_docs/sheets/
mod.rs

1//! 电子表格（Sheets）服务
2//!
3//! 提供飞书电子表格的完整API功能，支持数据读写、格式设置、公式计算等。
4//! 是处理结构化数据和报表的强大工具。
5//!
6//! # API版本
7//!
8//! - **v2**: 基础电子表格操作
9//! - **v3**: 增强功能和高级特性（推荐）
10//!
11//! # 主要功能
12//!
13//! ## V2 版本功能
14//! - 📊 数据读写操作
15//! - 🎨 单元格样式设置
16//! - 🔗 单元格合并拆分
17//! - 📏 行列操作
18//! - 📋 工作表管理
19//!
20//! ## V3 版本功能（更强大）
21//! - 📈 电子表格完整生命周期
22//! - 🔍 数据查找和替换
23//! - 🎯 条件格式化
24//! - ✅ 数据验证规则
25//! - 🔒 单元格保护
26//! - 🖼️ 浮动图片
27//! - 🔽 筛选器和筛选视图
28//!
29//! # 快速开始
30//!
31//! ```rust
32//! use open_lark::prelude::*;
33//!
34//! let client = LarkClient::builder("app_id", "app_secret")
35//!     .with_app_type(AppType::SelfBuild)
36//!     .build();
37//!
38//! // V3 版本 - 创建电子表格
39//! // let create_request = CreateSpreadsheetRequest::builder()
40//! //     .title("销售数据统计")
41//! //     .folder_token("folder_token")
42//! //     .build();
43//! // let spreadsheet = client.sheets.v3.spreadsheet.create(create_request, None).await?;
44//!
45//! // V3 版本 - 写入数据
46//! // let write_request = WriteDataToMultipleRangesRequest::builder()
47//! //     .spreadsheet_token("spreadsheet_token")
48//! //     .value_ranges(vec![...])
49//! //     .build();
50//! // client.sheets.v3.data_operation.write_data_to_multiple_ranges(write_request, None).await?;
51//! ```
52
53use std::sync::Arc;
54
55/// Sheets API v2版本
56pub mod v2;
57/// Sheets API v3版本
58pub mod v3;
59
60/// 电子表格服务
61///
62/// 聚合所有Sheets相关的API版本，提供统一的电子表格操作接口。
63/// 推荐使用v3版本获得最新功能和最佳性能。
64pub struct SheetsService {
65    /// Sheets API v2版本服务
66    pub v2: v2::V2,
67    /// Sheets API v3版本服务（推荐）
68    pub v3: v3::V3,
69}
70
71impl SheetsService {
72    /// 创建新的Sheets服务实例
73    ///
74    /// # 参数
75    /// - `config`: 客户端配置
76    pub fn new(config: Arc<crate::core::config::Config>) -> Self {
77        Self {
78            v2: v2::V2::new((*config).clone()),
79            v3: v3::V3::new((*config).clone()),
80        }
81    }
82}
open_lark/service/cloud_docs/sheets/mod.rs

open_lark/service/cloud_docs/sheets/
mod.rs
