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

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