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
115
116
117
118
119
120
121
122
123
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 @channelusername)
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 @channelusername)
///
/// # 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 @channelusername)
#[must_use]
pub fn chat_id<T: Into<crate::types::ChatIdKind>>(self, val: T) -> Self {
let mut this = self;
this.chat_id = val.into();
this
}
/// Invite link name; 0-32 characters
#[must_use]
pub fn name<T: Into<Box<str>>>(self, val: T) -> Self {
let mut this = self;
this.name = Some(val.into());
this
}
/// Invite link name; 0-32 characters
#[must_use]
pub fn name_option<T: Into<Box<str>>>(self, val: Option<T>) -> Self {
let mut this = self;
this.name = val.map(Into::into);
this
}
/// Point in time (Unix timestamp) when the link will expire
#[must_use]
pub fn expire_date<T: Into<i64>>(self, val: T) -> Self {
let mut this = self;
this.expire_date = Some(val.into());
this
}
/// Point in time (Unix timestamp) when the link will expire
#[must_use]
pub fn expire_date_option<T: Into<i64>>(self, val: Option<T>) -> Self {
let mut this = self;
this.expire_date = val.map(Into::into);
this
}
/// 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>>(self, val: T) -> Self {
let mut this = self;
this.member_limit = Some(val.into());
this
}
/// 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>>(self, val: Option<T>) -> Self {
let mut this = self;
this.member_limit = val.map(Into::into);
this
}
/// `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>>(self, val: T) -> Self {
let mut this = self;
this.creates_join_request = Some(val.into());
this
}
/// `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>>(self, val: Option<T>) -> Self {
let mut this = self;
this.creates_join_request = val.map(Into::into);
this
}
}
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)
}
}