open_lark/service/cloud_docs/sheets/v3/float_image/
patch.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::SpreadsheetSheetService,
15};
16
17use super::create::FloatImageData;
18
19impl SpreadsheetSheetService {
20    /// 更新浮动图片
21    pub async fn update_float_image(
22        &self,
23        request: UpdateFloatImageRequest,
24        option: Option<RequestOption>,
25    ) -> SDKResult<BaseResponse<UpdateFloatImageResponseData>> {
26        let mut api_req = request.api_request;
27        api_req.http_method = Method::PATCH;
28        api_req.api_path = format!(
29            "/open-apis/sheets/v3/spreadsheets/{}/sheets/{}/float_images/{}",
30            request.spreadsheet_token, request.sheet_id, request.float_image_id
31        );
32        api_req.supported_access_token_types = vec![AccessTokenType::Tenant, AccessTokenType::User];
33
34        let api_resp = Transport::request(api_req, &self.config, option).await?;
35
36        Ok(api_resp)
37    }
38}
39
40/// 更新浮动图片请求
41#[derive(Default, Debug, Serialize, Deserialize)]
42pub struct UpdateFloatImageRequest {
43    #[serde(skip)]
44    api_request: ApiRequest,
45    /// spreadsheet 的 token
46    spreadsheet_token: String,
47    /// sheet 的 id
48    sheet_id: String,
49    /// 浮动图片 ID
50    float_image_id: String,
51    /// 新的浮动图片信息
52    float_image: FloatImageData,
53}
54
55impl UpdateFloatImageRequest {
56    pub fn builder() -> UpdateFloatImageRequestBuilder {
57        UpdateFloatImageRequestBuilder::default()
58    }
59}
60
61#[derive(Default)]
62pub struct UpdateFloatImageRequestBuilder {
63    request: UpdateFloatImageRequest,
64}
65
66impl UpdateFloatImageRequestBuilder {
67    pub fn spreadsheet_token(mut self, spreadsheet_token: impl ToString) -> Self {
68        self.request.spreadsheet_token = spreadsheet_token.to_string();
69        self
70    }
71
72    pub fn sheet_id(mut self, sheet_id: impl ToString) -> Self {
73        self.request.sheet_id = sheet_id.to_string();
74        self
75    }
76
77    pub fn float_image_id(mut self, float_image_id: impl ToString) -> Self {
78        self.request.float_image_id = float_image_id.to_string();
79        self
80    }
81
82    pub fn float_image(mut self, float_image: FloatImageData) -> Self {
83        self.request.float_image = float_image;
84        self
85    }
86
87    pub fn build(mut self) -> UpdateFloatImageRequest {
88        self.request.api_request.body = serde_json::to_vec(&self.request).unwrap();
89        self.request
90    }
91}
92
93impl_executable_builder_owned!(
94    UpdateFloatImageRequestBuilder,
95    SpreadsheetSheetService,
96    UpdateFloatImageRequest,
97    BaseResponse<UpdateFloatImageResponseData>,
98    update_float_image
99);
100
101/// 更新浮动图片响应体最外层
102#[derive(Deserialize, Debug)]
103pub struct UpdateFloatImageResponseData {
104    /// 浮动图片 ID
105    pub float_image_id: String,
106    /// 更新后的浮动图片信息
107    #[serde(flatten)]
108    pub float_image: FloatImageData,
109}
110
111impl ApiResponseTrait for UpdateFloatImageResponseData {
112    fn data_format() -> ResponseFormat {
113        ResponseFormat::Data
114    }
115}
116
117#[cfg(test)]
118mod test {
119    use super::*;
120    use serde_json::json;
121
122    #[test]
123    fn test_update_float_image_response() {
124        let json = json!({
125            "float_image_id": "fimg_001",
126            "image_token": "img_token_456",
127            "position": {
128                "start_col_index": 2,
129                "start_row_index": 2,
130                "offset_x": 15.0,
131                "offset_y": 25.0
132            },
133            "size": {
134                "width": 300.0,
135                "height": 200.0
136            },
137            "name": "更新后的图片"
138        });
139
140        let response: UpdateFloatImageResponseData = serde_json::from_value(json).unwrap();
141        assert_eq!(response.float_image_id, "fimg_001");
142        assert_eq!(response.float_image.image_token, "img_token_456");
143        assert_eq!(response.float_image.size.width, 300.0);
144    }
145}
open_lark/service/cloud_docs/sheets/v3/float_image/patch.rs

open_lark/service/cloud_docs/sheets/v3/float_image/
patch.rs
