telegram api constructor · layer 229 · #41df43fc

savedStarGift

Represents a gift owned by a peer.

definition

savedStarGift#41df43fc flags:# name_hidden:flags.0?true unsaved:flags.5?true refunded:flags.9?true can_upgrade:flags.10?true pinned_to_top:flags.12?true upgrade_separate:flags.17?true from_id:flags.1?Peer date:int gift:StarGift message:flags.2?TextWithEntities msg_id:flags.3?int saved_id:flags.11?long convert_stars:flags.4?long upgrade_stars:flags.6?long can_export_at:flags.7?int transfer_stars:flags.8?long can_transfer_at:flags.13?int can_resell_at:flags.14?int collection_id:flags.15?Vector<int> prepaid_upgrade_hash:flags.16?string drop_original_details_stars:flags.18?long gift_num:flags.19?int can_craft_at:flags.20?int = SavedStarGift;

parameters

nametypedescription
flags#Flags, see TL conditional fields
name_hiddenflags.0?trueIf set, the gift sender in from_id and the message are set only for the receiver of the gift.
unsavedflags.5?trueIf set, the gift is not pinned on the user's profile.
refundedflags.9?trueThis gift was upgraded to a collectible gift » and then re-downgraded to a regular gift because a request to refund the payment related to the upgrade was made, and the money was returned.
can_upgradeflags.10?trueOnly set for non-collectible gifts, if they can be upgraded to a collectible gift ».
pinned_to_topflags.12?trueWhether this gift is pinned on top of the user's profile page.
upgrade_separateflags.17?trueIf set, someone already separately pre-paid for the upgrade of this gift.
from_idflags.1?PeerSender of the gift (unset for anonymous gifts).
dateintReception date of the gift.
giftStarGiftThe collectible gift.
messageflags.2?TextWithEntitiesMessage attached to the gift.
msg_idflags.3?intFor gifts received by users, ID to use in inputSavedStarGiftUser constructors.
saved_idflags.11?longFor gifts received by channels, ID to use in inputSavedStarGiftChat constructors.
convert_starsflags.4?longFor non-collectible gifts, the receiver of this gift may convert it to this many Telegram Stars, instead of displaying it on their profile page.
upgrade_starsflags.6?longOnly for pre-paid non-collectible gifts, the number of Telegram Stars the sender has already paid to convert the gift into a collectible gift » (this is different from the meaning of the flag in messageActionStarGift, where it signals the upgrade price for not yet upgraded gifts).
can_export_atflags.7?intIf set, indicates that the current gift can't be exported to the TON blockchain » yet: the owner will be able to export it at the specified unixtime.
transfer_starsflags.8?longIf set, indicates that the gift can be transferred » to another user by paying the specified amount of stars.
can_transfer_atflags.13?intIf set, indicates that the current gift can't be transferred » yet: the owner will be able to transfer it at the specified unixtime.
can_resell_atflags.14?intIf set, indicates that the current gift can't be resold » yet: the owner will be able to put it up for sale at the specified unixtime.
collection_idflags.15?Vector<int>IDs of the collections » that this gift is a part of.
prepaid_upgrade_hashflags.16?stringHash to prepay for a gift upgrade separately ».
drop_original_details_starsflags.18?long
gift_numflags.19?int
can_craft_atflags.20?int

type

SavedStarGift

history

present in layers 198–229 · constructor id changed 6×

idlayers
#6056dba5198–202
#dfda0499203–209
#1ea646df210–211
#19a9b572212–214
#8983a452215–219
#ead6805e220–221
#41df43fc222–229