open_lark/service/cloud_docs/sheets/v3/data_operation/
split_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        endpoints::cloud_docs::*,
10        http::Transport,
11        req_option::RequestOption,
12        standard_response::StandardResponse,
13        SDKResult,
14    },
15    impl_executable_builder_owned,
16    service::sheets::v3::DataOperationService,
17};
18
19impl DataOperationService {
20    /// 拆分单元格
21    pub async fn split_cells(
22        &self,
23        request: SplitCellsRequest,
24        option: Option<RequestOption>,
25    ) -> SDKResult<SplitCellsResponseData> {
26        let mut api_req = request.api_request;
27        api_req.http_method = Method::POST;
28        api_req.api_path = SHEETS_V3_SPREADSHEET_UNMERGE_CELLS
29            .replace("{}", &request.spreadsheet_token)
30            .replace("{}", &request.sheet_id);
31        api_req.supported_access_token_types = vec![AccessTokenType::Tenant, AccessTokenType::User];
32
33        let api_resp: BaseResponse<SplitCellsResponseData> =
34            Transport::request(api_req, &self.config, option).await?;
35        api_resp.into_result()
36    }
37}
38
39/// 拆分单元格请求
40#[derive(Default, Debug, Serialize, Deserialize)]
41pub struct SplitCellsRequest {
42    #[serde(skip)]
43    api_request: ApiRequest,
44    /// spreadsheet 的 token
45    spreadsheet_token: String,
46    /// sheet 的 id
47    sheet_id: String,
48    /// 拆分范围
49    range: String,
50}
51
52impl SplitCellsRequest {
53    pub fn builder() -> SplitCellsRequestBuilder {
54        SplitCellsRequestBuilder::default()
55    }
56}
57
58#[derive(Default)]
59pub struct SplitCellsRequestBuilder {
60    request: SplitCellsRequest,
61}
62
63impl SplitCellsRequestBuilder {
64    pub fn spreadsheet_token(mut self, spreadsheet_token: impl ToString) -> Self {
65        self.request.spreadsheet_token = spreadsheet_token.to_string();
66        self
67    }
68
69    pub fn sheet_id(mut self, sheet_id: impl ToString) -> Self {
70        self.request.sheet_id = sheet_id.to_string();
71        self
72    }
73
74    pub fn range(mut self, range: impl ToString) -> Self {
75        self.request.range = range.to_string();
76        self
77    }
78
79    pub fn build(mut self) -> SplitCellsRequest {
80        self.request.api_request.body = serde_json::to_vec(&self.request).unwrap();
81        self.request
82    }
83}
84
85/// 拆分单元格响应体最外层
86#[derive(Deserialize, Debug)]
87pub struct SplitCellsResponseData {
88    /// 拆分后的范围
89    pub unmerged_range: String,
90}
91
92impl ApiResponseTrait for SplitCellsResponseData {
93    fn data_format() -> ResponseFormat {
94        ResponseFormat::Data
95    }
96}
97
98impl_executable_builder_owned!(
99    SplitCellsRequestBuilder,
100    DataOperationService,
101    SplitCellsRequest,
102    SplitCellsResponseData,
103    split_cells
104);
105
106#[cfg(test)]
107#[allow(unused_variables, unused_unsafe)]
108mod test {
109    use serde_json::json;
110
111    use super::SplitCellsResponseData;
112
113    #[test]
114    fn test_split_cells_response() {
115        let json = json!({
116            "unmerged_range": "A1:C3"
117        });
118
119        let response: SplitCellsResponseData = serde_json::from_value(json).unwrap();
120        assert_eq!(response.unmerged_range, "A1:C3");
121    }
122}