Update to TDLib 1.8.41

This commit is contained in:
c0re100 2024-12-15 02:12:12 +08:00
parent 930f3352f3
commit 58adcc4804
No known key found for this signature in database
GPG key ID: 7C3B3004FE745AAF
4 changed files with 2033 additions and 873 deletions

View file

@ -813,6 +813,12 @@ chatPermissions can_send_basic_messages:Bool can_send_audios:Bool can_send_docum
chatAdministratorRights can_manage_chat:Bool can_change_info:Bool can_post_messages:Bool can_edit_messages:Bool can_delete_messages:Bool can_invite_users:Bool can_restrict_members:Bool can_pin_messages:Bool can_manage_topics:Bool can_promote_members:Bool can_manage_video_chats:Bool can_post_stories:Bool can_edit_stories:Bool can_delete_stories:Bool is_anonymous:Bool = ChatAdministratorRights;
//@description Describes a possibly non-integer amount of Telegram Stars
//@star_count The integer amount of Telegram Stars rounded to 0
//@nanostar_count The number of 1/1000000000 shares of Telegram Stars; from -999999999 to 999999999
starAmount star_count:int53 nanostar_count:int32 = StarAmount;
//@class StarSubscriptionType @description Describes type of subscription paid in Telegram Stars
//@description Describes a subscription to a channel chat
@ -844,11 +850,70 @@ starSubscriptionPricing period:int32 star_count:int53 = StarSubscriptionPricing;
starSubscription id:string chat_id:int53 expiration_date:int32 is_canceled:Bool is_expiring:Bool pricing:starSubscriptionPricing type:StarSubscriptionType = StarSubscription;
//@description Represents a list of Telegram Star subscriptions
//@star_count The amount of owned Telegram Stars
//@star_amount The amount of owned Telegram Stars
//@subscriptions List of subscriptions for Telegram Stars
//@required_star_count The number of Telegram Stars required to buy to extend subscriptions expiring soon
//@next_offset The offset for the next request. If empty, then there are no more results
starSubscriptions star_count:int53 subscriptions:vector<starSubscription> required_star_count:int53 next_offset:string = StarSubscriptions;
starSubscriptions star_amount:starAmount subscriptions:vector<starSubscription> required_star_count:int53 next_offset:string = StarSubscriptions;
//@class AffiliateProgramSortOrder @description Describes the order of the found affiliate programs
//@description The affiliate programs must be sorted by the profitability
affiliateProgramSortOrderProfitability = AffiliateProgramSortOrder;
//@description The affiliate programs must be sorted by creation date
affiliateProgramSortOrderCreationDate = AffiliateProgramSortOrder;
//@description The affiliate programs must be sorted by the expected revenue
affiliateProgramSortOrderRevenue = AffiliateProgramSortOrder;
//@description Describes parameters of an affiliate program
//@commission_per_mille The number of Telegram Stars received by the affiliate for each 1000 Telegram Stars received by the program owner;
//-getOption("affiliate_program_commission_per_mille_min")-getOption("affiliate_program_commission_per_mille_max")
//@month_count Number of months the program will be active; 0-36. If 0, then the program is eternal
affiliateProgramParameters commission_per_mille:int32 month_count:int32 = AffiliateProgramParameters;
//@description Contains information about an active affiliate program
//@parameters Parameters of the affiliate program
//@end_date Point in time (Unix timestamp) when the affiliate program will be closed; 0 if the affiliate program isn't scheduled to be closed.
//-If positive, then the program can't be connected using connectChatAffiliateProgram, but active connections will work until the date
//@daily_revenue_per_user_amount The amount of daily revenue per user in Telegram Stars of the bot that created the affiliate program
affiliateProgramInfo parameters:affiliateProgramParameters end_date:int32 daily_revenue_per_user_amount:starAmount = AffiliateProgramInfo;
//@description Contains information about an affiliate that received commission from a Telegram Star transaction
//@commission_per_mille The number of Telegram Stars received by the affiliate for each 1000 Telegram Stars received by the program owner
//@affiliate_chat_id Identifier of the chat which received the commission
//@star_amount The amount of Telegram Stars that were received by the affiliate; can be negative for refunds
affiliateInfo commission_per_mille:int32 affiliate_chat_id:int53 star_amount:starAmount = AffiliateInfo;
//@description Describes a found affiliate program
//@bot_user_id User identifier of the bot created the program
//@parameters Information about the affiliate program
foundAffiliateProgram bot_user_id:int53 parameters:affiliateProgramInfo = FoundAffiliateProgram;
//@description Represents a list of found affiliate programs
//@total_count The total number of found affiliate programs
//@programs The list of affiliate programs
//@next_offset The offset for the next request. If empty, then there are no more results
foundAffiliatePrograms total_count:int32 programs:vector<foundAffiliateProgram> next_offset:string = FoundAffiliatePrograms;
//@description Describes an affiliate program that was connected to a chat
//@url The link that can be used to refer users if the program is still active
//@bot_user_id User identifier of the bot created the program
//@parameters The parameters of the affiliate program
//@connection_date Point in time (Unix timestamp) when the affiliate program was connected
//@is_disconnected True, if the program was canceled by the bot, or disconnected by the chat owner and isn't available anymore
//@user_count The number of users that used the affiliate program
//@revenue_star_count The number of Telegram Stars that were earned by the affiliate program
chatAffiliateProgram url:string bot_user_id:int53 parameters:affiliateProgramParameters connection_date:int32 is_disconnected:Bool user_count:int64 revenue_star_count:int64 = ChatAffiliateProgram;
//@description Represents a list of affiliate programs that were connected to a chat
//@total_count The total number of affiliate programs that were connected to the chat
//@programs The list of connected affiliate programs
//@next_offset The offset for the next request. If empty, then there are no more results
chatAffiliatePrograms total_count:int32 programs:vector<chatAffiliateProgram> next_offset:string = ChatAffiliatePrograms;
//@description Contains information about a product that can be paid with invoice
@ -971,103 +1036,137 @@ starTransactionDirectionIncoming = StarTransactionDirection;
starTransactionDirectionOutgoing = StarTransactionDirection;
//@class BotTransactionPurpose @description Describes purpose of a transaction with a bot
//@class StarTransactionType @description Describes type of transaction with Telegram Stars
//@description Paid media were bought @media The bought media if the transaction wasn't refunded @payload Bot-provided payload; for bots only
botTransactionPurposePaidMedia media:vector<PaidMedia> payload:string = BotTransactionPurpose;
//@description The transaction is a deposit of Telegram Stars from the Premium bot; for regular users only
starTransactionTypePremiumBotDeposit = StarTransactionType;
//@description User bought a product from the bot
//@product_info Information about the bought product; may be null if not applicable
//@invoice_payload Invoice payload; for bots only
botTransactionPurposeInvoicePayment product_info:productInfo invoice_payload:bytes = BotTransactionPurpose;
//@description The transaction is a deposit of Telegram Stars from App Store; for regular users only
starTransactionTypeAppStoreDeposit = StarTransactionType;
//@description User bought a subscription in a bot or a business account
//@period The number of seconds between consecutive Telegram Star debiting
//@product_info Information about the bought subscription; may be null if not applicable
//@invoice_payload Invoice payload; for bots only
botTransactionPurposeSubscription period:int32 product_info:productInfo invoice_payload:bytes = BotTransactionPurpose;
//@description The transaction is a deposit of Telegram Stars from Google Play; for regular users only
starTransactionTypeGooglePlayDeposit = StarTransactionType;
//@description The transaction is a deposit of Telegram Stars from Fragment; for regular users and bots only
starTransactionTypeFragmentDeposit = StarTransactionType;
//@class ChatTransactionPurpose @description Describes purpose of a transaction with a supergroup or a channel
//@description The transaction is a deposit of Telegram Stars by another user; for regular users only
//@user_id Identifier of the user that gifted Telegram Stars; 0 if the user was anonymous
//@sticker The sticker to be shown in the transaction information; may be null if unknown
starTransactionTypeUserDeposit user_id:int53 sticker:sticker = StarTransactionType;
//@description Paid media were bought
//@description The transaction is a deposit of Telegram Stars from a giveaway; for regular users only
//@chat_id Identifier of a supergroup or a channel chat that created the giveaway
//@giveaway_message_id Identifier of the message with the giveaway; can be 0 or an identifier of a deleted message
starTransactionTypeGiveawayDeposit chat_id:int53 giveaway_message_id:int53 = StarTransactionType;
//@description The transaction is a withdrawal of earned Telegram Stars to Fragment; for bots and channel chats only @withdrawal_state State of the withdrawal; may be null for refunds from Fragment
starTransactionTypeFragmentWithdrawal withdrawal_state:RevenueWithdrawalState = StarTransactionType;
//@description The transaction is a withdrawal of earned Telegram Stars to Telegram Ad platform; for bots and channel chats only
starTransactionTypeTelegramAdsWithdrawal = StarTransactionType;
//@description The transaction is a payment for Telegram API usage; for bots only @request_count The number of billed requests
starTransactionTypeTelegramApiUsage request_count:int32 = StarTransactionType;
//@description The transaction is a purchase of paid media from a bot or a business account by the current user; for regular users only
//@user_id Identifier of the bot or the business account user that sent the paid media
//@media The bought media if the transaction wasn't refunded
starTransactionTypeBotPaidMediaPurchase user_id:int53 media:vector<PaidMedia> = StarTransactionType;
//@description The transaction is a sale of paid media by the bot or a business account managed by the bot; for bots only
//@user_id Identifier of the user that bought the media
//@media The bought media
//@payload Bot-provided payload
//@affiliate Information about the affiliate which received commission from the transaction; may be null if none
starTransactionTypeBotPaidMediaSale user_id:int53 media:vector<PaidMedia> payload:string affiliate:affiliateInfo = StarTransactionType;
//@description The transaction is a purchase of paid media from a channel by the current user; for regular users only
//@chat_id Identifier of the channel chat that sent the paid media
//@message_id Identifier of the corresponding message with paid media; can be 0 or an identifier of a deleted message
//@media The bought media if the transaction wasn't refunded
chatTransactionPurposePaidMedia message_id:int53 media:vector<PaidMedia> = ChatTransactionPurpose;
starTransactionTypeChannelPaidMediaPurchase chat_id:int53 message_id:int53 media:vector<PaidMedia> = StarTransactionType;
//@description User joined the channel and subscribed to regular payments in Telegram Stars
//@period The number of seconds between consecutive Telegram Star debiting
chatTransactionPurposeJoin period:int32 = ChatTransactionPurpose;
//@description The transaction is a sale of paid media by the channel chat; for channel chats only
//@user_id Identifier of the user that bought the media
//@message_id Identifier of the corresponding message with paid media; can be 0 or an identifier of a deleted message
//@media The bought media
starTransactionTypeChannelPaidMediaSale user_id:int53 message_id:int53 media:vector<PaidMedia> = StarTransactionType;
//@description User paid for a reaction
//@description The transaction is a purchase of a product from a bot or a business account by the current user; for regular users only
//@user_id Identifier of the bot or the business account user that created the invoice
//@product_info Information about the bought product
starTransactionTypeBotInvoicePurchase user_id:int53 product_info:productInfo = StarTransactionType;
//@description The transaction is a sale of a product by the bot; for bots only
//@user_id Identifier of the user that bought the product
//@product_info Information about the bought product
//@invoice_payload Invoice payload
//@affiliate Information about the affiliate which received commission from the transaction; may be null if none
starTransactionTypeBotInvoiceSale user_id:int53 product_info:productInfo invoice_payload:bytes affiliate:affiliateInfo = StarTransactionType;
//@description The transaction is a purchase of a subscription from a bot or a business account by the current user; for regular users only
//@user_id Identifier of the bot or the business account user that created the subscription link
//@subscription_period The number of seconds between consecutive Telegram Star debitings
//@product_info Information about the bought subscription
starTransactionTypeBotSubscriptionPurchase user_id:int53 subscription_period:int32 product_info:productInfo = StarTransactionType;
//@description The transaction is a sale of a subscription by the bot; for bots only
//@user_id Identifier of the user that bought the subscription
//@subscription_period The number of seconds between consecutive Telegram Star debitings
//@product_info Information about the bought subscription
//@invoice_payload Invoice payload
//@affiliate Information about the affiliate which received commission from the transaction; may be null if none
starTransactionTypeBotSubscriptionSale user_id:int53 subscription_period:int32 product_info:productInfo invoice_payload:bytes affiliate:affiliateInfo = StarTransactionType;
//@description The transaction is a purchase of a subscription to a channel chat by the current user; for regular users only
//@chat_id Identifier of the channel chat that created the subscription
//@subscription_period The number of seconds between consecutive Telegram Star debitings
starTransactionTypeChannelSubscriptionPurchase chat_id:int53 subscription_period:int32 = StarTransactionType;
//@description The transaction is a sale of a subscription by the channel chat; for channel chats only
//@user_id Identifier of the user that bought the subscription
//@subscription_period The number of seconds between consecutive Telegram Star debitings
starTransactionTypeChannelSubscriptionSale user_id:int53 subscription_period:int32 = StarTransactionType;
//@description The transaction is a purchase of a gift to another user; for regular users and bots only @user_id Identifier of the user that received the gift @gift The gift
starTransactionTypeGiftPurchase user_id:int53 gift:gift = StarTransactionType;
//@description The transaction is a sale of a gift received from another user or bot; for regular users only @user_id Identifier of the user that sent the gift @gift The gift
starTransactionTypeGiftSale user_id:int53 gift:gift = StarTransactionType;
//@description The transaction is a sending of a paid reaction to a message in a channel chat by the current user; for regular users only
//@chat_id Identifier of the channel chat
//@message_id Identifier of the reacted message; can be 0 or an identifier of a deleted message
chatTransactionPurposeReaction message_id:int53 = ChatTransactionPurpose;
starTransactionTypeChannelPaidReactionSend chat_id:int53 message_id:int53 = StarTransactionType;
//@description User received Telegram Stars from a giveaway @giveaway_message_id Identifier of the message with giveaway; can be 0 or an identifier of a deleted message
chatTransactionPurposeGiveaway giveaway_message_id:int53 = ChatTransactionPurpose;
//@description The transaction is a receiving of a paid reaction to a message by the channel chat; for channel chats only
//@user_id Identifier of the user that added the paid reaction
//@message_id Identifier of the reacted message; can be 0 or an identifier of a deleted message
starTransactionTypeChannelPaidReactionReceive user_id:int53 message_id:int53 = StarTransactionType;
//@description The transaction is a receiving of a commission from an affiliate program; for regular users, bots and channel chats only
//@chat_id Identifier of the chat that created the affiliate program
//@commission_per_mille The number of Telegram Stars received by the affiliate for each 1000 Telegram Stars received by the program owner
starTransactionTypeAffiliateProgramCommission chat_id:int53 commission_per_mille:int32 = StarTransactionType;
//@class UserTransactionPurpose @description Describes purpose of a transaction with a user
//@description A user gifted Telegram Stars @sticker A sticker to be shown in the transaction information; may be null if unknown
userTransactionPurposeGiftedStars sticker:sticker = UserTransactionPurpose;
//@description The user sold a gift received from another user or bot @gift The gift
userTransactionPurposeGiftSell gift:gift = UserTransactionPurpose;
//@description The user or the bot sent a gift to a user @gift The gift
userTransactionPurposeGiftSend gift:gift = UserTransactionPurpose;
//@class StarTransactionPartner @description Describes source or recipient of a transaction with Telegram Stars
//@description The transaction is a transaction with Telegram through a bot
starTransactionPartnerTelegram = StarTransactionPartner;
//@description The transaction is a transaction with App Store
starTransactionPartnerAppStore = StarTransactionPartner;
//@description The transaction is a transaction with Google Play
starTransactionPartnerGooglePlay = StarTransactionPartner;
//@description The transaction is a transaction with Fragment @withdrawal_state State of the withdrawal; may be null for refunds from Fragment or for Telegram Stars bought on Fragment
starTransactionPartnerFragment withdrawal_state:RevenueWithdrawalState = StarTransactionPartner;
//@description The transaction is a transaction with Telegram Ad platform
starTransactionPartnerTelegramAds = StarTransactionPartner;
//@description The transaction is a transaction with Telegram for API usage @request_count The number of billed requests
starTransactionPartnerTelegramApi request_count:int32 = StarTransactionPartner;
//@description The transaction is a transaction with a bot @user_id Identifier of the bot @purpose Purpose of the transaction
starTransactionPartnerBot user_id:int53 purpose:BotTransactionPurpose = StarTransactionPartner;
//@description The transaction is a transaction with a business account @user_id Identifier of the business account user @media The bought media if the transaction wasn't refunded
starTransactionPartnerBusiness user_id:int53 media:vector<PaidMedia> = StarTransactionPartner;
//@description The transaction is a transaction with a supergroup or a channel chat @chat_id Identifier of the chat @purpose Purpose of the transaction
starTransactionPartnerChat chat_id:int53 purpose:ChatTransactionPurpose = StarTransactionPartner;
//@description The transaction is a transaction with another user @user_id Identifier of the user; 0 if the user was anonymous @purpose Purpose of the transaction
starTransactionPartnerUser user_id:int53 purpose:UserTransactionPurpose = StarTransactionPartner;
//@description The transaction is a transaction with unknown partner
starTransactionPartnerUnsupported = StarTransactionPartner;
//@description The transaction is a transaction of an unsupported type
starTransactionTypeUnsupported = StarTransactionType;
//@description Represents a transaction changing the amount of owned Telegram Stars
//@id Unique identifier of the transaction
//@star_count The amount of added owned Telegram Stars; negative for outgoing transactions
//@star_amount The amount of added owned Telegram Stars; negative for outgoing transactions
//@is_refund True, if the transaction is a refund of a previous transaction
//@date Point in time (Unix timestamp) when the transaction was completed
//@partner Source of the incoming transaction, or its recipient for outgoing transactions
starTransaction id:string star_count:int53 is_refund:Bool date:int32 partner:StarTransactionPartner = StarTransaction;
//@type Type of the transaction
starTransaction id:string star_amount:starAmount is_refund:Bool date:int32 type:StarTransactionType = StarTransaction;
//@description Represents a list of Telegram Star transactions
//@star_count The amount of owned Telegram Stars
//@star_amount The amount of owned Telegram Stars
//@transactions List of transactions with Telegram Stars
//@next_offset The offset for the next request. If empty, then there are no more results
starTransactions star_count:int53 transactions:vector<starTransaction> next_offset:string = StarTransactions;
starTransactions star_amount:starAmount transactions:vector<starTransaction> next_offset:string = StarTransactions;
//@class GiveawayParticipantStatus @description Contains information about status of a user in a giveaway
@ -1165,11 +1264,11 @@ usernames active_usernames:vector<string> disabled_usernames:vector<string> edit
//@phone_number Phone number of the user
//@status Current online status of the user
//@profile_photo Profile photo of the user; may be null
//@accent_color_id Identifier of the accent color for name, and backgrounds of profile photo, reply header, and link preview. For Telegram Premium users only
//@background_custom_emoji_id Identifier of a custom emoji to be shown on the reply header and link preview background; 0 if none. For Telegram Premium users only
//@profile_accent_color_id Identifier of the accent color for the user's profile; -1 if none. For Telegram Premium users only
//@profile_background_custom_emoji_id Identifier of a custom emoji to be shown on the background of the user's profile; 0 if none. For Telegram Premium users only
//@emoji_status Emoji status to be shown instead of the default Telegram Premium badge; may be null. For Telegram Premium users only
//@accent_color_id Identifier of the accent color for name, and backgrounds of profile photo, reply header, and link preview
//@background_custom_emoji_id Identifier of a custom emoji to be shown on the reply header and link preview background; 0 if none
//@profile_accent_color_id Identifier of the accent color for the user's profile; -1 if none
//@profile_background_custom_emoji_id Identifier of a custom emoji to be shown on the background of the user's profile; 0 if none
//@emoji_status Emoji status to be shown instead of the default Telegram Premium badge; may be null
//@is_contact The user is a contact of the current user
//@is_mutual_contact The user is a contact of the current user and the current user is a contact of the user
//@is_close_friend The user is a close friend of the current user; implies that the user is a contact
@ -1199,6 +1298,7 @@ user id:int53 access_hash:int64 first_name:string last_name:string usernames:use
//@privacy_policy_url The HTTP link to the privacy policy of the bot. If empty, then /privacy command must be used if supported by the bot. If the command isn't supported, then https://telegram.org/privacy-tpa must be opened
//@default_group_administrator_rights Default administrator rights for adding the bot to basic group and supergroup chats; may be null
//@default_channel_administrator_rights Default administrator rights for adding the bot to channels; may be null
//@affiliate_program Information about the affiliate program of the bot; may be null if none
//@web_app_background_light_color Default light background color for bot Web Apps; -1 if not specified
//@web_app_background_dark_color Default dark background color for bot Web Apps; -1 if not specified
//@web_app_header_light_color Default light header color for bot Web Apps; -1 if not specified
@ -1210,7 +1310,7 @@ user id:int53 access_hash:int64 first_name:string last_name:string usernames:use
//@edit_description_link The internal link, which can be used to edit bot description; may be null
//@edit_description_media_link The internal link, which can be used to edit the photo or animation shown in the chat with the bot if the chat is empty; may be null
//@edit_settings_link The internal link, which can be used to edit bot settings; may be null
botInfo short_description:string description:string photo:photo animation:animation menu_button:botMenuButton commands:vector<botCommand> privacy_policy_url:string default_group_administrator_rights:chatAdministratorRights default_channel_administrator_rights:chatAdministratorRights web_app_background_light_color:int32 web_app_background_dark_color:int32 web_app_header_light_color:int32 web_app_header_dark_color:int32 can_get_revenue_statistics:Bool can_manage_emoji_status:Bool has_media_previews:Bool edit_commands_link:InternalLinkType edit_description_link:InternalLinkType edit_description_media_link:InternalLinkType edit_settings_link:InternalLinkType = BotInfo;
botInfo short_description:string description:string photo:photo animation:animation menu_button:botMenuButton commands:vector<botCommand> privacy_policy_url:string default_group_administrator_rights:chatAdministratorRights default_channel_administrator_rights:chatAdministratorRights affiliate_program:affiliateProgramInfo web_app_background_light_color:int32 web_app_background_dark_color:int32 web_app_header_light_color:int32 web_app_header_dark_color:int32 can_get_revenue_statistics:Bool can_manage_emoji_status:Bool has_media_previews:Bool edit_commands_link:InternalLinkType edit_description_link:InternalLinkType edit_description_media_link:InternalLinkType edit_settings_link:InternalLinkType = BotInfo;
//@description Contains full information about a user
//@personal_photo User profile photo set by the current user for the contact; may be null. If null and user.profile_photo is null, then the photo is empty; otherwise, it is unknown.
@ -5168,7 +5268,7 @@ targetChatTypes allow_user_chats:Bool allow_bot_chats:Bool allow_group_chats:Boo
//@class TargetChat @description Describes the target chat to be opened
//@description The currently opened chat needs to be kept
//@description The currently opened chat and forum topic must be kept
targetChatCurrent = TargetChat;
//@description The chat needs to be chosen by the user among chats of the specified types @types Allowed types for the chat
@ -6815,6 +6915,11 @@ internalLinkTypeBuyStars star_count:int53 purpose:string = InternalLinkType;
//@description The link is a link to the change phone number section of the application
internalLinkTypeChangePhoneNumber = InternalLinkType;
//@description The link is an affiliate program link. Call searchChatAffiliateProgram with the given username and referrer to process the link
//@username Username to be passed to searchChatAffiliateProgram
//@referrer Referrer to be passed to searchChatAffiliateProgram
internalLinkTypeChatAffiliateProgram username:string referrer:string = InternalLinkType;
//@description The link is a link to boost a Telegram chat. Call getChatBoostLinkInfo with the given URL to process the link.
//-If the chat is found, then call getChatBoostStatus and getAvailableChatBoostSlots to get the current boost status and check whether the chat can be boosted.
//-If the user wants to boost the chat and the chat can be boosted, then call boostChat
@ -7060,6 +7165,18 @@ fileTypeSecretThumbnail = FileType;
//@description The file is a file from Secure storage used for storing Telegram Passport files
fileTypeSecure = FileType;
//@description The file is a self-destructing photo in a private chat
fileTypeSelfDestructingPhoto = FileType;
//@description The file is a self-destructing video in a private chat
fileTypeSelfDestructingVideo = FileType;
//@description The file is a self-destructing video note in a private chat
fileTypeSelfDestructingVideoNote = FileType;
//@description The file is a self-destructing voice note in a private chat
fileTypeSelfDestructingVoiceNote = FileType;
//@description The file is a sticker
fileTypeSticker = FileType;
@ -7558,12 +7675,12 @@ chatRevenueTransactions total_count:int32 transactions:vector<chatRevenueTransac
//@description Contains information about Telegram Stars earned by a bot or a chat
//@total_count Total number of Telegram Stars earned
//@current_count The number of Telegram Stars that aren't withdrawn yet
//@available_count The number of Telegram Stars that are available for withdrawal
//@total_amount Total amount of Telegram Stars earned
//@current_amount The amount of Telegram Stars that aren't withdrawn yet
//@available_amount The amount of Telegram Stars that are available for withdrawal
//@withdrawal_enabled True, if Telegram Stars can be withdrawn now or later
//@next_withdrawal_in Time left before the next withdrawal can be started, in seconds; 0 if withdrawal can be started now
starRevenueStatus total_count:int53 current_count:int53 available_count:int53 withdrawal_enabled:Bool next_withdrawal_in:int32 = StarRevenueStatus;
starRevenueStatus total_amount:starAmount current_amount:starAmount available_amount:starAmount withdrawal_enabled:Bool next_withdrawal_in:int32 = StarRevenueStatus;
//@description A detailed statistics about Telegram Stars earned by a bot or a chat
//@revenue_by_day_graph A graph containing amount of revenue in a given day
@ -8051,12 +8168,12 @@ updateChatThemes chat_themes:vector<chatTheme> = Update;
//@description The list of supported accent colors has changed
//@colors Information about supported colors; colors with identifiers 0 (red), 1 (orange), 2 (purple/violet), 3 (green), 4 (cyan), 5 (blue), 6 (pink) must always be supported
//-and aren't included in the list. The exact colors for the accent colors with identifiers 0-6 must be taken from the app theme
//@available_accent_color_ids The list of accent color identifiers, which can be set through setAccentColor and setChatAccentColor. The colors must be shown in the specififed order
//@available_accent_color_ids The list of accent color identifiers, which can be set through setAccentColor and setChatAccentColor. The colors must be shown in the specified order
updateAccentColors colors:vector<accentColor> available_accent_color_ids:vector<int32> = Update;
//@description The list of supported accent colors for user profiles has changed
//@colors Information about supported colors
//@available_accent_color_ids The list of accent color identifiers, which can be set through setProfileAccentColor and setChatProfileAccentColor. The colors must be shown in the specififed order
//@available_accent_color_ids The list of accent color identifiers, which can be set through setProfileAccentColor and setChatProfileAccentColor. The colors must be shown in the specified order
updateProfileAccentColors colors:vector<profileAccentColor> available_accent_color_ids:vector<int32> = Update;
//@description Some language pack strings have been updated @localization_target Localization target to which the language pack belongs @language_pack_id Identifier of the updated language pack @strings List of changed language pack strings; empty if all strings have changed
@ -8097,8 +8214,8 @@ updateSavedMessagesTags saved_messages_topic_id:int53 tags:savedMessagesTags = U
//@messages The list of messages with active live locations
updateActiveLiveLocationMessages messages:vector<message> = Update;
//@description The number of Telegram Stars owned by the current user has changed @star_count The new number of Telegram Stars owned
updateOwnedStarCount star_count:int53 = Update;
//@description The number of Telegram Stars owned by the current user has changed @star_amount The new amount of owned Telegram Stars
updateOwnedStarCount star_amount:starAmount = Update;
//@description The revenue earned from sponsored messages in a chat has changed. If chat revenue screen is opened, then getChatRevenueTransactions may be called to fetch new transactions
//@chat_id Identifier of the chat
@ -9545,7 +9662,7 @@ answerInlineQuery inline_query_id:int64 is_personal:Bool button:inlineQueryResul
//@chat_types Types of the chats to which the message can be sent
savePreparedInlineMessage user_id:int53 result:InputInlineQueryResult chat_types:targetChatTypes = PreparedInlineMessageId;
//@description Saves an inline message to be sent by the given user; for bots only
//@description Saves an inline message to be sent by the given user
//@bot_user_id Identifier of the bot that created the message
//@prepared_message_id Identifier of the prepared message
getPreparedInlineMessage bot_user_id:int53 prepared_message_id:string = PreparedInlineMessage;
@ -10120,7 +10237,7 @@ editStoryCover story_sender_chat_id:int53 story_id:int32 cover_frame_timestamp:d
//@description Changes privacy settings of a story. The method can be called only for stories posted on behalf of the current user and if story.can_be_edited == true
//@story_id Identifier of the story
//@privacy_settings The new privacy settigs for the story
//@privacy_settings The new privacy settings for the story
setStoryPrivacySettings story_id:int32 privacy_settings:StoryPrivacySettings = Ok;
//@description Toggles whether a story is accessible after expiration. Can be called only if story.can_toggle_is_posted_to_chat_page == true
@ -10548,7 +10665,7 @@ setVideoChatDefaultParticipant chat_id:int53 default_participant_id:MessageSende
//@chat_id Identifier of a chat in which the video chat will be created
//@title Group call title; if empty, chat title will be used
//@start_date Point in time (Unix timestamp) when the group call is expected to be started by an administrator; 0 to start the video chat immediately. The date must be at least 10 seconds and at most 8 days in the future
//@is_rtmp_stream Pass true to create an RTMP stream instead of an ordinary video chat; requires owner privileges
//@is_rtmp_stream Pass true to create an RTMP stream instead of an ordinary video chat
createVideoChat chat_id:int53 title:string start_date:int32 is_rtmp_stream:Bool = GroupCallId;
//@description Returns RTMP URL for streaming to the chat; requires can_manage_video_chats administrator right @chat_id Chat identifier
@ -10778,9 +10895,12 @@ getAllStickerEmojis sticker_type:StickerType query:string chat_id:int53 return_o
//@description Searches for stickers from public sticker sets that correspond to any of the given emoji
//@sticker_type Type of the stickers to return
//@emojis Space-separated list of emojis to search for; must be non-empty
//@emojis Space-separated list of emojis to search for
//@query Query to search for; may be empty to search for emoji only
//@input_language_codes List of possible IETF language tags of the user's input language; may be empty if unknown
//@offset The offset from which to return the stickers; must be non-negative
//@limit The maximum number of stickers to be returned; 0-100
searchStickers sticker_type:StickerType emojis:string limit:int32 = Stickers;
searchStickers sticker_type:StickerType emojis:string query:string input_language_codes:vector<string> offset:int32 limit:int32 = Stickers;
//@description Returns greeting stickers from regular sticker sets that can be used for the start page of other users
getGreetingStickers = Stickers;
@ -10910,6 +11030,9 @@ removeSavedAnimation animation:InputFile = Ok;
//@description Returns up to 20 recently used inline bots in the order of their last usage
getRecentInlineBots = Users;
//@description Returns the list of bots owned by the current user
getOwnedBots = Users;
//@description Searches for recently used hashtags by their prefix @prefix Hashtag prefix to search for @limit The maximum number of hashtags to be returned
searchHashtags prefix:string limit:int32 = Hashtags;
@ -11908,6 +12031,46 @@ editUserStarSubscription user_id:int53 telegram_payment_charge_id:string is_canc
reuseStarSubscription subscription_id:string = Ok;
//@description Changes affiliate program for a bot
//@chat_id Identifier of the chat with an owned bot for which affiliate program is changed
//@parameters Parameters of the affiliate program; pass null to close the currently active program. If there is an active program, then commission and program duration can only be increased.
//-If the active program is scheduled to be closed, then it can't be changed anymore
setChatAffiliateProgram chat_id:int53 parameters:affiliateProgramParameters = Ok;
//@description Searches a chat with an affiliate program. Returns the chat if found and the program is active
//@username Username of the chat
//@referrer The referrer from an internalLinkTypeChatAffiliateProgram link
searchChatAffiliateProgram username:string referrer:string = Chat;
//@description Searches affiliate programs that can be applied to the given chat
//@chat_id Identifier of the chat for which affiliate programs are searched for. Can be an identifier of the Saved Messages chat, of a chat with an owned bot, or of a channel chat with can_post_messages administrator right
//@sort_order Sort order for the results
//@offset Offset of the first affiliate program to return as received from the previous request; use empty string to get the first chunk of results
//@limit The maximum number of affiliate programs to return
searchAffiliatePrograms chat_id:int53 sort_order:AffiliateProgramSortOrder offset:string limit:int32 = FoundAffiliatePrograms;
//@description Connects an affiliate program to the given chat. Returns information about the connected affiliate program
//@chat_id Identifier of the chat to which the affiliate program will be connected. Can be an identifier of the Saved Messages chat, of a chat with an owned bot, or of a channel chat with can_post_messages administrator right
//@bot_user_id Identifier of the bot, which affiliate program is connected
connectChatAffiliateProgram chat_id:int53 bot_user_id:int53 = ChatAffiliateProgram;
//@description Disconnects an affiliate program from the given chat and immediately deactivates its referral link. Returns updated information about the disconnected affiliate program
//@chat_id Identifier of the chat for which the affiliate program is connected
//@url The referral link of the affiliate program
disconnectChatAffiliateProgram chat_id:int53 url:string = ChatAffiliateProgram;
//@description Returns an affiliate program that were connected to the given chat by identifier of the bot that created the program
//@chat_id Identifier of the chat for which the affiliate program was connected. Can be an identifier of the Saved Messages chat, of a chat with an owned bot, or of a channel chat with can_post_messages administrator right
//@bot_user_id Identifier of the bot that created the program
getChatAffiliateProgram chat_id:int53 bot_user_id:int53 = ChatAffiliateProgram;
//@description Returns affiliate programs that were connected to the given chat
//@chat_id Identifier of the chat for which the affiliate programs were connected. Can be an identifier of the Saved Messages chat, of a chat with an owned bot, or of a channel chat with can_post_messages administrator right
//@offset Offset of the first affiliate program to return as received from the previous request; use empty string to get the first chunk of results
//@limit The maximum number of affiliate programs to return
getChatAffiliatePrograms chat_id:int53 offset:string limit:int32 = ChatAffiliatePrograms;
//@description Returns information about features, available to Business users @source Source of the request; pass null if the method is called from settings or some non-standard source
getBusinessFeatures source:BusinessFeature = BusinessFeatures;