open_lark/service/cloud_docs/wiki/v2/space_member/
create.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        http::Transport,
11        req_option::RequestOption,
12        SDKResult,
13    },
14    impl_executable_builder_owned,
15};
16
17/// 添加知识空间成员请求
18#[derive(Debug, Serialize, Default)]
19pub struct CreateSpaceMemberRequest {
20    #[serde(skip)]
21    api_request: ApiRequest,
22    /// 知识空间id
23    #[serde(skip)]
24    space_id: String,
25    /// 成员类型：user
26    member_type: String,
27    /// 成员id，根据member_type决定
28    member_id: String,
29    /// 成员权限角色：admin(管理员)、edit_member(协作者)、view_member(阅读者)
30    role: String,
31}
32
33impl CreateSpaceMemberRequest {
34    pub fn builder() -> CreateSpaceMemberRequestBuilder {
35        CreateSpaceMemberRequestBuilder::default()
36    }
37
38    pub fn new(
39        space_id: impl ToString,
40        member_type: impl ToString,
41        member_id: impl ToString,
42        role: impl ToString,
43    ) -> Self {
44        Self {
45            space_id: space_id.to_string(),
46            member_type: member_type.to_string(),
47            member_id: member_id.to_string(),
48            role: role.to_string(),
49            ..Default::default()
50        }
51    }
52}
53
54#[derive(Default)]
55pub struct CreateSpaceMemberRequestBuilder {
56    request: CreateSpaceMemberRequest,
57}
58
59impl CreateSpaceMemberRequestBuilder {
60    /// 知识空间id
61    pub fn space_id(mut self, space_id: impl ToString) -> Self {
62        self.request.space_id = space_id.to_string();
63        self
64    }
65
66    /// 成员类型：user
67    pub fn member_type(mut self, member_type: impl ToString) -> Self {
68        self.request.member_type = member_type.to_string();
69        self
70    }
71
72    /// 成员id，根据member_type决定
73    pub fn member_id(mut self, member_id: impl ToString) -> Self {
74        self.request.member_id = member_id.to_string();
75        self
76    }
77
78    /// 成员权限角色：admin(管理员)、edit_member(协作者)、view_member(阅读者)
79    pub fn role(mut self, role: impl ToString) -> Self {
80        self.request.role = role.to_string();
81        self
82    }
83
84    /// 设置为管理员
85    pub fn as_admin(mut self) -> Self {
86        self.request.role = "admin".to_string();
87        self
88    }
89
90    /// 设置为协作者
91    pub fn as_editor(mut self) -> Self {
92        self.request.role = "edit_member".to_string();
93        self
94    }
95
96    /// 设置为阅读者
97    pub fn as_viewer(mut self) -> Self {
98        self.request.role = "view_member".to_string();
99        self
100    }
101
102    pub fn build(mut self) -> CreateSpaceMemberRequest {
103        self.request.api_request.body = serde_json::to_vec(&self.request).unwrap();
104        self.request
105    }
106}
107
108impl_executable_builder_owned!(
109    CreateSpaceMemberRequestBuilder,
110    crate::service::cloud_docs::wiki::v2::space_member::SpaceMemberService,
111    CreateSpaceMemberRequest,
112    BaseResponse<CreateSpaceMemberResponse>,
113    create
114);
115
116/// 添加的成员信息
117#[derive(Debug, Deserialize)]
118pub struct CreatedMember {
119    /// 成员类型：user
120    pub member_type: String,
121    /// 成员id
122    pub member_id: String,
123    /// 成员权限角色
124    pub role: String,
125}
126
127/// 添加知识空间成员响应
128#[derive(Debug, Deserialize)]
129pub struct CreateSpaceMemberResponse {
130    /// 添加的成员信息
131    pub member: CreatedMember,
132}
133
134impl ApiResponseTrait for CreateSpaceMemberResponse {
135    fn data_format() -> ResponseFormat {
136        ResponseFormat::Data
137    }
138}
139
140/// 添加知识空间成员
141pub async fn create_space_member(
142    request: CreateSpaceMemberRequest,
143    config: &Config,
144    option: Option<RequestOption>,
145) -> SDKResult<BaseResponse<CreateSpaceMemberResponse>> {
146    let mut api_req = request.api_request;
147    api_req.http_method = Method::POST;
148    api_req.api_path = format!("/open-apis/wiki/v2/spaces/{}/members", request.space_id);
149    api_req.supported_access_token_types = vec![AccessTokenType::Tenant, AccessTokenType::User];
150
151    let api_resp = Transport::request(api_req, config, option).await?;
152    Ok(api_resp)
153}
154
155#[cfg(test)]
156mod tests {
157    use super::*;
158
159    #[test]
160    fn test_create_space_member_request_builder() {
161        let request = CreateSpaceMemberRequest::builder()
162            .space_id("spcxxxxxx")
163            .member_type("user")
164            .member_id("ou_xxxxxx")
165            .as_editor()
166            .build();
167
168        assert_eq!(request.space_id, "spcxxxxxx");
169        assert_eq!(request.member_type, "user");
170        assert_eq!(request.member_id, "ou_xxxxxx");
171        assert_eq!(request.role, "edit_member");
172    }
173}
open_lark/service/cloud_docs/wiki/v2/space_member/create.rs

open_lark/service/cloud_docs/wiki/v2/space_member/
create.rs
