open_lark/service/cloud_docs/drive/v1/
like.rs

1use reqwest::Method;
2use serde::{Deserialize, Serialize};
3
4use crate::{
5    core::{
6        api_req::ApiRequest,
7        api_resp::{ApiResponseTrait, BaseResponse, ResponseFormat},
8        config::Config,
9        constants::AccessTokenType,
10        endpoints::cloud_docs::*,
11        http::Transport,
12        req_option::RequestOption,
13        SDKResult,
14    },
15    impl_executable_builder_owned,
16};
17
18/// 点赞服务
19pub struct LikeService {
20    config: Config,
21}
22
23impl LikeService {
24    pub fn new(config: Config) -> Self {
25        Self { config }
26    }
27
28    /// 获取云文档的点赞者列表
29    ///
30    /// 该接口用于获取云文档的点赞者列表。
31    ///
32    /// <https://open.feishu.cn/document/server-docs/docs/drive-v1/file-like_record/list>
33    pub async fn list_file_likes(
34        &self,
35        request: ListFileLikesRequest,
36        option: Option<RequestOption>,
37    ) -> SDKResult<BaseResponse<ListFileLikesRespData>> {
38        let mut api_req = ApiRequest {
39            http_method: Method::GET,
40            api_path: DRIVE_V1_FILE_LIKE_RECORDS.replace("{}", &request.file_token),
41            supported_access_token_types: vec![AccessTokenType::User, AccessTokenType::Tenant],
42            ..Default::default()
43        };
44
45        // 添加查询参数
46        if let Some(page_token) = request.page_token {
47            api_req.query_params.insert("page_token", page_token);
48        }
49        if let Some(page_size) = request.page_size {
50            api_req
51                .query_params
52                .insert("page_size", page_size.to_string());
53        }
54
55        let api_resp = Transport::request(api_req, &self.config, option).await?;
56        Ok(api_resp)
57    }
58}
59
60/// 获取云文档的点赞者列表请求参数
61#[derive(Debug, Clone, Serialize, Deserialize, Default)]
62pub struct ListFileLikesRequest {
63    /// 文件token
64    pub file_token: String,
65    /// 分页token
66    pub page_token: Option<String>,
67    /// 分页大小
68    pub page_size: Option<i32>,
69}
70
71impl ListFileLikesRequest {
72    pub fn builder() -> ListFileLikesRequestBuilder {
73        ListFileLikesRequestBuilder::default()
74    }
75
76    pub fn new(file_token: impl Into<String>) -> Self {
77        Self {
78            file_token: file_token.into(),
79            page_token: None,
80            page_size: None,
81        }
82    }
83
84    pub fn with_page_token(mut self, page_token: impl Into<String>) -> Self {
85        self.page_token = Some(page_token.into());
86        self
87    }
88
89    pub fn with_page_size(mut self, page_size: i32) -> Self {
90        self.page_size = Some(page_size);
91        self
92    }
93}
94
95/// 获取云文档的点赞者列表请求构建器
96#[derive(Default)]
97pub struct ListFileLikesRequestBuilder {
98    request: ListFileLikesRequest,
99}
100
101impl ListFileLikesRequestBuilder {
102    pub fn file_token(mut self, file_token: impl Into<String>) -> Self {
103        self.request.file_token = file_token.into();
104        self
105    }
106
107    pub fn page_token(mut self, page_token: impl Into<String>) -> Self {
108        self.request.page_token = Some(page_token.into());
109        self
110    }
111
112    pub fn page_size(mut self, page_size: i32) -> Self {
113        self.request.page_size = Some(page_size);
114        self
115    }
116
117    pub fn build(self) -> ListFileLikesRequest {
118        self.request
119    }
120}
121
122impl_executable_builder_owned!(
123    ListFileLikesRequestBuilder,
124    LikeService,
125    ListFileLikesRequest,
126    BaseResponse<ListFileLikesRespData>,
127    list_file_likes
128);
129
130/// 获取云文档的点赞者列表响应数据
131#[derive(Debug, Clone, Serialize, Deserialize)]
132pub struct ListFileLikesRespData {
133    /// 是否还有更多数据
134    pub has_more: bool,
135    /// 下一页token
136    pub page_token: Option<String>,
137    /// 点赞记录列表
138    pub items: Vec<FileLikeRecord>,
139}
140
141#[derive(Debug, Clone, Serialize, Deserialize)]
142pub struct FileLikeRecord {
143    /// 点赞者ID
144    pub user_id: String,
145    /// 点赞者姓名
146    pub user_name: String,
147    /// 点赞时间（时间戳，单位：秒）
148    pub like_time: String,
149    /// 点赞者头像
150    pub avatar_url: Option<String>,
151}
152
153impl ApiResponseTrait for ListFileLikesRespData {
154    fn data_format() -> ResponseFormat {
155        ResponseFormat::Data
156    }
157}
open_lark/service/cloud_docs/drive/v1/like.rs

open_lark/service/cloud_docs/drive/v1/
like.rs
