1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
use crate::client::Bot;
use serde::Serialize;
/// Use this method to create an additional invite link for a chat. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. The link can be revoked using the method revokeChatInviteLink. Returns the new invite link as [`crate::types::ChatInviteLink`] object.
/// # Documentation
/// <https://core.telegram.org/bots/api#createchatinvitelink>
/// # Returns
/// - `crate::types::ChatInviteLink`
#[derive(Clone, Debug, Serialize)]
pub struct CreateChatInviteLink {
/// Unique identifier for the target chat or username of the target channel in the format @username
pub chat_id: crate::types::ChatIdKind,
/// Invite link name; 0-32 characters
#[serde(skip_serializing_if = "Option::is_none")]
pub name: Option<Box<str>>,
/// Point in time (Unix timestamp) when the link will expire
#[serde(skip_serializing_if = "Option::is_none")]
pub expire_date: Option<i64>,
/// The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999
#[serde(skip_serializing_if = "Option::is_none")]
pub member_limit: Option<u32>,
/// `true`, if users joining the chat via the link need to be approved by chat administrators. If `true`, `member_limit` can't be specified
#[serde(skip_serializing_if = "Option::is_none")]
pub creates_join_request: Option<bool>,
}
impl CreateChatInviteLink {
/// Creates a new `CreateChatInviteLink`.
///
/// # Arguments
/// * `chat_id` - Unique identifier for the target chat or username of the target channel in the format @username
///
/// # Notes
/// Use builder methods to set optional fields.
#[must_use]
pub fn new<T0: Into<crate::types::ChatIdKind>>(chat_id: T0) -> Self {
Self {
chat_id: chat_id.into(),
name: None,
expire_date: None,
member_limit: None,
creates_join_request: None,
}
}
/// Unique identifier for the target chat or username of the target channel in the format @username
#[must_use]
pub fn chat_id<T: Into<crate::types::ChatIdKind>>(mut self, val: T) -> Self {
self.chat_id = val.into();
self
}
/// Invite link name; 0-32 characters
#[must_use]
pub fn name<T: Into<Box<str>>>(mut self, val: T) -> Self {
self.name = Some(val.into());
self
}
/// Invite link name; 0-32 characters
#[must_use]
pub fn name_option<T: Into<Box<str>>>(mut self, val: Option<T>) -> Self {
self.name = val.map(Into::into);
self
}
/// Point in time (Unix timestamp) when the link will expire
#[must_use]
pub fn expire_date<T: Into<i64>>(mut self, val: T) -> Self {
self.expire_date = Some(val.into());
self
}
/// Point in time (Unix timestamp) when the link will expire
#[must_use]
pub fn expire_date_option<T: Into<i64>>(mut self, val: Option<T>) -> Self {
self.expire_date = val.map(Into::into);
self
}
/// The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999
#[must_use]
pub fn member_limit<T: Into<u32>>(mut self, val: T) -> Self {
self.member_limit = Some(val.into());
self
}
/// The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999
#[must_use]
pub fn member_limit_option<T: Into<u32>>(mut self, val: Option<T>) -> Self {
self.member_limit = val.map(Into::into);
self
}
/// `true`, if users joining the chat via the link need to be approved by chat administrators. If `true`, `member_limit` can't be specified
#[must_use]
pub fn creates_join_request<T: Into<bool>>(mut self, val: T) -> Self {
self.creates_join_request = Some(val.into());
self
}
/// `true`, if users joining the chat via the link need to be approved by chat administrators. If `true`, `member_limit` can't be specified
#[must_use]
pub fn creates_join_request_option<T: Into<bool>>(mut self, val: Option<T>) -> Self {
self.creates_join_request = val.map(Into::into);
self
}
}
impl super::TelegramMethod for CreateChatInviteLink {
type Method = Self;
type Return = crate::types::ChatInviteLink;
fn build_request<Client>(self, _bot: &Bot<Client>) -> super::Request<Self::Method> {
super::Request::new("createChatInviteLink", self, None)
}
}