open_lark/service/cloud_docs/sheets/v3/data_operation/
merge_cells.rs

1use reqwest::Method;
2use serde::{Deserialize, Serialize};
3
4use crate::{
5    core::{
6        api_req::ApiRequest,
7        api_resp::{ApiResponseTrait, BaseResponse, ResponseFormat},
8        constants::AccessTokenType,
9        http::Transport,
10        req_option::RequestOption,
11        SDKResult,
12    },
13    impl_executable_builder_owned,
14    service::sheets::v3::DataOperationService,
15};
16
17impl DataOperationService {
18    /// 合并单元格
19    pub async fn merge_cells(
20        &self,
21        request: MergeCellsRequest,
22        option: Option<RequestOption>,
23    ) -> SDKResult<BaseResponse<MergeCellsResponseData>> {
24        let mut api_req = request.api_request;
25        api_req.http_method = Method::POST;
26        api_req.api_path = format!(
27            "/open-apis/sheets/v3/spreadsheets/{}/sheets/{}/merge_cells",
28            request.spreadsheet_token, request.sheet_id
29        );
30        api_req.supported_access_token_types = vec![AccessTokenType::Tenant, AccessTokenType::User];
31
32        let api_resp = Transport::request(api_req, &self.config, option).await?;
33
34        Ok(api_resp)
35    }
36}
37
38/// 合并单元格请求
39#[derive(Default, Debug, Serialize, Deserialize)]
40pub struct MergeCellsRequest {
41    #[serde(skip)]
42    api_request: ApiRequest,
43    /// spreadsheet 的 token
44    spreadsheet_token: String,
45    /// sheet 的 id
46    sheet_id: String,
47    /// 合并范围
48    range: String,
49    /// 合并类型
50    merge_type: String,
51}
52
53impl MergeCellsRequest {
54    pub fn builder() -> MergeCellsRequestBuilder {
55        MergeCellsRequestBuilder::default()
56    }
57}
58
59#[derive(Default)]
60pub struct MergeCellsRequestBuilder {
61    request: MergeCellsRequest,
62}
63
64impl MergeCellsRequestBuilder {
65    pub fn spreadsheet_token(mut self, spreadsheet_token: impl ToString) -> Self {
66        self.request.spreadsheet_token = spreadsheet_token.to_string();
67        self
68    }
69
70    pub fn sheet_id(mut self, sheet_id: impl ToString) -> Self {
71        self.request.sheet_id = sheet_id.to_string();
72        self
73    }
74
75    pub fn range(mut self, range: impl ToString) -> Self {
76        self.request.range = range.to_string();
77        self
78    }
79
80    /// 设置合并类型
81    /// - MERGE_ALL: 合并所有单元格
82    /// - MERGE_COLUMNS: 按列合并
83    /// - MERGE_ROWS: 按行合并
84    pub fn merge_type(mut self, merge_type: impl ToString) -> Self {
85        self.request.merge_type = merge_type.to_string();
86        self
87    }
88
89    pub fn build(mut self) -> MergeCellsRequest {
90        self.request.api_request.body = serde_json::to_vec(&self.request).unwrap();
91        self.request
92    }
93}
94
95// Trait implementation
96impl_executable_builder_owned!(
97    MergeCellsRequestBuilder,
98    DataOperationService,
99    MergeCellsRequest,
100    BaseResponse<MergeCellsResponseData>,
101    merge_cells
102);
103
104/// 合并单元格响应体最外层
105#[derive(Deserialize, Debug)]
106pub struct MergeCellsResponseData {
107    /// 合并后的范围
108    pub merged_range: String,
109}
110
111impl ApiResponseTrait for MergeCellsResponseData {
112    fn data_format() -> ResponseFormat {
113        ResponseFormat::Data
114    }
115}
116
117#[cfg(test)]
118mod test {
119    use serde_json::json;
120
121    use super::MergeCellsResponseData;
122
123    #[test]
124    fn test_merge_cells_response() {
125        let json = json!({
126            "merged_range": "A1:C3"
127        });
128
129        let response: MergeCellsResponseData = serde_json::from_value(json).unwrap();
130        assert_eq!(response.merged_range, "A1:C3");
131    }
132}
open_lark/service/cloud_docs/sheets/v3/data_operation/merge_cells.rs

open_lark/service/cloud_docs/sheets/v3/data_operation/
merge_cells.rs
