InputStorePaymentPremiumGiveaway

class pyrogram.raw.types.InputStorePaymentPremiumGiveaway

Used to pay for a giveaway, see here » for more info.

Constructor of InputStorePaymentPurpose.

Details:
  • Layer: 223

  • ID: 160544CA

Parameters:
  • boost_peer (InputPeer) – The channel/supergroup starting the giveaway, that the user must join to participate, that will receive the giveaway boosts; see here » for more info on giveaways.

  • random_id (int 64-bit) – Random ID to avoid resending the giveaway

  • until_date (int 32-bit) – The end date of the giveaway, must be at most giveaway_period_max seconds in the future; see here » for more info on giveaways.

  • currency (str) – Three-letter ISO 4217 currency code

  • amount (int 64-bit) – Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).

  • only_new_subscribers (bool, optional) – If set, only new subscribers starting from the giveaway creation date will be able to participate to the giveaway.

  • winners_are_visible (bool, optional) – If set, giveaway winners are public and will be listed in a messageMediaGiveawayResults message that will be automatically sent to the channel once the giveaway ends.

  • additional_peers (List of InputPeer, optional) – Additional channels that the user must join to participate to the giveaway can be specified here.

  • countries_iso2 (List of str, optional) – The set of users that can participate to the giveaway can be restricted by passing here an explicit whitelist of up to giveaway_countries_max countries, specified as two-letter ISO 3166-1 alpha-2 country codes.

  • prize_description (str, optional) – Can contain a textual description of additional giveaway prizes.

TL Schema

inputStorePaymentPremiumGiveaway#160544ca
flags:#
only_new_subscribers:flags.0?true
winners_are_visible:flags.3?true
boost_peer:InputPeer
additional_peers:flags.1?Vector<InputPeer>
countries_iso2:flags.2?Vector<string>
prize_description:flags.4?string
random_id:long
until_date:int
currency:string
amount:long

= InputStorePaymentPurpose

Parameter Tree

InputStorePaymentPremiumGiveaway
├── only_new_subscriberstrue (optional)
├── winners_are_visibletrue (optional)
├── boost_peerInputPeer
│ ├── InputPeerEmpty
│ ├── InputPeerSelf
│ ├── InputPeerChat
│ │ └── chat_idlong
│ ├── InputPeerUser
│ │ ├── user_idlong
│ │ └── access_hashlong
│ ├── InputPeerChannel
│ │ ├── channel_idlong
│ │ └── access_hashlong
│ │ ├── peerInputPeer
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ ├── msg_idint
│ │ └── user_idlong
│ ├── peerInputPeer
│ │ ├── InputPeerEmpty
│ │ ├── InputPeerSelf
│ │ ├── InputPeerChat
│ │ ├── InputPeerUser
│ │ ├── InputPeerChannel
│ │ ├── InputPeerUserFromMessage
│ │ └── InputPeerChannelFromMessage
│ ├── msg_idint
│ └── channel_idlong
├── additional_peersVector < InputPeer > (optional)
│ ├── InputPeerEmpty
│ ├── InputPeerSelf
│ ├── InputPeerChat
│ │ └── chat_idlong
│ ├── InputPeerUser
│ │ ├── user_idlong
│ │ └── access_hashlong
│ ├── InputPeerChannel
│ │ ├── channel_idlong
│ │ └── access_hashlong
│ │ ├── peerInputPeer
│ │ │ ├── InputPeerEmpty
│ │ │ ├── InputPeerSelf
│ │ │ ├── InputPeerChat
│ │ │ ├── InputPeerUser
│ │ │ ├── InputPeerChannel
│ │ │ ├── InputPeerUserFromMessage
│ │ │ └── InputPeerChannelFromMessage
│ │ ├── msg_idint
│ │ └── user_idlong
│ ├── peerInputPeer
│ │ ├── InputPeerEmpty
│ │ ├── InputPeerSelf
│ │ ├── InputPeerChat
│ │ ├── InputPeerUser
│ │ ├── InputPeerChannel
│ │ ├── InputPeerUserFromMessage
│ │ └── InputPeerChannelFromMessage
│ ├── msg_idint
│ └── channel_idlong
├── countries_iso2Vector < string > (optional)
├── prize_descriptionstring (optional)
├── random_idlong
├── until_dateint
├── currencystring
└── amountlong

Example

InputStorePaymentPremiumGiveaway(
    boost_peer=await app.resolve_peer(chat_id),
    random_id=app.rnd_id(),
    until_date=0,
    currency="text",
    amount=0,
)