open_lark/service/cloud_docs/sheets/v3/float_image/
delete.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
17impl SpreadsheetSheetService {
18    /// 删除浮动图片
19    pub async fn delete_float_image(
20        &self,
21        request: DeleteFloatImageRequest,
22        option: Option<RequestOption>,
23    ) -> SDKResult<BaseResponse<DeleteFloatImageResponseData>> {
24        let mut api_req = request.api_request;
25        api_req.http_method = Method::DELETE;
26        api_req.api_path = format!(
27            "/open-apis/sheets/v3/spreadsheets/{}/sheets/{}/float_images/{}",
28            request.spreadsheet_token, request.sheet_id, request.float_image_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 DeleteFloatImageRequest {
41    #[serde(skip)]
42    api_request: ApiRequest,
43    /// spreadsheet 的 token
44    spreadsheet_token: String,
45    /// sheet 的 id
46    sheet_id: String,
47    /// 浮动图片 ID
48    float_image_id: String,
49}
50
51impl DeleteFloatImageRequest {
52    pub fn builder() -> DeleteFloatImageRequestBuilder {
53        DeleteFloatImageRequestBuilder::default()
54    }
55}
56
57#[derive(Default)]
58pub struct DeleteFloatImageRequestBuilder {
59    request: DeleteFloatImageRequest,
60}
61
62impl DeleteFloatImageRequestBuilder {
63    pub fn spreadsheet_token(mut self, spreadsheet_token: impl ToString) -> Self {
64        self.request.spreadsheet_token = spreadsheet_token.to_string();
65        self
66    }
67
68    pub fn sheet_id(mut self, sheet_id: impl ToString) -> Self {
69        self.request.sheet_id = sheet_id.to_string();
70        self
71    }
72
73    pub fn float_image_id(mut self, float_image_id: impl ToString) -> Self {
74        self.request.float_image_id = float_image_id.to_string();
75        self
76    }
77
78    pub fn build(mut self) -> DeleteFloatImageRequest {
79        self.request.api_request.body = serde_json::to_vec(&self.request).unwrap();
80        self.request
81    }
82}
83
84impl_executable_builder_owned!(
85    DeleteFloatImageRequestBuilder,
86    SpreadsheetSheetService,
87    DeleteFloatImageRequest,
88    BaseResponse<DeleteFloatImageResponseData>,
89    delete_float_image
90);
91
92/// 删除浮动图片响应体最外层
93#[derive(Deserialize, Debug)]
94pub struct DeleteFloatImageResponseData {
95    /// 删除操作是否成功
96    #[serde(default)]
97    pub success: bool,
98    /// 删除的浮动图片 ID
99    #[serde(skip_serializing_if = "Option::is_none")]
100    pub float_image_id: Option<String>,
101}
102
103impl ApiResponseTrait for DeleteFloatImageResponseData {
104    fn data_format() -> ResponseFormat {
105        ResponseFormat::Data
106    }
107}
108
109#[cfg(test)]
110mod test {
111    use super::*;
112    use serde_json::json;
113
114    #[test]
115    fn test_delete_float_image_response() {
116        let json = json!({
117            "success": true,
118            "float_image_id": "fimg_001"
119        });
120
121        let response: DeleteFloatImageResponseData = serde_json::from_value(json).unwrap();
122        assert!(response.success);
123        assert_eq!(response.float_image_id, Some("fimg_001".to_string()));
124    }
125}