Skip to content
Back to top
View this page

# SuggestedPostParameters

class telegram.SuggestedPostParameters(price=None, send_date=None, *, api_kwargs=None)

  Bases: `telegram.TelegramObject`

  Contains parameters of a post that is being suggested by the bot.

  Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their `price` and `send_date` are equal.

  Use In

  - `telegram.Bot.copy_message()`

  - `telegram.Bot.forward_message()`

  - `telegram.Bot.send_animation()`

  - `telegram.Bot.send_audio()`

  - `telegram.Bot.send_contact()`

  - `telegram.Bot.send_dice()`

  - `telegram.Bot.send_document()`

  - `telegram.Bot.send_invoice()`

  - `telegram.Bot.send_live_photo()`

  - `telegram.Bot.send_location()`

  - `telegram.Bot.send_message()`

  - `telegram.Bot.send_paid_media()`

  - `telegram.Bot.send_photo()`

  - `telegram.Bot.send_sticker()`

  - `telegram.Bot.send_venue()`

  - `telegram.Bot.send_video_note()`

  - `telegram.Bot.send_video()`

  - `telegram.Bot.send_voice()`

  Added in version 22.4.

  Parameters:

    - price (`telegram.SuggestedPostPrice`, optional) – Proposed price for the post. If the field is omitted, then the post is unpaid.

    - send_date (`datetime.datetime`, optional) – Proposed send date of the post. If specified, then the date must be between `300` second and `2678400` seconds (30 days) in the future. If the field is omitted, then the post can be published at any time within `2678400` seconds (30 days) at the sole discretion of the user who approves it. The default timezone of the bot is used for localization, which is UTC unless `telegram.ext.Defaults.tzinfo` is used.

  price

    Optional. Proposed price for the post. If the field is omitted, then the post is unpaid.

    Type:

      `telegram.SuggestedPostPrice`

  send_date

    Optional. Proposed send date of the post. If specified, then the date must be between `300` second and `2678400` seconds (30 days) in the future. If the field is omitted, then the post can be published at any time within `2678400` seconds (30 days) at the sole discretion of the user who approves it. The default timezone of the bot is used for localization, which is UTC unless `telegram.ext.Defaults.tzinfo` is used.

    Type:

      `datetime.datetime`

  classmethod de_json(data, bot=None)

    See `telegram.TelegramObject.de_json()`.