open_lark/service/cloud_docs/sheets/v3/data_validation/
update.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    service::sheets::v3::SpreadsheetSheetService,
14};
15
16use super::create::DataValidationRule;
17
18impl SpreadsheetSheetService {
19    /// 更新下拉列表设置
20    pub async fn update_data_validation(
21        &self,
22        request: UpdateDataValidationRequest,
23        option: Option<RequestOption>,
24    ) -> SDKResult<BaseResponse<UpdateDataValidationResponseData>> {
25        let mut api_req = request.api_request;
26        api_req.http_method = Method::PUT;
27        api_req.api_path = format!(
28            "/open-apis/sheets/v3/spreadsheets/{}/sheets/{}/dataValidation/{}",
29            request.spreadsheet_token, request.sheet_id, request.data_validation_id
30        );
31        api_req.supported_access_token_types = vec![AccessTokenType::Tenant, AccessTokenType::User];
32
33        let api_resp = Transport::request(api_req, &self.config, option).await?;
34
35        Ok(api_resp)
36    }
37}
38
39/// 更新下拉列表设置请求
40#[derive(Default, Debug, Serialize, Deserialize)]
41pub struct UpdateDataValidationRequest {
42    #[serde(skip)]
43    api_request: ApiRequest,
44    /// spreadsheet 的 token
45    spreadsheet_token: String,
46    /// sheet 的 id
47    sheet_id: String,
48    /// 数据校验 ID
49    data_validation_id: String,
50    /// 新的数据校验设置
51    data_validation: DataValidationRule,
52}
53
54impl UpdateDataValidationRequest {
55    pub fn builder() -> UpdateDataValidationRequestBuilder {
56        UpdateDataValidationRequestBuilder::default()
57    }
58}
59
60#[derive(Default)]
61pub struct UpdateDataValidationRequestBuilder {
62    request: UpdateDataValidationRequest,
63}
64
65impl UpdateDataValidationRequestBuilder {
66    pub fn spreadsheet_token(mut self, spreadsheet_token: impl ToString) -> Self {
67        self.request.spreadsheet_token = spreadsheet_token.to_string();
68        self
69    }
70
71    pub fn sheet_id(mut self, sheet_id: impl ToString) -> Self {
72        self.request.sheet_id = sheet_id.to_string();
73        self
74    }
75
76    pub fn data_validation_id(mut self, data_validation_id: impl ToString) -> Self {
77        self.request.data_validation_id = data_validation_id.to_string();
78        self
79    }
80
81    pub fn data_validation(mut self, data_validation: DataValidationRule) -> Self {
82        self.request.data_validation = data_validation;
83        self
84    }
85
86    pub fn build(mut self) -> UpdateDataValidationRequest {
87        self.request.api_request.body = serde_json::to_vec(&self.request).unwrap();
88        self.request
89    }
90}
91
92/// 更新下拉列表设置响应体最外层
93#[derive(Deserialize, Debug)]
94pub struct UpdateDataValidationResponseData {
95    /// 数据校验 ID
96    pub data_validation_id: String,
97    /// 更新后的数据校验规则信息
98    #[serde(flatten)]
99    pub data_validation: DataValidationRule,
100}
101
102impl ApiResponseTrait for UpdateDataValidationResponseData {
103    fn data_format() -> ResponseFormat {
104        ResponseFormat::Data
105    }
106}
107
108#[cfg(test)]
109mod test {
110    use super::*;
111    use serde_json::json;
112
113    #[test]
114    fn test_update_data_validation_response() {
115        let json = json!({
116            "data_validation_id": "dv_001",
117            "condition_type": "number_between",
118            "range": "B1:B10",
119            "condition_values": ["1", "100"],
120            "strict": true,
121            "input_message": "请输入1-100之间的数字",
122            "error_message": "数字超出范围"
123        });
124
125        let response: UpdateDataValidationResponseData = serde_json::from_value(json).unwrap();
126        assert_eq!(response.data_validation_id, "dv_001");
127        assert_eq!(response.data_validation.condition_type, "number_between");
128    }
129}