Тип данных Gift

Объект представляет виртуальный подарок в виде стикера, который можно отправить через бота, используя Telegram Stars.

Описание

Этот объект представляет подарок, который может быть отправлен ботом.

Поле Тип Описание
id String Уникальный идентификатор подарка
sticker Sticker Стикер, представляющий подарок
star_count Integer Количество Telegram Stars, которое необходимо оплатить для отправки стикера
upgrade_star_count Integer Необязательный. Количество Telegram Stars, которое необходимо оплатить для улучшения подарка до уникального
total_count Integer Необязательный. Общее количество подарков данного типа, которые можно отправить; только для ограниченных подарков
remaining_count Integer Необязательный. Количество оставшихся подарков данного типа, которые можно отправить; только для ограниченных подарков
publisher_chat Chat Необязательный. Информация о чате, который опубликовал подарок

Примеры

json

{
  "id": "gift_001",
  "sticker": {
    "file_id": "CAACAgIAAxkBAAIB",
    "file_unique_id": "AgADbQADwDZPEw",
    "type": "regular",
    "width": 512,
    "height": 512,
    "is_animated": false,
    "is_video": false,
    "thumbnail": {
      "file_id": "AAMCAgADGQEAAgE",
      "file_unique_id": "AQADbQADwDZPEwAB",
      "file_size": 1234,
      "width": 128,
      "height": 128
    },
    "emoji": "🎁",
    "set_name": "GiftPack",
    "premium_animation": {
      "file_id": "BAACAgIAAxkBAAIB",
      "file_unique_id": "AgADcwADwDZPEw"
    },
    "file_size": 5678
  },
  "star_count": 100,
  "upgrade_star_count": 50,
  "total_count": 1000,
  "remaining_count": 750,
  "publisher_chat": {
    "id": -1001234567890,
    "type": "channel",
    "title": "Gift Channel",
    "username": "gift_channel",
    "photo": {
      "small_file_id": "small_photo_001",
      "small_file_unique_id": "unique_small_001",
      "big_file_id": "big_photo_001",
      "big_file_unique_id": "unique_big_001"
    }
  }
}

История изменений

  • API 8.0. Добавлен объект Gift
  • API 8.2. Обновлен объект Gift: Добавлено поле upgrade_star_count
  • API 9.2. Обновлен объект Gift: Добавлено поле publisher_chat
  • API 9.3. Обновлен объект Gift: Добавлены поля personal_total_count, personal_remaining_count, is_premium, has_colors, background, unique_gift_variant_count.

Дополнительно

  • Sticker - Объект, представляющий стикер в Telegram, содержащий информацию о его типе, размере, формате и дополнительных характеристиках.
  • Chat - Объект, представляющий чат в Telegram с его основными характеристиками и типом.
Комментарии