use crate::client::Bot;
use serde::Serialize;
/// Use this method to edit animation, audio, document, photo, or video messages, or to add media to text messages. If a message is part of a message album, then it can be edited only to an audio for audio albums, only to a document for document albums and to a photo or a video otherwise. When an inline message is edited, a new file can't be uploaded; use a previously uploaded file via its `file_id` or specify a URL. On success, if the edited message is not an inline message, the edited Message is returned, otherwise `true` is returned. Note that business messages that were not sent by the bot and do not contain an inline keyboard can only be edited within 48 hours from the time they were sent.
/// # Documentation
/// <https://core.telegram.org/bots/api#editmessagemedia>
/// # Returns
/// - `crate::types::Message`
/// - `bool`
#[derive(Clone, Debug, Serialize)]
pub struct EditMessageMedia {
/// Unique identifier of the business connection on behalf of which the message to be edited was sent
#[serde(skip_serializing_if = "Option::is_none")]
pub business_connection_id: Option<Box<str>>,
/// Required if `inline_message_id` is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)
#[serde(skip_serializing_if = "Option::is_none")]
pub chat_id: Option<crate::types::ChatIdKind>,
/// Required if `inline_message_id` is not specified. Identifier of the message to edit
#[serde(skip_serializing_if = "Option::is_none")]
pub message_id: Option<i64>,
/// Required if `chat_id` and `message_id` are not specified. Identifier of the inline message
#[serde(skip_serializing_if = "Option::is_none")]
pub inline_message_id: Option<Box<str>>,
/// A JSON-serialized object for a new media content of the message
pub media: crate::types::InputMedia,
/// A JSON-serialized object for a new inline keyboard.
#[serde(skip_serializing_if = "Option::is_none")]
pub reply_markup: Option<crate::types::InlineKeyboardMarkup>,
}
impl EditMessageMedia {
/// Creates a new `EditMessageMedia`.
///
/// # Arguments
/// * `media` - A JSON-serialized object for a new media content of the message
///
/// # Notes
/// Use builder methods to set optional fields.
#[must_use]
pub fn new<T0: Into<crate::types::InputMedia>>(media: T0) -> Self {
Self {
business_connection_id: None,
chat_id: None,
message_id: None,
inline_message_id: None,
media: media.into(),
reply_markup: None,
}
}
/// Unique identifier of the business connection on behalf of which the message to be edited was sent
#[must_use]
pub fn business_connection_id<T: Into<Box<str>>>(self, val: T) -> Self {
let mut this = self;
this.business_connection_id = Some(val.into());
this
}
/// Unique identifier of the business connection on behalf of which the message to be edited was sent
#[must_use]
pub fn business_connection_id_option<T: Into<Box<str>>>(self, val: Option<T>) -> Self {
let mut this = self;
this.business_connection_id = val.map(Into::into);
this
}
/// Required if `inline_message_id` is not specified. 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 = Some(val.into());
this
}
/// Required if `inline_message_id` is not specified. Unique identifier for the target chat or username of the target channel (in the format @channelusername)
#[must_use]
pub fn chat_id_option<T: Into<crate::types::ChatIdKind>>(self, val: Option<T>) -> Self {
let mut this = self;
this.chat_id = val.map(Into::into);
this
}
/// Required if `inline_message_id` is not specified. Identifier of the message to edit
#[must_use]
pub fn message_id<T: Into<i64>>(self, val: T) -> Self {
let mut this = self;
this.message_id = Some(val.into());
this
}
/// Required if `inline_message_id` is not specified. Identifier of the message to edit
#[must_use]
pub fn message_id_option<T: Into<i64>>(self, val: Option<T>) -> Self {
let mut this = self;
this.message_id = val.map(Into::into);
this
}
/// Required if `chat_id` and `message_id` are not specified. Identifier of the inline message
#[must_use]
pub fn inline_message_id<T: Into<Box<str>>>(self, val: T) -> Self {
let mut this = self;
this.inline_message_id = Some(val.into());
this
}
/// Required if `chat_id` and `message_id` are not specified. Identifier of the inline message
#[must_use]
pub fn inline_message_id_option<T: Into<Box<str>>>(self, val: Option<T>) -> Self {
let mut this = self;
this.inline_message_id = val.map(Into::into);
this
}
/// A JSON-serialized object for a new media content of the message
#[must_use]
pub fn media<T: Into<crate::types::InputMedia>>(self, val: T) -> Self {
let mut this = self;
this.media = val.into();
this
}
/// A JSON-serialized object for a new inline keyboard.
#[must_use]
pub fn reply_markup<T: Into<crate::types::InlineKeyboardMarkup>>(self, val: T) -> Self {
let mut this = self;
this.reply_markup = Some(val.into());
this
}
/// A JSON-serialized object for a new inline keyboard.
#[must_use]
pub fn reply_markup_option<T: Into<crate::types::InlineKeyboardMarkup>>(
self,
val: Option<T>,
) -> Self {
let mut this = self;
this.reply_markup = val.map(Into::into);
this
}
}
impl super::TelegramMethod for EditMessageMedia {
type Method = Self;
type Return = crate::Either<crate::types::Message, bool>;
fn build_request<Client>(mut self, _bot: &Bot<Client>) -> super::Request<Self::Method> {
let mut files = vec![];
super::prepare_input_media(&mut files, &mut self.media);
super::Request::new("editMessageMedia", self, Some(files))
}
}