Bot API 6.6 Thumbnails renaming + other changes

[DJTommek]

Bot API 6.6 Thumbnails renaming (899bcb3f7e820d1d5b121f16cbacdb2e3c452149)

• https://core.telegram.org/bots/api-changelog#march-9-2023
• added support for thumbnail* parameters while keeping backward compatibility with deprecated thumb*
• added new \unreal4u\TelegramAPI\Telegram\Methods\setStickerSetThumbnail while keeping deprecated \unreal4u\TelegramAPI\Telegram\Methods\setStickerSetThumb

Telegram API is currently (2023-09-10) backward compatible:

• You can set thumb or thumbnail to set thumbnail in requests, both are working
• You can read thumb or thumbnail to get data about thumbnails from API, both are always filled, see snippet example from channel post:

• {
  "channel_post": {
      "document": {
          "file_name": "abcd.jpg",
          "mime_type": "image/jpeg",
          "thumbnail": {
              "file_id": "some-thumbnail-file-id",
              "file_unique_id": "some-thumbnail-file-unique-id",
              "file_size": 12345,
              "width": 320,
              "height": 240
          },
          "thumb": {
              "file_id": "some-thumbnail-file-id",
              "file_unique_id": "some-thumbnail-file-unique-id",
              "file_size": 12345,
              "width": 320,
              "height": 240
          },
          "file_id": "some-file-id",
          "file_unique_id": "some-file-unique-id",
          "file_size": 1234567
      }
  }
  }

Other updates

• ac8d8409e34fc7e3bcadac8cd20da593b4f673d4 TelegramTypes Poll: updated Chat according latest API specifications (April 21, 2023 Bot API 6.7)
• 7fcd89ade71f59f0b101f0be04d365443fa2ce62 TelegramTypes Poll: renamed $allow_multiple_answers to $allows_multiple_answers
• 201080de236da1631edf0002e95394680d983a46 TelegramMethods: added various types to SendMessage method

[unreal4u]

Nice one, thank you very much!

The only doubt I'm having is https://github.com/unreal4u/telegram-api/pull/152/files#diff-95153b05bc15eeb973f900cf269174a0f71427b1936dd00cba83bb844c344c54 but if this was previously incorrect, then we can ignore and just launch it.

I can see no mention on https://core.telegram.org/bots/api#poll on this having changed so I do believe this was a typo. In that case I can just launch a minor version.

Kudos for maintaining BC with the thumb -> thumbnail renaming! Elegant solution :)

[DJTommek]

The only doubt I'm having is https://github.com/unreal4u/telegram-api/pull/152/files#diff-95153b05bc15eeb973f900cf269174a0f71427b1936dd00cba83bb844c344c54 but if this was previously incorrect, then we can ignore and just launch it.

I can see no mention on https://core.telegram.org/bots/api#poll on this having changed so I do believe this was a typo. In that case I can just launch a minor version.

I was wondering about that change too, but don't know if they silently changed it or we did it wrong in this library. Anyway, here is snippet how update JSON looks like now, having allows_multiple_answers so no doubt:

{
  "update_id": 123456789,
  "message": {
    "message_id": 12345,
    "from": {
      "id": 148953285,
      "is_bot": false,
      "first_name": "DJTommek",
      "last_name": "[Tomas Palider]",
      "username": "DJTommek",
      "language_code": "en"
    },
    "chat": {
      "id": -123456789,
      "title": "test group",
      "type": "group",
      "all_members_are_administrators": true
    },
    "date": 1694419154,
    "poll": {
      "id": "1234567891234567891",
      "question": "some random question",
      "options": [
        {
          "text": "answer 1",
          "voter_count": 0
        },
        {
          "text": "option 2",
          "voter_count": 0
        },
        {
          "text": "another 3",
          "voter_count": 0
        }
      ],
      "total_voter_count": 0,
      "is_closed": false,
      "is_anonymous": false,
      "type": "regular",
      "allows_multiple_answers": true
    }
  }
}