电报图层变更日志
本文内容将介绍电报图层变更日志的架构变更。有关图层使用的更多详细信息,请参阅“调用 API 方法”。
第214层
要查看自上次文档刷新以来的所有更改,请从第 196 层开始阅读。
本次文档更新还带来了以下变化:
-
一个全新的文件引用数据库映射文件 »:可用于自动生成功能齐全的文件引用数据库,详情请参见此处 » 。
- 地图文件生成器是开源的,并且专门设计用于在新图层(甚至是实验性图层)上轻松运行,详情请参见此处 »。
- 图层差异现在还会列出文件参考映射文件的更改。
-
RPC 错误数据库已更新 »,现在新增了以下字段:
- business_supported- 包含可通过 invokeWithBusinessConnection 实现的业务连接中机器人可以使用的所有方法的完整列表。
- unauthed_allowed- 包含尚未登录的连接可以使用的所有方法的完整列表。
-
文档中的所有方法现在都明确说明了它们是否可以由机器人、用户或两者都使用,以及它们是否可以通过企业连接或未经授权的连接使用。
-
更新了可通过业务连接使用的方法列表
-
stories.sendStory和stories.editStory也可用于代表已连接的企业帐户发布和编辑故事:在这种情况下,只需传入企业帐户的对等节点peer,无需将请求包装在invokeWithBusinessConnection »查询中。
请注意,stories.editStory只能用于编辑同一企业机器人代表用户发布的故事。
-
stories.sendStory和stories.editStory也可用于代表已连接的企业帐户发布和编辑故事:在这种情况下,只需传入企业帐户的对等节点peer,无需将请求包装在invokeWithBusinessConnection »查询中。
-
更新了可通过未经身份验证的连接使用的方法列表
-
个人资料页面的文档也进行了重新组织,包括要显示的完整个人资料选项卡列表,以及如何填充这些选项卡的说明 »。
-
已修正 messages.getScheduledHistory 的哈希生成指令,正确的顺序是 id、edit_date、date;而不是 id、date、edit_date »
-
新增了关于冻结账户的文档»
-
新增了一个客户端配置项,用于设置测验投票答案的最大数量。
-
新增客户端配置键,用于设置可从频道或机器人余额中提取的 Telegram Stars 最大数量 »
-
增加了对年龄验证的支持(如果当前国家/地区的法律要求)»。
-
为小程序添加了设备存储和安全存储 API,使用以下事件:
- web_app_device_storage_save_key- 保存或删除与此用户和小程序关联的设备本地存储中的值
- web_app_device_storage_get_key- 从与此用户和小程序关联的设备的本地存储中获取一个值
- web_app_device_storage_clear- 清除与此用户和小程序关联的设备本地存储
- web_app_secure_storage_save_key- 保存或删除与此用户和小程序关联的设备安全存储中的值
- web_app_secure_storage_get_key- 从与此用户和小程序关联的设备安全存储中获取一个值
- web_app_secure_storage_restore_key- 将值恢复到与此用户和小程序关联的设备安全存储中
- web_app_secure_storage_clear- 清除与此用户和小程序关联的设备安全存储空间
-
在群组/频道机器人链接中添加对新manage_direct_messages管理员权限的支持。
-
更新了机器人 API 对话 ID 的文档,以支持新的 monoforum ID 范围,请参阅此处 »了解更多信息。
- 具体来说,机器人 API 对话 ID 的新范围从-4000000000000到1099511627775(之前的范围是-2002147483648到1099511627775)。
- 机器人 API 单体论坛对话 ID 的转换范围为-2002147483649包含-4000000000000范围。
-
推送通知现在可以为Telegram 网关验证消息report_delivery_until_date添加自定义参数:如果设置了该参数,则消息为 Telegram 网关验证码,并且应使用设置的标志调用messages.reportMessagesDelivery。push
-
对付费反应文档进行了更正»:messages.sendPaidReactionrandom_id的参数必须由一个 64 位整数组成,其中低 32 位是随机数,高 32 位等于当前的 Unix 时间,即:这与API 中所有其他方法的格式不同,其他方法只接受 64 位随机数。 uint64_t random_id = (time() << 32) | ((uint64_t)random_uint32_t())random_id
-
已明确,添加新的最近反应应触发缓存列表的修改和使用自定义算法重新生成哈希值,详情请参见此处» 。
-
已明确,修改已保存的消息标签应触发缓存列表的修改,并使用自定义算法重新生成哈希值,详情请参见此处» 。
-
网页类型列表已更新。
-
已澄清,在某些情况下(例如来自大型通道的更新),API 可能会返回旧层的构造函数,与连接的当前层不同。
客户端应将此视为服务器错误,并通过关闭并重新打开 TCP 套接字、使用initConnection500重新初始化会话并调用getDifference来处理此错误。 -
新增了大量功能和文章,请从第 196 层开始阅读以查看全部内容。
该层的变化如下:
- 将收藏品设为聊天主题 »
- 允许在登录时收到auth.sentCodePaymentRequired时向 Telegram 支持团队发送电子邮件(仅限官方客户端)。
架构变更
新方法
- 添加account.getUniqueGiftChatThemes- 获取所有与已拥有的收藏品礼物关联的聊天主题» 。
改变方法
- messages.setChatTheme中添加了主题参数,移除了表情符号参数。
新建筑商
- 新增聊天主题- 一个聊天主题
- 新增chatThemeUniqueGift- 一个基于收藏品的聊天主题 »。
- 新增account.chatThemesNotModified- 可用的聊天主题未被修改
- 新增account.chatThemes- 可用聊天主题
- 新增inputChatThemeEmpty- 移除当前已配置的主题。
- 添加了inputChatTheme- 设置基于表情符号的聊天主题,由account.getChatThemes返回。
- 添加inputChatThemeUniqueGift- 根据拥有的收藏品礼物设置主题 » ,由account.getUniqueGiftChatThemes返回。
已更改的构造函数
- 在messageActionSetChatTheme中添加了主题参数,移除了表情符号参数。
- 在auth.sentCodePaymentRequired中添加了support_email_address和support_email_subject参数
- 在userFull中添加了theme参数,移除了theme_emoticon参数。
- 在starGiftUnique中添加了theme_available和theme_peer参数
模式
messageActionSetChatTheme#b91bbd3a theme:ChatTheme = MessageAction; auth.sentCodePaymentRequired#d7a2fcf9 store_product:string phone_code_hash:string support_email_address:string support_email_subject:string = auth.SentCode; userFull#c577b5ad flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true voice_messages_forbidden:flags.20?true translations_disabled:flags.23?true stories_pinned_available:flags.26?true blocked_my_stories_from:flags.27?true wallpaper_overridden:flags.28?true contact_require_premium:flags.29?true read_dates_private:flags.30?true flags2:# sponsored_enabled:flags2.7?true can_view_revenue:flags2.9?true bot_can_manage_emoji_status:flags2.10?true display_gifts_button:flags2.16?true id:long about:flags.1?string settings:PeerSettings personal_photo:flags.21?Photo profile_photo:flags.2?Photo fallback_photo:flags.22?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int theme:flags.15?ChatTheme private_forward_name:flags.16?string bot_group_admin_rights:flags.17?ChatAdminRights bot_broadcast_admin_rights:flags.18?ChatAdminRights wallpaper:flags.24?WallPaper stories:flags.25?PeerStories business_work_hours:flags2.0?BusinessWorkHours business_location:flags2.1?BusinessLocation business_greeting_message:flags2.2?BusinessGreetingMessage business_away_message:flags2.3?BusinessAwayMessage business_intro:flags2.4?BusinessIntro birthday:flags2.5?Birthday personal_channel_id:flags2.6?long personal_channel_message:flags2.6?int stargifts_count:flags2.8?int starref_program:flags2.11?StarRefProgram bot_verification:flags2.12?BotVerification send_paid_messages_stars:flags2.14?long disallowed_gifts:flags2.15?DisallowedGiftsSettings stars_rating:flags2.17?StarsRating stars_my_pending_rating:flags2.18?StarsRating stars_my_pending_rating_date:flags2.18?int main_tab:flags2.20?ProfileTab saved_music:flags2.21?Document = UserFull; chatTheme#c3dffc04 emoticon:string = ChatTheme; chatThemeUniqueGift#3458f9c8 gift:StarGift theme_settings:Vector<ThemeSettings> = ChatTheme; account.chatThemesNotModified#e011e1c4 = account.ChatThemes; account.chatThemes#16484857 flags:# hash:long themes:Vector<ChatTheme> chats:Vector<Chat> users:Vector<User> next_offset:flags.0?int = account.ChatThemes; starGiftUnique#1befe865 flags:# require_premium:flags.6?true resale_ton_only:flags.7?true theme_available:flags.9?true id:long gift_id:long title:string slug:string num:int owner_id:flags.0?Peer owner_name:flags.1?string owner_address:flags.2?string attributes:Vector<StarGiftAttribute> availability_issued:int availability_total:int gift_address:flags.3?string resell_amount:flags.4?Vector<StarsAmount> released_by:flags.5?Peer value_amount:flags.8?long value_currency:flags.8?string theme_peer:flags.10?Peer = StarGift; inputChatThemeEmpty#83268483 = InputChatTheme; inputChatTheme#c93de95c emoticon:string = InputChatTheme; inputChatThemeUniqueGift#87e5dfe4 slug:string = InputChatTheme; ---functions--- account.getUniqueGiftChatThemes#fe74ef9f offset:int limit:int hash:long = account.ChatThemes; messages.setChatTheme#081202c9 peer:InputPeer theme:InputChatTheme = Updates;
文件引用映射文件架构 »更改
新建筑商
- 新增 boolFalse - 构造函数可以被解释为布尔false值。
- 新增 boolTrue - 构造函数可以解释为布尔true值。
- 添加了 true - 请参阅预定义的标识符。
- 新增向量——一个通用的向量构造器。
- 添加了 fileReferenceOrigins
- 已添加位置传入
- 添加了位置(已发送)
- 添加源
- 添加了 skippedOrigin
- 新增操作
- 添加了 paramNotFlag
- 添加了 paramIsFlagAbortIfEmpty
- 添加了 paramIsFlagFallback
- 添加了 paramIsFlagPassthrough
- 添加路径部分
- 添加路径
- 添加路径父级
- 添加了 extractAndStore
- 添加了从文档属性提取输入贴纸集并存储
- 添加了 extractInputStickerSetFromStickerSetAndStore
- 添加了 extractPeerIdFromPeerAndStore
- 添加了 extractPeerIdFromInputPeerAndStore
- 添加了 extractChannelIdFromChannelAndStore
- 添加了 extractChannelIdFromInputChannelAndStore
- 添加了 extractUserIdFromUserAndStore
- 添加了从输入用户提取用户 ID 并存储
- 新增 callOp
- 添加了 getMessageOp
- 添加了 typedOpArg
- 添加了 typedOp
- 添加了 copyOp
- 添加了 getInputChannelByIdOp
- 添加了 getInputUserByIdOp
- 添加了 getInputPeerByIdOp
- 添加了构造函数操作
- 添加了 vectorOp
- 添加 intLiteralOp
- 添加了 longLiteralOp
- 添加了 stringLiteralOp
- 添加了 bytesLiteralOp
- 添加了 boolLiteralOp
- 添加了 doubleLiteralOp
- 添加了主题格式文字操作
文件引用映射文件架构 »
boolFalse#bc799737 = Bool; boolTrue#997275b5 = Bool; true#3fedd339 = True; vector#1cb5c415 {t:Type} # [ t ] = Vector t; fileReferenceOrigins#ed01a4f1 db_schema:string db_schema_json:string locations:Vector<Location> origins:Vector<Origin> skipped:Vector<SkippedOrigin> actions:Vector<Action> = FileReferenceOrigins;locationIncoming#e18770f4 predicate:string stored_constructor:string = Location;locationOutgoing#e7740ae0 predicate:string stored_constructor:string = Location; origin#b62177bf flags:# predicate:string is_constructor:flags.0?true stored_constructor:string stored_params:Vector<FieldExtractor> skipped_flags:Vector<string> needs_parent:flags.3?string parent_is_constructor:flags.4?true = origin; skippedOrigin#7c62809e flags:# predicate:string is_constructor:flags.0?true why:string = SkippedOrigin; action#9539f410 stored_constructor:string action:ActionOp = Action;paramNotFlag#acd9d5cf = ParamFlag;paramIsFlagAbortIfEmpty#f8fe9fee = ParamFlag;paramIsFlagFallback#202b77a1 fallback:TypedOp = ParamFlag;paramIsFlagPassthrough#1dc6e17d = ParamFlag;pathPart#8dc6ff46 constructor:string param:string flag:ParamFlag = PathPart;path#0c3586a2 parts:Vector<PathPart> = Path;pathParent#58f13684 parts:Vector<PathPart> = Path;extractAndStore#72069549 from:Path to:string = FieldExtractor;extractInputStickerSetFromDocumentAttributesAndStore#369d8d14 from:Path to:string = FieldExtractor;extractInputStickerSetFromStickerSetAndStore#c167d470 from:Path to:string = FieldExtractor;extractPeerIdFromPeerAndStore#7d33019c from:Path to:string = FieldExtractor;extractPeerIdFromInputPeerAndStore#a51acfb4 from:Path to:string = FieldExtractor;extractChannelIdFromChannelAndStore#5675bc97 from:Path to:string = FieldExtractor;extractChannelIdFromInputChannelAndStore#b662660e from:Path to:string = FieldExtractor;extractUserIdFromUserAndStore#4778ec63 from:Path to:string = FieldExtractor;extractUserIdFromInputUserAndStore#7720aa2e from:Path to:string = FieldExtractor; callOp#c2ff3383 method:string args:Vector<TypedOpArg> = ActionOp; getMessageOp#237849e8 peer:TypedOp id:TypedOp from_scheduled:TypedOp quick_reply_shortcut_id:TypedOp = ActionOp;typedOpArg#3a2930c2 key:string value:TypedOp = TypedOpArg;typedOp#705b10ec type:string op:TypedOpOp = TypedOp; copyOp#f48f418f from:string = TypedOpOp;getInputChannelByIdOp#3cb47531 from:string = TypedOpOp;getInputUserByIdOp#c0ee4326 from:string = TypedOpOp;getInputPeerByIdOp#19813750 from:string = TypedOpOp; constructorOp#107f8d8a constructor:string args:Vector<TypedOpArg> = TypedOpOp; vectorOp#f8fb8f72 values:Vector<TypedOp> = TypedOpOp; intLiteralOp#cbfabe7c value:int = TypedOpOp; longLiteralOp#d08b8d3a value:long = TypedOpOp; stringLiteralOp#2b56ea8e value:string = TypedOpOp;bytesLiteralOp#fdb395a4 value:bytes = TypedOpOp;boolLiteralOp#37e07911 value:Bool = TypedOpOp; doubleLiteralOp#3651e3bf value:double = TypedOpOp; themeFormatLiteralOp#8e4f9208 = TypedOpOp;
文件引用数据库架构 »变更
新建筑商
- 新增 boolFalse - 构造函数可以被解释为布尔false值。
- 新增 boolTrue - 构造函数可以解释为布尔true值。
- 添加了 true - 请参阅预定义的标识符。
- 新增向量——一个通用的向量构造器。
- 添加了 fileIdPhoto
- 添加了文件 ID 文档
- 添加了 fileSourceMessage
- 已添加文件源星交易
- 添加了文件源故事
- 添加了文件源网页
- 添加了 fileSourceBotApp
- 添加了 fileSourceUserFull
- 添加了文件源管理日志
- 添加了文件源故事专辑
- 添加了文件源BotPreviewMedia
- 添加了 fileSourceBotPreviewInfo
- 添加了文件源付费媒体
- 已添加文件源已保存的音乐
- 已添加文件源ChatFull
- 已添加 fileSourceChannelFull
- 添加了 fileSourcePremiumPromo
- 添加了 fileSourceAttachMenuBot
- 添加了文件源主题
- 添加了文件源壁纸
- 添加了文件源贴纸集
- 已添加文件源已保存的Gifs
- 已添加文件源已保存铃声
- 添加了 fileSourceAvailableEffects
- 添加了 fileSourceAvailableReactions
- 添加了文件源用户个人资料照片
- 添加了 fileSourceDocumentByHash
文件引用数据库架构 »
boolFalse#bc799737 = Bool; boolTrue#997275b5 = Bool; true#3fedd339 = True; vector#1cb5c415 {t:Type} # [ t ] = Vector t;fileIdPhoto#47a0bd49 id:long = FileId;fileIdDocument#461b1d89 id:long = FileId;fileSourceMessage#7e015bb0 flags:# from_scheduled:flags.0?true quick_reply_shortcut_id:flags.1?int peer:long id:int = FileSource;fileSourceStarsTransaction#c1bac8c7 flags:# peer:long id:string refund:flags.0?true ton:flags.1?true = FileSource;fileSourceStory#c820e3eb id:int peer:long = FileSource;fileSourceWebPage#9e5b749c url:string = FileSource;fileSourceBotApp#01cf8b7a id:long access_hash:long = FileSource;fileSourceUserFull#70fdb7b0 id:long = FileSource;fileSourceAdminLog#4797f959 channel:long max_id:long = FileSource;fileSourceStoryAlbum#5e01f223 peer:long = FileSource;fileSourceBotPreviewMedia#0aa91441 bot:long = FileSource;fileSourceBotPreviewInfo#f9d2d6fc bot:long lang_code:string = FileSource;fileSourcePaidMedia#b18d9042 id:int peer:long = FileSource;fileSourceSavedMusic#dd1a7664 user_id:long id:long access_hash:long = FileSource;fileSourceChatFull#9de75fde chat_id:long = FileSource;fileSourceChannelFull#6fe19339 channel:long = FileSource;fileSourcePremiumPromo#c907a44f = FileSource;fileSourceAttachMenuBot#c3002694 bot:long = FileSource;fileSourceTheme#92d05e0c id:long access_hash:long = FileSource;fileSourceWallPaper#50dbf2f7 id:long access_hash:long = FileSource;fileSourceStickerSet#34c73709 stickerset:InputStickerSet = FileSource;fileSourceSavedGifs#13e78e07 = FileSource;fileSourceSavedRingtones#2b25ef1b = FileSource;fileSourceAvailableEffects#eb8578f0 = FileSource;fileSourceAvailableReactions#0e432388 = FileSource;fileSourceUserProfilePhoto#e39ee274 user_id:long max_id:long = FileSource;fileSourceDocumentByHash#0f151e0f sha256:bytes size:long mime_type:string = FileSource;
文件引用数据库映射文件发生更改 »
新地点
- 已添加输入照片-fileIdPhoto(发送)
- 已添加输入文档-fileIdDocument(传出)
- 添加了inputDocumentFileLocation-fileIdDocument(outgoing)
- 添加了inputPhotoFileLocation-fileIdPhoto(输出)
- 已添加文档-fileIdDocument(即将收到)
- 已添加照片-fileIdPhoto(即将发布)
新起源
- 已添加消息-fileSourceMessage{from_scheduled: message.from_scheduled?passthrough, quick_reply_shortcut_id: message.quick_reply_shortcut_id?passthrough, peer: extractPeerIdFromPeerAndStore(message.peer_id), id: message.id}
- 添加了消息服务-fileSourceMessage{peer: extractPeerIdFromPeerAndStore(messageService.peer_id), id: messageService.id, from_scheduled: false, quick_reply_shortcut_id: false}
- 新增 (1)故事项-(needs stories.getPinnedStories) fileSourceStory{id: storyItem.id, peer: extractPeerIdFromInputPeerAndStore(stories.getPinnedStories.peer)}
- 新增 (2)故事项-(needs stories.getStoriesArchive) fileSourceStory{id: storyItem.id, peer: extractPeerIdFromInputPeerAndStore(stories.getStoriesArchive.peer)}
- 新增 (3)故事项-(needs stories.getStoriesByID) fileSourceStory{id: storyItem.id, peer: extractPeerIdFromInputPeerAndStore(stories.getStoriesByID.peer)}
- 新增 (4)故事项-(needs stories.getAlbumStories) fileSourceStory{id: storyItem.id, peer: extractPeerIdFromInputPeerAndStore(stories.getAlbumStories.peer)}
- 新增 (5)故事项-(needs peerStories) fileSourceStory{id: storyItem.id, peer: extractPeerIdFromPeerAndStore(peerStories.peer)}
- 新增 (6)故事项-fileSourceStory{id: storyItem.id, peer: extractPeerIdFromPeerAndStore(storyItem.from_id?abort_if_empty)}
- 添加了storyViewPublicRepost-fileSourceStory{id: storyViewPublicRepost.story.storyItem.id, peer: extractPeerIdFromPeerAndStore(storyViewPublicRepost.peer_id)}
- 添加了故事反应公开转发-fileSourceStory{id: storyReactionPublicRepost.story.storyItem.id, peer: extractPeerIdFromPeerAndStore(storyReactionPublicRepost.peer_id)}
- 添加了foundStory-fileSourceStory{id: foundStory.story.storyItem.id, peer: extractPeerIdFromPeerAndStore(foundStory.peer)}
- 添加了公共前瞻故事-fileSourceStory{id: publicForwardStory.story.storyItem.id, peer: extractPeerIdFromPeerAndStore(publicForwardStory.peer)}
- 添加了webPageAttributeStory-fileSourceStory{id: webPageAttributeStory.story?abort_if_empty.storyItem.id, peer: extractPeerIdFromPeerAndStore(webPageAttributeStory.peer)}
- 添加了消息媒体故事-fileSourceStory{id: messageMediaStory.story?abort_if_empty.storyItem.id, peer: extractPeerIdFromPeerAndStore(messageMediaStory.peer)}
- 已添加网页-fileSourceWebPage{url: webPage.url}
- 已添加botApp-fileSourceBotApp{id: botApp.id, access_hash: botApp.access_hash}
- 已添加botInfo-fileSourceUserFull{id: botInfo.user_id?abort_if_empty}
- 添加了channelAdminLogEvent-(needs channels.getAdminLog) fileSourceAdminLog{channel: extractChannelIdFromInputChannelAndStore(channels.getAdminLog.channel), max_id: channelAdminLogEvent.id}
- 添加了stories.createAlm-fileSourceStoryAlbum{peer: extractPeerIdFromInputPeerAndStore(stories.createAlbum.peer)}
- 添加了stories.getAlbums-fileSourceStoryAlbum{peer: extractPeerIdFromInputPeerAndStore(stories.getAlbums.peer)}
- 已添加故事。更新专辑-fileSourceStoryAlbum{peer: extractPeerIdFromInputPeerAndStore(stories.updateAlbum.peer)}
- 已添加bots.getPreviewMedias-fileSourceBotPreviewMedia{bot: extractUserIdFromInputUserAndStore(bots.getPreviewMedias.bot)}
- 已添加bots.getPreviewInfo-fileSourceBotPreviewInfo{bot: extractUserIdFromInputUserAndStore(bots.getPreviewInfo.bot), lang_code: bots.getPreviewInfo.lang_code}
- 已添加bots.addPreviewMedia-fileSourceBotPreviewInfo{bot: extractUserIdFromInputUserAndStore(bots.addPreviewMedia.bot), lang_code: bots.addPreviewMedia.lang_code}
- 已添加bots.editPreviewMedia-fileSourceBotPreviewInfo{bot: extractUserIdFromInputUserAndStore(bots.editPreviewMedia.bot), lang_code: bots.editPreviewMedia.lang_code}
- 添加了updateMessageExtendedMedia-fileSourcePaidMedia{id: updateMessageExtendedMedia.msg_id, peer: extractPeerIdFromPeerAndStore(updateMessageExtendedMedia.peer)}
- 新增 (1)userFull-fileSourceUserFull{id: userFull.id}
- 新增 (2)userFull-fileSourceSavedMusic{user_id: userFull.id, id: userFull.saved_music?abort_if_empty.document.id, access_hash: userFull.saved_music?abort_if_empty.document.access_hash}
- 已添加聊天功能-fileSourceChatFull{chat_id: chatFull.id}
- 已添加频道完整-fileSourceChannelFull{channel: channelFull.id}
- 添加了help.getPremiumPromo-fileSourcePremiumPromo{}
- 新增 (1)starsTransaction-(needs payments.getStarsStatus) fileSourceStarsTransaction{peer: extractPeerIdFromInputPeerAndStore(payments.getStarsStatus.peer), ton: payments.getStarsStatus.ton?passthrough, id: starsTransaction.id, refund: starsTransaction.refund?passthrough}
- 新增 (2)星交易-(needs payments.getStarsTransactions) fileSourceStarsTransaction{peer: extractPeerIdFromInputPeerAndStore(payments.getStarsTransactions.peer), ton: payments.getStarsTransactions.ton?passthrough, id: starsTransaction.id, refund: starsTransaction.refund?passthrough}
- 新增 (3)星交易-(needs payments.getStarsTransactionsByID) fileSourceStarsTransaction{peer: extractPeerIdFromInputPeerAndStore(payments.getStarsTransactionsByID.peer), ton: payments.getStarsTransactionsByID.ton?passthrough, id: starsTransaction.id, refund: starsTransaction.refund?passthrough}
- 新增 (4)星交易-(needs payments.getStarsSubscriptions) fileSourceStarsTransaction{peer: extractPeerIdFromInputPeerAndStore(payments.getStarsSubscriptions.peer), id: starsTransaction.id, refund: starsTransaction.refund?passthrough, ton: false}
- 添加了attachMenuBot-fileSourceAttachMenuBot{bot: attachMenuBot.bot_id}
- 添加了主题-fileSourceTheme{id: theme.id, access_hash: theme.access_hash}
- 添加了壁纸-fileSourceWallPaper{id: wallPaper.id, access_hash: wallPaper.access_hash}
- 添加了stickerSetMultiCovered-fileSourceStickerSet{stickerset: extractInputStickerSetFromStickerSetAndStore(stickerSetMultiCovered.set)}
- 添加了stickerSetFullCovered-fileSourceStickerSet{stickerset: extractInputStickerSetFromStickerSetAndStore(stickerSetFullCovered.set)}
- 添加了messages.stickerSet-fileSourceStickerSet{stickerset: extractInputStickerSetFromStickerSetAndStore(messages.stickerSet.set)}
- 已添加消息.savedGifs-fileSourceSavedGifs{}
- 已添加帐户.savedRingtones-fileSourceSavedRingtones{}
- 已添加帐户.savedRingtoneConverted -fileSourceSavedRingtones{}
- 已添加帐户.uploadRingtone-fileSourceSavedRingtones{}
- 添加了messages.availableEffects-fileSourceAvailableEffects{}
- 已添加消息。可用反应-fileSourceAvailableReactions{}
- 已添加照片-(needs photos.getUserPhotos) fileSourceUserProfilePhoto{user_id: extractUserIdFromInputUserAndStore(photos.getUserPhotos.user_id), max_id: photo.id}
- 已添加照片。更新个人资料照片-fileSourceUserProfilePhoto{user_id: extractUserIdFromInputUserAndStore(photos.updateProfilePhoto.bot?fallback(inputUserSelf{})), max_id: photos.updateProfilePhoto.(return value).photos.photo.photo.photo.id}
- 已添加照片。uploadProfilePhoto-fileSourceUserProfilePhoto{user_id: extractUserIdFromInputUserAndStore(photos.uploadProfilePhoto.bot?fallback(inputUserSelf{})), max_id: photos.uploadProfilePhoto.(return value).photos.photo.photo.photo.id}
- 已添加照片。上传联系人个人资料照片-fileSourceUserProfilePhoto{user_id: extractUserIdFromInputUserAndStore(photos.uploadContactProfilePhoto.user_id), max_id: photos.uploadContactProfilePhoto.(return value).photos.photo.photo.photo.id}
- 新增(1)份文件-fileSourceStickerSet{stickerset: extractInputStickerSetFromDocumentAttributesAndStore(document.attributes)}
- 新增(2)份文件-(needs users.getSavedMusic) fileSourceSavedMusic{user_id: extractUserIdFromInputUserAndStore(users.getSavedMusic.id), id: document.id, access_hash: document.access_hash}
- 新增(3)份文件-(needs users.getSavedMusicByID) fileSourceSavedMusic{user_id: extractUserIdFromInputUserAndStore(users.getSavedMusicByID.id), id: document.id, access_hash: document.access_hash}
- 添加了messages.getDocumentByHash-fileSourceDocumentByHash{sha256: messages.getDocumentByHash.sha256, size: messages.getDocumentByHash.size, mime_type: messages.getDocumentByHash.mime_type}
新跳过
- 新增messages.getSponsoredMessages- 不再存储赞助消息中的文件引用
- 新增help.getAppUpdate- 不处理来自临时应用更新信息的文件引用
- 新增help.getRecentMeUrls- 不再处理来自最近 t.me URL 的文件引用
- 新增recentMeUrlChatInvite- 不存储基于聊天邀请链接的引用
- 新增messages.checkChatInvite- 不存储基于聊天邀请链接的引用
- 新增messages.getInlineBotResults- 内联机器人结果是临时的
- 新增messages.getPreparedInlineMessage- 内联机器人结果是临时的
- 新增messages.uploadMedia- 新上传的媒体文件只有在发送到聊天窗口后才会获得上下文
- 新增messages.uploadImportedMedia- 新上传的媒体文件只有在发送到聊天窗口后才会获得上下文
- 新增updateServiceNotification- 无法重新获取服务通知
- 新增messages.getWebPagePreview- 由于该方法调用不使用持久 ID 作为输入,因此不会添加任何位置信息;位置信息是从返回的 WebPage 对象中的持久 ID 中提取的。
- 新增了payments.resaleStarGifts- 星形礼品的上下文尚未实现
- 新增payments.starGiftUpgradePreview- 星级礼物的相关功能尚未实现
- 新增starGift- 星形礼物的相关上下文尚未实现
- 新增starGiftUnique- 星形礼物的上下文尚未实现
- 新增starGiftCollection- 星形礼物的上下文尚未实现
- 已添加payments.starGiftCollections- 星形礼品的上下文尚未实现
- 添加了messages.getCustomEmojiDocuments- 在此上下文中不存储文件引用
- 新增account.uploadTheme 功能- 新上传的主题文件只有在通过 account.createTheme 创建后才能获得上下文。
新行动
- 添加了 fileSourceMessage -getMessageOp(peer: getInputPeerByIdOp(peer), id: copyOp(id), from_scheduled: copyOp(from_scheduled)quick_reply_shortcut_id: copyOp(quick_reply_shortcut_id))
- 已添加文件源故事 -stories.getStoriesByID(id: [copyOp(id)], peer: getInputPeerByIdOp(peer))
- 已添加 fileSourceWebPage -messages.getWebPage(url: copyOp(url), hash: 0)
- 已添加 fileSourceBotApp -messages.getBotApp(app: inputBotAppID{id: copyOp(id), access_hash: copyOp(access_hash)}, hash: 0)
- 添加了 fileSourceUserFull -users.getFullUser(id: getInputUserByIdOp(id))
- 添加了 fileSourceAdminLog -channels.getAdminLog(channel: getInputChannelByIdOp(channel), max_id: copyOp(max_id), min_id: copyOp(max_id), limit: 1, q: "")
- 已添加文件源故事专辑 -stories.getAlbums(peer: getInputPeerByIdOp(peer), hash: 0)
- 已添加文件源BotPreviewMedia -bots.getPreviewMedias(bot: getInputUserByIdOp(bot))
- 添加了 fileSourceBotPreviewInfo -bots.getPreviewInfo(bot: getInputUserByIdOp(bot), lang_code: copyOp(lang_code))
- 已添加文件源付费媒体 -messages.getExtendedMedia(id: [copyOp(id)], peer: getInputPeerByIdOp(peer))
- 已添加文件源SavedMusic -users.getSavedMusicByID(id: getInputUserByIdOp(user_id), documents: [inputDocument{id: copyOp(id), access_hash: copyOp(access_hash), file_reference: base64_decode("")}])
- 已添加 fileSourceChatFull -messages.getFullChat(chat_id: copyOp(chat_id))
- 已添加 fileSourceChannelFull -channels.getFullChannel(channel: getInputChannelByIdOp(channel))
- 已添加 fileSourcePremiumPromo -help.getPremiumPromo()
- 已添加文件源星交易 -payments.getStarsTransactionsByID(peer: getInputPeerByIdOp(peer), ton: copyOp(ton), id: [inputStarsTransaction{id: copyOp(id), refund: copyOp(refund)}])
- 添加了 fileSourceAttachMenuBot -messages.getAttachMenuBot(bot: getInputUserByIdOp(bot))
- 添加了 fileSourceTheme -account.getTheme(theme: inputTheme{id: copyOp(id), access_hash: copyOp(access_hash)}, format: $themeFormat)
- 已添加文件源壁纸 -account.getWallPaper(wallpaper: inputWallPaper{id: copyOp(id), access_hash: copyOp(access_hash)})
- 添加了 fileSourceStickerSet -messages.getStickerSet(stickerset: copyOp(stickerset), hash: 0)
- 已添加文件源已保存的Gifs -messages.getSavedGifs(hash: 0)
- 已添加文件源已保存铃声 -account.getSavedRingtones(hash: 0)
- 添加了 fileSourceAvailableEffects -messages.getAvailableEffects(hash: 0)
- 已添加 fileSourceAvailableReactions -messages.getAvailableReactions(hash: 0)
- 已添加 fileSourceUserProfilePhoto -photos.getUserPhotos(user_id: getInputUserByIdOp(user_id), offset: -1, max_id: copyOp(max_id), limit: 1)
- 添加了 fileSourceDocumentByHash -messages.getDocumentByHash(sha256: copyOp(sha256), size: copyOp(size), mime_type: copyOp(mime_type))
第213层
此层引入了以下新功能:
- 更改默认配置文件选项卡 »
- 将音乐保存到个人资料 »
- 为 starGift添加了一个locked_until_date标记,用于标记在指定日期之前无法发送的锁定礼物。
- 添加了 payments.checkCanSendGift 方法,用于检查未锁定的礼物是否由于其他原因而无法发送。
- 在 inputStorePaymentStarsTopup 中添加了一个可选spend_purpose_peer标志,该标志应填充因余额不足而发起充值流程的对等方(例如,用于机器人支付的机器人、用于付费媒体/互动的频道等)»
个人资料页面的文档也进行了重新组织,包括要显示的完整选项卡列表,以及如何填充这些选项卡的说明 »。
架构变更
新方法
- 添加了account.setMainProfileTab- 更改当前用户的主个人资料选项卡,请参阅此处»了解更多信息。
- 新增account.saveMusic- 从当前用户的个人资料中添加或删除歌曲,请点击此处 »了解有关个人资料页面音乐选项卡的更多信息。
- 添加了account.getSavedMusicIds - 获取当前添加到个人资料中的歌曲ID 的完整列表,请参阅此处 »了解更多信息。
- 新增users.getSavedMusic - 获取用户个人资料中固定的歌曲,点击此处»了解更多信息。
- 添加了users.getSavedMusicByID- 检查传递的歌曲是否仍然固定在用户的个人资料中,或者刷新固定在用户个人资料中的歌曲的文件引用,请参阅此处»了解更多信息。
- 添加了channels.setMainProfileTab- 更改频道的主个人资料选项卡,请参阅此处»了解更多信息。
- 添加了payments.checkCanSendGift- 检查指定的礼物是否可以发送。
新建筑商
- 新增profileTabPosts- 表示个人资料页面的“故事”选项卡。
- 添加了profileTabGifts- 表示个人资料页面的礼物选项卡。
- 新增profileTabMedia- 表示个人资料页面的媒体选项卡。
- 新增profileTabFiles- 表示配置文件的共享文件选项卡。
- 添加了profileTabMusic- 表示个人资料页面的音乐选项卡。
- 新增profileTabVoice- 表示个人资料页面的语音消息选项卡。
- 新增profileTabLinks- 表示个人资料页面的共享链接选项卡。
- 新增profileTabGifs- 代表个人资料页面的 GIF 选项卡。
- 添加了users.savedMusicNotModified- 用户个人资料中当前置顶的歌曲子集未发生更改,请点击此处»了解更多信息。
- 新增users.savedMusic- 用户个人资料中当前置顶的歌曲列表,点击此处»了解更多信息。
- 添加了account.savedMusicIdsNotModified- 当前固定在我们个人资料中的歌曲 ID 列表(文档id)尚未更改。
- 添加了account.savedMusicIds-当前已置顶在我们个人资料中的歌曲 ID 列表(文档)。点击此处查看更多信息 »。id
- 添加了payments.checkCanSendGiftResultOk- 指定的礼物可以发送。
- 添加了payments.checkCanSendGiftResultFail- 由于指定的原因,指定的礼物暂时无法发送。
已更改的构造函数
- 在channelFull中添加main_tab参数
- 在messageActionStarGift中添加upgrade_separate参数
- 在userFull中添加了main_tab和saved_music参数
- 在inputStorePaymentStarsTopup中添加了flags和spend_purpose_peer参数
- starGift中添加了locked_until_date参数
- 在payments.uniqueStarGift中添加了聊天参数
- 在messages.webPagePreview中添加了聊天参数
- 在savedStarGift中添加upgrade_separate参数
模式
channelFull#e4e0b29d flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true flags2:# can_delete_channel:flags2.0?true antispam:flags2.1?true participants_hidden:flags2.2?true translations_disabled:flags2.3?true stories_pinned_available:flags2.5?true view_forum_as_messages:flags2.6?true restricted_sponsored:flags2.11?true can_view_revenue:flags2.12?true paid_media_allowed:flags2.14?true can_view_stars_revenue:flags2.15?true paid_reactions_available:flags2.16?true stargifts_available:flags2.19?true paid_messages_available:flags2.20?true id:long about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:flags.23?ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?long migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?long location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int call:flags.21?InputGroupCall ttl_period:flags.24?int pending_suggestions:flags.25?Vector<string> groupcall_default_join_as:flags.26?Peer theme_emoticon:flags.27?string requests_pending:flags.28?int recent_requesters:flags.28?Vector<long> default_send_as:flags.29?Peer available_reactions:flags.30?ChatReactions reactions_limit:flags2.13?int stories:flags2.4?PeerStories wallpaper:flags2.7?WallPaper boosts_applied:flags2.8?int boosts_unrestrict:flags2.9?int emojiset:flags2.10?StickerSet bot_verification:flags2.17?BotVerification stargifts_count:flags2.18?int send_paid_messages_stars:flags2.21?long main_tab:flags2.22?ProfileTab = ChatFull; messageActionStarGift#f24de7fa flags:# name_hidden:flags.0?true saved:flags.2?true converted:flags.3?true upgraded:flags.5?true refunded:flags.9?true can_upgrade:flags.10?true prepaid_upgrade:flags.13?true upgrade_separate:flags.16?true gift:StarGift message:flags.1?TextWithEntities convert_stars:flags.4?long upgrade_msg_id:flags.5?int upgrade_stars:flags.8?long from_id:flags.11?Peer peer:flags.12?Peer saved_id:flags.12?long prepaid_upgrade_hash:flags.14?string gift_msg_id:flags.15?int = MessageAction; userFull#3fd81e28 flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true voice_messages_forbidden:flags.20?true translations_disabled:flags.23?true stories_pinned_available:flags.26?true blocked_my_stories_from:flags.27?true wallpaper_overridden:flags.28?true contact_require_premium:flags.29?true read_dates_private:flags.30?true flags2:# sponsored_enabled:flags2.7?true can_view_revenue:flags2.9?true bot_can_manage_emoji_status:flags2.10?true display_gifts_button:flags2.16?true id:long about:flags.1?string settings:PeerSettings personal_photo:flags.21?Photo profile_photo:flags.2?Photo fallback_photo:flags.22?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int theme_emoticon:flags.15?string private_forward_name:flags.16?string bot_group_admin_rights:flags.17?ChatAdminRights bot_broadcast_admin_rights:flags.18?ChatAdminRights wallpaper:flags.24?WallPaper stories:flags.25?PeerStories business_work_hours:flags2.0?BusinessWorkHours business_location:flags2.1?BusinessLocation business_greeting_message:flags2.2?BusinessGreetingMessage business_away_message:flags2.3?BusinessAwayMessage business_intro:flags2.4?BusinessIntro birthday:flags2.5?Birthday personal_channel_id:flags2.6?long personal_channel_message:flags2.6?int stargifts_count:flags2.8?int starref_program:flags2.11?StarRefProgram bot_verification:flags2.12?BotVerification send_paid_messages_stars:flags2.14?long disallowed_gifts:flags2.15?DisallowedGiftsSettings stars_rating:flags2.17?StarsRating stars_my_pending_rating:flags2.18?StarsRating stars_my_pending_rating_date:flags2.18?int main_tab:flags2.20?ProfileTab saved_music:flags2.21?Document = UserFull; inputStorePaymentStarsTopup#f9a2a6cb flags:# stars:long currency:string amount:long spend_purpose_peer:flags.0?InputPeer = InputStorePaymentPurpose; starGift#80ac53c3 flags:# limited:flags.0?true sold_out:flags.1?true birthday:flags.2?true require_premium:flags.7?true limited_per_user:flags.8?true id:long sticker:Document stars:long availability_remains:flags.0?int availability_total:flags.0?int availability_resale:flags.4?long convert_stars:long first_sale_date:flags.1?int last_sale_date:flags.1?int upgrade_stars:flags.3?long resell_min_stars:flags.4?long title:flags.5?string released_by:flags.6?Peer per_user_total:flags.8?int per_user_remains:flags.8?int locked_until_date:flags.9?int = StarGift; payments.uniqueStarGift#416c56e8 gift:StarGift chats:Vector<Chat> users:Vector<User> = payments.UniqueStarGift; messages.webPagePreview#8c9a88ac media:MessageMedia chats:Vector<Chat> users:Vector<User> = messages.WebPagePreview; savedStarGift#19a9b572 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 = SavedStarGift; profileTabPosts#b98cd696 = ProfileTab; profileTabGifts#4d4bd46a = ProfileTab; profileTabMedia#72c64955 = ProfileTab; profileTabFiles#ab339c00 = ProfileTab; profileTabMusic#9f27d26e = ProfileTab; profileTabVoice#e477092e = ProfileTab; profileTabLinks#d3656499 = ProfileTab; profileTabGifs#a2c0f695 = ProfileTab; users.savedMusicNotModified#e3878aa4 count:int = users.SavedMusic; users.savedMusic#34a2f297 count:int documents:Vector<Document> = users.SavedMusic; account.savedMusicIdsNotModified#4fc81d6e = account.SavedMusicIds; account.savedMusicIds#998d6636 ids:Vector<long> = account.SavedMusicIds; payments.checkCanSendGiftResultOk#374fa7ad = payments.CheckCanSendGiftResult; payments.checkCanSendGiftResultFail#d5e58274 reason:TextWithEntities = payments.CheckCanSendGiftResult; ---functions--- account.setMainProfileTab#5dee78b0 tab:ProfileTab = Bool; account.saveMusic#b26732a9 flags:# unsave:flags.0?true id:InputDocument after_id:flags.1?InputDocument = Bool; account.getSavedMusicIds#e09d5faf hash:long = account.SavedMusicIds; users.getSavedMusic#788d7fe3 id:InputUser offset:int limit:int hash:long = users.SavedMusic; users.getSavedMusicByID#7573a4e9 id:InputUser documents:Vector<InputDocument> = users.SavedMusic; channels.setMainProfileTab#3583fcb1 channel:InputChannel tab:ProfileTab = Bool; payments.checkCanSendGift#c0c4edc9 gift_id:long = payments.CheckCanSendGiftResult;
第212层
本层引入了以下功能:
- 另行预付礼品升级费用 »。
- 了解收藏礼品的价值 »
架构变更
新方法
- 已添加payments.getUniqueStarGiftValueInfo- 获取有关收藏礼品价值的信息»。
改变方法
- 在payments.getSavedStarGifts中新增了exclude_upgradable和exclude_unupgradable参数,移除了exclude_limited参数。
新建筑商
- 添加输入发票StarGiftPrepaidUpgrade-单独预付礼品升级费用 »。
- 新增payments.uniqueStarGiftValueInfo- 关于收藏礼品价值的信息»。
已更改的构造函数
- 在messageActionStarGift中添加了prepaid_upgrade、prepaid_upgrade_hash和gift_msg_id参数
- 在messageActionStarGiftUnique中添加prepaid_upgrade参数
- 在starsTransaction中添加了posts_search和stargift_prepaid_upgrade参数。
- 在starGiftUnique中添加了gift_id、value_amount和value_currency参数
- 在savedStarGift中添加prepaid_upgrade_hash参数
模式
messageActionStarGift#f24de7fa flags:# name_hidden:flags.0?true saved:flags.2?true converted:flags.3?true upgraded:flags.5?true refunded:flags.9?true can_upgrade:flags.10?true prepaid_upgrade:flags.13?true gift:StarGift message:flags.1?TextWithEntities convert_stars:flags.4?long upgrade_msg_id:flags.5?int upgrade_stars:flags.8?long from_id:flags.11?Peer peer:flags.12?Peer saved_id:flags.12?long prepaid_upgrade_hash:flags.14?string gift_msg_id:flags.15?int = MessageAction; messageActionStarGiftUnique#34f762f3 flags:# upgrade:flags.0?true transferred:flags.1?true saved:flags.2?true refunded:flags.5?true prepaid_upgrade:flags.11?true gift:StarGift can_export_at:flags.3?int transfer_stars:flags.4?long from_id:flags.6?Peer peer:flags.7?Peer saved_id:flags.7?long resale_amount:flags.8?StarsAmount can_transfer_at:flags.9?int can_resell_at:flags.10?int = MessageAction; inputInvoiceStarGiftPrepaidUpgrade#9a0b48b8 peer:InputPeer hash:string = InputInvoice; starsTransaction#13659eb0 flags:# refund:flags.3?true pending:flags.4?true failed:flags.6?true gift:flags.10?true reaction:flags.11?true stargift_upgrade:flags.18?true business_transfer:flags.21?true stargift_resale:flags.22?true posts_search:flags.24?true stargift_prepaid_upgrade:flags.25?true id:string amount:StarsAmount date:int peer:StarsTransactionPeer title:flags.0?string description:flags.1?string photo:flags.2?WebDocument transaction_date:flags.5?int transaction_url:flags.5?string bot_payload:flags.7?bytes msg_id:flags.8?int extended_media:flags.9?Vector<MessageMedia> subscription_period:flags.12?int giveaway_post_id:flags.13?int stargift:flags.14?StarGift floodskip_number:flags.15?int starref_commission_permille:flags.16?int starref_peer:flags.17?Peer starref_amount:flags.17?StarsAmount paid_messages:flags.19?int premium_gift_months:flags.20?int ads_proceeds_from_date:flags.23?int ads_proceeds_to_date:flags.23?int = StarsTransaction; starGiftUnique#26a5553e flags:# require_premium:flags.6?true resale_ton_only:flags.7?true id:long gift_id:long title:string slug:string num:int owner_id:flags.0?Peer owner_name:flags.1?string owner_address:flags.2?string attributes:Vector<StarGiftAttribute> availability_issued:int availability_total:int gift_address:flags.3?string resell_amount:flags.4?Vector<StarsAmount> released_by:flags.5?Peer value_amount:flags.8?long value_currency:flags.8?string = StarGift; savedStarGift#19a9b572 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 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 = SavedStarGift; payments.uniqueStarGiftValueInfo#512fe446 flags:# last_sale_on_fragment:flags.1?true value_is_average:flags.6?true currency:string value:long initial_sale_date:int initial_sale_stars:long initial_sale_price:long last_sale_date:flags.0?int last_sale_price:flags.0?long floor_price:flags.2?long average_price:flags.3?long listed_count:flags.4?int fragment_listed_count:flags.5?int fragment_listed_url:flags.5?string = payments.UniqueStarGiftValueInfo; ---functions--- payments.getSavedStarGifts#a319e569 flags:# exclude_unsaved:flags.0?true exclude_saved:flags.1?true exclude_unlimited:flags.2?true exclude_unique:flags.4?true sort_by_value:flags.5?true exclude_upgradable:flags.7?true exclude_unupgradable:flags.8?true peer:InputPeer collection_id:flags.6?int offset:string limit:int = payments.SavedStarGifts; payments.getUniqueStarGiftValueInfo#4365af6b slug:string = payments.UniqueStarGiftValueInfo;
第211层
本层引入了:
- 故事专辑 »
- 明星礼物收藏链接预览 »
- 全球频道全文帖子搜索 »
- 允许在TON中指定收藏礼品的转售价格»
- 待定星级评分 »
架构变更
新方法
- 添加了channels.checkSearchPostsFlood- 检查指定的全局帖子搜索 »是否需要付费。
- 添加了stories.createAlbum- 创建故事专辑。
- 新增stories.updateAlbum- 重命名故事专辑 »,或在其中添加、删除或重新排序故事。
- 添加了stories.reorderAlbums- 重新排列个人资料中的故事专辑 »。
- 添加了stories.deleteAlbum- 删除故事专辑。
- 新增stories.getAlbums- 获取同伴创建的故事专辑。
- 添加了stories.getAlbumStories- 获取故事专辑中的故事 »。
改变方法
- 在channels.searchPosts中添加了flags、query和allow_paid_stars参数,并将hashtag的类型从string更改为flags.0?string。
- 在payments.updateStarGiftPrice中添加了resell_amount参数,移除了resell_stars参数。
- 在stories.sendStory中添加albums参数
新建筑商
- 添加了webPageAttributeStarGiftCollection- 包含有关礼品系列的信息 »用于礼品系列的网页预览»(该网页将有一个type)telegram_collection。
- 添加了故事专辑- 表示一个故事专辑 »。
- 已添加stories.albumsNotModified-故事专辑列表 »没有改变。
- 添加了stories.albums-故事专辑 »。
- Added searchPostsFlood - Indicates if the specified global post search » requires payment.
Changed Constructors
- Addedresale_amountparameter, removedresale_starsparameter in messageActionStarGiftUnique
- Addedstars_my_pending_rating,stars_my_pending_rating_dateparameters in userFull
- Addedsearch_floodparameter in messages.messagesSlice
- Addedflags,tonparameters in inputInvoiceStarGiftResale
- Addedalbumsparameter in storyItem
- Addedresale_ton_only,resell_amountparameters, removedresell_starsparameter in starGiftUnique
Schema
messageActionStarGiftUnique#34f762f3 flags:# upgrade:flags.0?true transferred:flags.1?true saved:flags.2?true refunded:flags.5?true gift:StarGift can_export_at:flags.3?int transfer_stars:flags.4?long from_id:flags.6?Peer peer:flags.7?Peer saved_id:flags.7?long resale_amount:flags.8?StarsAmount can_transfer_at:flags.9?int can_resell_at:flags.10?int = MessageAction; userFull#7e63ce1f flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true voice_messages_forbidden:flags.20?true translations_disabled:flags.23?true stories_pinned_available:flags.26?true blocked_my_stories_from:flags.27?true wallpaper_overridden:flags.28?true contact_require_premium:flags.29?true read_dates_private:flags.30?true flags2:# sponsored_enabled:flags2.7?true can_view_revenue:flags2.9?true bot_can_manage_emoji_status:flags2.10?true display_gifts_button:flags2.16?true id:long about:flags.1?string settings:PeerSettings personal_photo:flags.21?Photo profile_photo:flags.2?Photo fallback_photo:flags.22?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int theme_emoticon:flags.15?string private_forward_name:flags.16?string bot_group_admin_rights:flags.17?ChatAdminRights bot_broadcast_admin_rights:flags.18?ChatAdminRights wallpaper:flags.24?WallPaper stories:flags.25?PeerStories business_work_hours:flags2.0?BusinessWorkHours business_location:flags2.1?BusinessLocation business_greeting_message:flags2.2?BusinessGreetingMessage business_away_message:flags2.3?BusinessAwayMessage business_intro:flags2.4?BusinessIntro birthday:flags2.5?Birthday personal_channel_id:flags2.6?long personal_channel_message:flags2.6?int stargifts_count:flags2.8?int starref_program:flags2.11?StarRefProgram bot_verification:flags2.12?BotVerification send_paid_messages_stars:flags2.14?long disallowed_gifts:flags2.15?DisallowedGiftsSettings stars_rating:flags2.17?StarsRating stars_my_pending_rating:flags2.18?StarsRating stars_my_pending_rating_date:flags2.18?int = UserFull; messages.messagesSlice#762b263d flags:# inexact:flags.1?true count:int next_rate:flags.0?int offset_id_offset:flags.2?int search_flood:flags.3?SearchPostsFlood messages:Vector<Message> chats:Vector<Chat> users:Vector<User> = messages.Messages; webPageAttributeStarGiftCollection#31cad303 icons:Vector<Document> = WebPageAttribute; inputInvoiceStarGiftResale#c39f5324 flags:# ton:flags.0?true slug:string to_id:InputPeer = InputInvoice; storyItem#edf164f1 flags:# pinned:flags.5?true public:flags.7?true close_friends:flags.8?true min:flags.9?true noforwards:flags.10?true edited:flags.11?true contacts:flags.12?true selected_contacts:flags.13?true out:flags.16?true id:int date:int from_id:flags.18?Peer fwd_from:flags.17?StoryFwdHeader expire_date:int caption:flags.0?string entities:flags.1?Vector<MessageEntity> media:MessageMedia media_areas:flags.14?Vector<MediaArea> privacy:flags.2?Vector<PrivacyRule> views:flags.3?StoryViews sent_reaction:flags.15?Reaction albums:flags.19?Vector<int> = StoryItem; starGiftUnique#3a274d50 flags:# require_premium:flags.6?true resale_ton_only:flags.7?true id:long title:string slug:string num:int owner_id:flags.0?Peer owner_name:flags.1?string owner_address:flags.2?string attributes:Vector<StarGiftAttribute> availability_issued:int availability_total:int gift_address:flags.3?string resell_amount:flags.4?Vector<StarsAmount> released_by:flags.5?Peer = StarGift; storyAlbum#9325705a flags:# album_id:int title:string icon_photo:flags.0?Photo icon_video:flags.1?Document = StoryAlbum; stories.albumsNotModified#564edaeb = stories.Albums; stories.albums#c3987a3a hash:long albums:Vector<StoryAlbum> = stories.Albums; searchPostsFlood#3e0b5b6a flags:# query_is_free:flags.0?true total_daily:int remains:int wait_till:flags.1?int stars_amount:long = SearchPostsFlood; ---functions--- channels.searchPosts#f2c4f24d flags:# hashtag:flags.0?string query:flags.1?string offset_rate:int offset_peer:InputPeer offset_id:int limit:int allow_paid_stars:flags.2?long = messages.Messages; channels.checkSearchPostsFlood#22567115 flags:# query:flags.0?string = SearchPostsFlood; payments.updateStarGiftPrice#edbe6ccb stargift:InputSavedStarGift resell_amount:StarsAmount = Updates; stories.sendStory#737fc2ec flags:# pinned:flags.2?true noforwards:flags.4?true fwd_modified:flags.7?true peer:InputPeer media:InputMedia media_areas:flags.5?Vector<MediaArea> caption:flags.0?string entities:flags.1?Vector<MessageEntity> privacy_rules:Vector<InputPrivacyRule> random_id:long period:flags.3?int fwd_from_id:flags.6?InputPeer fwd_from_story:flags.6?int albums:flags.8?Vector<int> = Updates; stories.createAlbum#a36396e5 peer:InputPeer title:string stories:Vector<int> = StoryAlbum; stories.updateAlbum#5e5259b6 flags:# peer:InputPeer album_id:int title:flags.0?string delete_stories:flags.1?Vector<int> add_stories:flags.2?Vector<int> order:flags.3?Vector<int> = StoryAlbum; stories.reorderAlbums#8535fbd9 peer:InputPeer order:Vector<int> = Bool; stories.deleteAlbum#8d3456d0 peer:InputPeer album_id:int = Bool; stories.getAlbums#25b3eac7 peer:InputPeer hash:long = stories.Albums; stories.getAlbumStories#ac806d61 peer:InputPeer album_id:int offset:int limit:int = stories.Stories;
Layer 210
This layer introduces:
- Star gift collections »
- Premium-only gifts (require_premium) and per-user gift limits for certain gift types (per_user_total,per_user_remains).
- Star ratings »
Schema changes
New Methods
- Added payments.createStarGiftCollection - Create a star gift collection ».
- Added payments.updateStarGiftCollection - Add or remove gifts from a star gift collection », or rename the collection.
- Added payments.reorderStarGiftCollections - Reorder the star gift collections » on an owned peer's profile.
- Added payments.deleteStarGiftCollection - Delete a star gift collection ».
- Added payments.getStarGiftCollections - Fetches all star gift collections » of a peer.
Changed Methods
- Addedcollection_idparameter in payments.getSavedStarGifts
New Constructors
- Added starsRating - Represents the profile's star rating, see here » for more info.
- Added starGiftCollection - Represents a star gift collection ».
- Added payments.starGiftCollectionsNotModified - The list of star gift collections » hasn't changed.
- Added payments.starGiftCollections - Represents a list of star gift collections ».
Changed Constructors
- Addedstars_ratingparameter in userFull
- Addedrequire_premium,limited_per_user,per_user_total,per_user_remainsparameters in starGift
- Addedrequire_premiumparameter in starGiftUnique
- Addedcollection_idparameter in savedStarGift
Schema
userFull#29de80be flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true voice_messages_forbidden:flags.20?true translations_disabled:flags.23?true stories_pinned_available:flags.26?true blocked_my_stories_from:flags.27?true wallpaper_overridden:flags.28?true contact_require_premium:flags.29?true read_dates_private:flags.30?true flags2:# sponsored_enabled:flags2.7?true can_view_revenue:flags2.9?true bot_can_manage_emoji_status:flags2.10?true display_gifts_button:flags2.16?true id:long about:flags.1?string settings:PeerSettings personal_photo:flags.21?Photo profile_photo:flags.2?Photo fallback_photo:flags.22?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int theme_emoticon:flags.15?string private_forward_name:flags.16?string bot_group_admin_rights:flags.17?ChatAdminRights bot_broadcast_admin_rights:flags.18?ChatAdminRights wallpaper:flags.24?WallPaper stories:flags.25?PeerStories business_work_hours:flags2.0?BusinessWorkHours business_location:flags2.1?BusinessLocation business_greeting_message:flags2.2?BusinessGreetingMessage business_away_message:flags2.3?BusinessAwayMessage business_intro:flags2.4?BusinessIntro birthday:flags2.5?Birthday personal_channel_id:flags2.6?long personal_channel_message:flags2.6?int stargifts_count:flags2.8?int starref_program:flags2.11?StarRefProgram bot_verification:flags2.12?BotVerification send_paid_messages_stars:flags2.14?long disallowed_gifts:flags2.15?DisallowedGiftsSettings stars_rating:flags2.17?StarsRating = UserFull; starGift#00bcff5b flags:# limited:flags.0?true sold_out:flags.1?true birthday:flags.2?true require_premium:flags.7?true limited_per_user:flags.8?true id:long sticker:Document stars:long availability_remains:flags.0?int availability_total:flags.0?int availability_resale:flags.4?long convert_stars:long first_sale_date:flags.1?int last_sale_date:flags.1?int upgrade_stars:flags.3?long resell_min_stars:flags.4?long title:flags.5?string released_by:flags.6?Peer per_user_total:flags.8?int per_user_remains:flags.8?int = StarGift; starGiftUnique#f63778ae flags:# require_premium:flags.6?true id:long title:string slug:string num:int owner_id:flags.0?Peer owner_name:flags.1?string owner_address:flags.2?string attributes:Vector<StarGiftAttribute> availability_issued:int availability_total:int gift_address:flags.3?string resell_stars:flags.4?long released_by:flags.5?Peer = StarGift; savedStarGift#1ea646df 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 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> = SavedStarGift; starsRating#1b0e4f07 flags:# level:int current_level_stars:long stars:long next_level_stars:flags.0?long = StarsRating; starGiftCollection#9d6b13b0 flags:# collection_id:int title:string icon:flags.0?Document gifts_count:int hash:long = StarGiftCollection; payments.starGiftCollectionsNotModified#a0ba4f17 = payments.StarGiftCollections; payments.starGiftCollections#8a2932f3 collections:Vector<StarGiftCollection> = payments.StarGiftCollections; ---functions--- payments.getSavedStarGifts#a319e569 flags:# exclude_unsaved:flags.0?true exclude_saved:flags.1?true exclude_unlimited:flags.2?true exclude_limited:flags.3?true exclude_unique:flags.4?true sort_by_value:flags.5?true peer:InputPeer collection_id:flags.6?int offset:string limit:int = payments.SavedStarGifts; payments.createStarGiftCollection#1f4a0e87 peer:InputPeer title:string stargift:Vector<InputSavedStarGift> = StarGiftCollection; payments.updateStarGiftCollection#4fddbee7 flags:# peer:InputPeer collection_id:int title:flags.0?string delete_stargift:flags.1?Vector<InputSavedStarGift> add_stargift:flags.2?Vector<InputSavedStarGift> order:flags.3?Vector<InputSavedStarGift> = StarGiftCollection; payments.reorderStarGiftCollections#c32af4cc peer:InputPeer order:Vector<int> = Bool; payments.deleteStarGiftCollection#ad5648e8 peer:InputPeer collection_id:int = Bool; payments.getStarGiftCollections#981b91dd peer:InputPeer hash:long = payments.StarGiftCollections;
Layer 208
This layer introduces:
- Suggested channel posts »
- Add a newmanage_direct_messagesadmin right
- Add support for the newmanage_direct_messagesadmin right in group/channel bot links
- Allow replying to specific todo tasks »
-
Unify channel revenue statistics and withdrawal methods with the equivalent ones used for stars, by simply adding atonflag and the missing parameters:
- Balance and transaction history »
- Revenue statistics »
- Withdrawing revenue »
- In some places in the API, it's possible to use toncoins instead of Stars, see here » for more info.
Schema changes
New Methods
- Added messages.toggleSuggestedPostApproval - Approve or reject a suggested post ».
Changed Methods
- Addedsuggested_postparameter in messages.sendMessage
- Addedsuggested_postparameter in messages.sendMedia
- Addedsuggested_postparameter in messages.forwardMessages
- Addedsuggested_postparameter in messages.saveDraft
- Addedflags,tonparameters in payments.getStarsStatus
- Addedtonparameter in payments.getStarsTransactions
- Addedtonparameter in payments.getStarsRevenueStats
- Addedflags,ton,amountparameters, removedstarsparameter in payments.getStarsRevenueWithdrawalUrl
- Addedflags,tonparameters in payments.getStarsTransactionsByID
Deleted Methods
- Removed stats.getBroadcastRevenueStats
- Removed stats.getBroadcastRevenueWithdrawalUrl
- Removed stats.getBroadcastRevenueTransactions
New Constructors
- Added suggestedPost - Contains info about a suggested post ».
- Added messageActionSuggestedPostApproval - A suggested post » was approved or rejected.
- Added messageActionSuggestedPostSuccess - A suggested post » was successfully posted, and payment for it was successfully received.
- Added messageActionSuggestedPostRefund - A suggested post » was accepted and posted or scheduled, but either the channel deleted the posted/scheduled post before stars_suggested_post_age_min seconds have elapsed, or the user refunded the payment for the stars used to pay for the suggested post.
- 添加starsTonAmount- 以纳吨为单位描述吨币的数量(即1/1_000_000_000吨币的纳吨数)。
- 添加了消息操作GiftTon- 您获得了一些toncoins。
- 添加了输入 StickerSetTonGifts- TON 礼物贴纸集。
已更改的构造函数
- 在消息中添加了paid_suggested_post_stars、paid_suggested_post_ton和suggest_post参数
- 在draftMessage中添加了suggest_post参数。
- 在chatAdminRights中添加了manage_direct_messages参数
- 在messageReplyHeader中添加todo_item_id参数
- 在inputReplyToMessage中添加了todo_item_id参数。
- 添加了amount、ads_proceeds_from_date和ads_proceeds_to_date参数,移除了starsTransaction中的stars参数。
- 在payments.starsRevenueStats中添加了标志和top_hours_graph参数
- starGift中添加了released_by参数
- 在payments.starGifts中添加了聊天和用户参数
- starGiftUnique中添加了released_by参数
已删除的构造函数
- 已移除 stats.broadcastRevenueStats
- 已移除 stats.broadcastRevenueWithdrawalUrl
- 已移除 broadcastRevenueTransactionProceeds
- 已移除 broadcastRevenueTransactionWithdrawal
- 已移除 broadcastRevenueTransactionRefund
- 已移除 stats.broadcastRevenueTransactions
- 已移除 broadcastRevenueBalances
- 已移除 updateBroadcastRevenueTransactions
模式
message#9815cec8 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true post:flags.14?true from_scheduled:flags.18?true legacy:flags.19?true edit_hide:flags.21?true pinned:flags.24?true noforwards:flags.26?true invert_media:flags.27?true flags2:# offline:flags2.1?true video_processing_pending:flags2.4?true paid_suggested_post_stars:flags2.8?true paid_suggested_post_ton:flags2.9?true id:int from_id:flags.8?Peer from_boosts_applied:flags.29?int peer_id:Peer saved_peer_id:flags.28?Peer fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long via_business_bot_id:flags2.0?long reply_to:flags.3?MessageReplyHeader date:int message:string media:flags.9?MessageMedia reply_markup:flags.6?ReplyMarkup entities:flags.7?Vector<MessageEntity> views:flags.10?int forwards:flags.10?int replies:flags.23?MessageReplies edit_date:flags.15?int post_author:flags.16?string grouped_id:flags.17?long reactions:flags.20?MessageReactions restriction_reason:flags.22?Vector<RestrictionReason> ttl_period:flags.25?int quick_reply_shortcut_id:flags.30?int effect:flags2.2?long factcheck:flags2.3?FactCheck report_delivery_until_date:flags2.5?int paid_message_stars:flags2.6?long suggested_post:flags2.7?SuggestedPost = Message; draftMessage#96eaa5eb flags:# no_webpage:flags.1?true invert_media:flags.6?true reply_to:flags.4?InputReplyTo message:string entities:flags.3?Vector<MessageEntity> media:flags.5?InputMedia date:int effect:flags.7?long suggested_post:flags.8?SuggestedPost = DraftMessage; chatAdminRights#5fb224d5 flags:# change_info:flags.0?true post_messages:flags.1?true edit_messages:flags.2?true delete_messages:flags.3?true ban_users:flags.4?true invite_users:flags.5?true pin_messages:flags.7?true add_admins:flags.9?true anonymous:flags.10?true manage_call:flags.11?true other:flags.12?true manage_topics:flags.13?true post_stories:flags.14?true edit_stories:flags.15?true delete_stories:flags.16?true manage_direct_messages:flags.17?true = ChatAdminRights; messageReplyHeader#6917560b flags:# reply_to_scheduled:flags.2?true forum_topic:flags.3?true quote:flags.9?true reply_to_msg_id:flags.4?int reply_to_peer_id:flags.0?Peer reply_from:flags.5?MessageFwdHeader reply_media:flags.8?MessageMedia reply_to_top_id:flags.1?int quote_text:flags.6?string quote_entities:flags.7?Vector<MessageEntity> quote_offset:flags.10?int todo_item_id:flags.11?int = MessageReplyHeader; inputReplyToMessage#869fbe10 flags:# reply_to_msg_id:int top_msg_id:flags.0?int reply_to_peer_id:flags.1?InputPeer quote_text:flags.2?string quote_entities:flags.3?Vector<MessageEntity> quote_offset:flags.4?int monoforum_peer_id:flags.5?InputPeer todo_item_id:flags.6?int = InputReplyTo; starsTransaction#13659eb0 flags:# refund:flags.3?true pending:flags.4?true failed:flags.6?true gift:flags.10?true reaction:flags.11?true stargift_upgrade:flags.18?true business_transfer:flags.21?true stargift_resale:flags.22?true id:string amount:StarsAmount date:int peer:StarsTransactionPeer title:flags.0?string description:flags.1?string photo:flags.2?WebDocument transaction_date:flags.5?int transaction_url:flags.5?string bot_payload:flags.7?bytes msg_id:flags.8?int extended_media:flags.9?Vector<MessageMedia> subscription_period:flags.12?int giveaway_post_id:flags.13?int stargift:flags.14?StarGift floodskip_number:flags.15?int starref_commission_permille:flags.16?int starref_peer:flags.17?Peer starref_amount:flags.17?StarsAmount paid_messages:flags.19?int premium_gift_months:flags.20?int ads_proceeds_from_date:flags.23?int ads_proceeds_to_date:flags.23?int = StarsTransaction; payments.starsRevenueStats#6c207376 flags:# top_hours_graph:flags.0?StatsGraph revenue_graph:StatsGraph status:StarsRevenueStatus usd_rate:double = payments.StarsRevenueStats; starGift#7f853c12 flags:# limited:flags.0?true sold_out:flags.1?true birthday:flags.2?true id:long sticker:Document stars:long availability_remains:flags.0?int availability_total:flags.0?int availability_resale:flags.4?long convert_stars:long first_sale_date:flags.1?int last_sale_date:flags.1?int upgrade_stars:flags.3?long resell_min_stars:flags.4?long title:flags.5?string released_by:flags.6?Peer = StarGift; payments.starGifts#2ed82995 hash:int gifts:Vector<StarGift> chats:Vector<Chat> users:Vector<User> = payments.StarGifts; starGiftUnique#f63778ae flags:# id:long title:string slug:string num:int owner_id:flags.0?Peer owner_name:flags.1?string owner_address:flags.2?string attributes:Vector<StarGiftAttribute> availability_issued:int availability_total:int gift_address:flags.3?string resell_stars:flags.4?long released_by:flags.5?Peer = StarGift; suggestedPost#0e8e37e5 flags:# accepted:flags.1?true rejected:flags.2?true price:flags.3?StarsAmount schedule_date:flags.0?int = SuggestedPost; messageActionSuggestedPostApproval#ee7a1596 flags:# rejected:flags.0?true balance_too_low:flags.1?true reject_comment:flags.2?string schedule_date:flags.3?int price:flags.4?StarsAmount = MessageAction; messageActionSuggestedPostSuccess#95ddcf69 price:StarsAmount = MessageAction; messageActionSuggestedPostRefund#69f916f8 flags:# payer_initiated:flags.0?true = MessageAction; starsTonAmount#74aee3e0 amount:long = StarsAmount; messageActionGiftTon#a8a3c699 flags:# currency:string amount:long crypto_currency:string crypto_amount:long transaction_id:flags.0?string = MessageAction; inputStickerSetTonGifts#1cf671a0 = InputStickerSet; ---functions--- messages.sendMessage#fe05dc9a flags:# no_webpage:flags.1?true silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true invert_media:flags.16?true allow_paid_floodskip:flags.19?true peer:InputPeer reply_to:flags.0?InputReplyTo message:string random_id:long reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut effect:flags.18?long allow_paid_stars:flags.21?long suggested_post:flags.22?SuggestedPost = Updates; messages.sendMedia#ac55d9c1 flags:# silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true invert_media:flags.16?true allow_paid_floodskip:flags.19?true peer:InputPeer reply_to:flags.0?InputReplyTo media:InputMedia message:string random_id:long reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut effect:flags.18?long allow_paid_stars:flags.21?long suggested_post:flags.22?SuggestedPost = Updates; messages.forwardMessages#978928ca flags:# silent:flags.5?true background:flags.6?true with_my_score:flags.8?true drop_author:flags.11?true drop_media_captions:flags.12?true noforwards:flags.14?true allow_paid_floodskip:flags.19?true from_peer:InputPeer id:Vector<int> random_id:Vector<long> to_peer:InputPeer top_msg_id:flags.9?int reply_to:flags.22?InputReplyTo schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut video_timestamp:flags.20?int allow_paid_stars:flags.21?long suggested_post:flags.23?SuggestedPost = Updates; messages.saveDraft#54ae308e flags:# no_webpage:flags.1?true invert_media:flags.6?true reply_to:flags.4?InputReplyTo peer:InputPeer message:string entities:flags.3?Vector<MessageEntity> media:flags.5?InputMedia effect:flags.7?long suggested_post:flags.8?SuggestedPost = Bool; payments.getStarsStatus#4ea9b3bf flags:# ton:flags.0?true peer:InputPeer = payments.StarsStatus; payments.getStarsTransactions#69da4557 flags:# inbound:flags.0?true outbound:flags.1?true ascending:flags.2?true ton:flags.4?true subscription_id:flags.3?string peer:InputPeer offset:string limit:int = payments.StarsStatus; payments.getStarsRevenueStats#d91ffad6 flags:# dark:flags.0?true ton:flags.1?true peer:InputPeer = payments.StarsRevenueStats; payments.getStarsRevenueWithdrawalUrl#2433dc92 flags:# ton:flags.0?true peer:InputPeer amount:flags.1?long password:InputCheckPasswordSRP = payments.StarsRevenueWithdrawalUrl; payments.getStarsTransactionsByID#2dca16b8 flags:# ton:flags.0?true peer:InputPeer id:Vector<InputStarsTransaction> = payments.StarsStatus; messages.toggleSuggestedPostApproval#8107455c flags:# reject:flags.1?true peer:InputPeer msg_id:int schedule_date:flags.0?int reject_comment:flags.2?string = Updates;
第205层
本层引入了:
- 在频道视频中显示的赞助信息 »
- 待办事项清单 »
- 将 account.addNoPaidMessagesException 重命名为 account.toggleNoPaidMessagesException,并添加一个require_payment标志,用于退还所有通过付费消息转给我们的星币。
- 允许对 monoforum 主题调用account.toggleNoPaidMessagesException,并添加一个新的updateMonoForumNoPaidException来向其他管理员和当前 monoforum 管理员的其他已登录会话发出monoForumDialog更改的信号。nopaid_messages_exception
架构变更
新方法
- 添加了messages.toggleTodoCompleted - 将待办事项列表中的一个或多个项目标记为已完成或未完成。
- 添加了messages.appendTodoList- 将一个或多个项目添加到待办事项列表 »。
- 添加了account.toggleNoPaidMessagesException- 如果启用了付费消息,则允许用户向我们发送消息而无需付费。
改变方法
- 在messages.getSponsoredMessages中添加了flags和msg_id参数
- 在account.getPaidMessagesRevenue中添加了flags和parent_peer参数
已删除的方法
- 已移除帐户。addNoPaidMessagesException
新建筑商
- 添加了待办事项- 待办事项列表中的一项»。
- 添加了待办事项列表- 表示待办事项列表 »。
- 已添加待办事项完成- 已完成的待办事项 »项。
- 添加了inputMediaTodo- 创建待办事项列表 »。
- 添加了messageMediaToDo- 表示待办事项列表 »。
- 添加messageActionTodoCompletions- 待办事项列表中的项目被标记为已完成或未完成»。
- 添加消息操作TodoAppendTasks- 项目已添加到待办事项列表 »。
- 添加updateMonoForumNoPaidException- 管理员已(取消)豁免此monoforum 主题 »使用account.toggleNoPaidMessagesException发送消息的付款。
已更改的构造函数
- 在消息服务中添加了saved_peer_id参数
- 在channelFull中添加了send_paid_messages_stars参数
- 在赞助消息中添加了min_display_duration和max_display_duration参数。
- messages.sponsoredMessages中添加了start_delay和between_delay参数
- 在monoForumDialog中添加了nopaid_messages_exception参数
推送通知变更
新的推送通知
- 已添加CHANNEL_MESSAGE_TODO-{1} posted a checklist {2}
- 添加了CHANNEL_MESSAGE_TODO_APPEND-{1} added {2} tasks
- 已添加CHANNEL_MESSAGE_TODO_DONE-{1} toggled {2} tasks
- 已添加CHAT_MESSAGE_TODO-{1} sent a checklist {3} to the group {2}
- 添加了CHAT_MESSAGE_TODO_APPEND-{1} added {3} tasks in the group {2}
- 已添加CHAT_MESSAGE_TODO_DONE-{1} toggled {3} tasks in the group {2}
- 已添加CHAT_REACT_TODO-{1}: {3} to your checklist {4} in {2}
- 已添加MESSAGE_TODO-{1} sent you a checklist {2}
- 已添加PINNED_TODO-{1} pinned a checklist {2}
- 添加了REACT_TODO-{1}: {2} to your checklist {3}
模式
messageService#7a800e0a flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true reactions_are_possible:flags.9?true silent:flags.13?true post:flags.14?true legacy:flags.19?true id:int from_id:flags.8?Peer peer_id:Peer saved_peer_id:flags.28?Peer reply_to:flags.3?MessageReplyHeader date:int action:MessageAction reactions:flags.20?MessageReactions ttl_period:flags.25?int = Message; channelFull#e07429de flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true flags2:# can_delete_channel:flags2.0?true antispam:flags2.1?true participants_hidden:flags2.2?true translations_disabled:flags2.3?true stories_pinned_available:flags2.5?true view_forum_as_messages:flags2.6?true restricted_sponsored:flags2.11?true can_view_revenue:flags2.12?true paid_media_allowed:flags2.14?true can_view_stars_revenue:flags2.15?true paid_reactions_available:flags2.16?true stargifts_available:flags2.19?true paid_messages_available:flags2.20?true id:long about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:flags.23?ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?long migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?long location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int call:flags.21?InputGroupCall ttl_period:flags.24?int pending_suggestions:flags.25?Vector<string> groupcall_default_join_as:flags.26?Peer theme_emoticon:flags.27?string requests_pending:flags.28?int recent_requesters:flags.28?Vector<long> default_send_as:flags.29?Peer available_reactions:flags.30?ChatReactions reactions_limit:flags2.13?int stories:flags2.4?PeerStories wallpaper:flags2.7?WallPaper boosts_applied:flags2.8?int boosts_unrestrict:flags2.9?int emojiset:flags2.10?StickerSet bot_verification:flags2.17?BotVerification stargifts_count:flags2.18?int send_paid_messages_stars:flags2.21?long = ChatFull; sponsoredMessage#7dbf8673 flags:# recommended:flags.5?true can_report:flags.12?true random_id:bytes url:string title:string message:string entities:flags.1?Vector<MessageEntity> photo:flags.6?Photo media:flags.14?MessageMedia color:flags.13?PeerColor button_text:string sponsor_info:flags.7?string additional_info:flags.8?string min_display_duration:flags.15?int max_display_duration:flags.15?int = SponsoredMessage; messages.sponsoredMessages#ffda656d flags:# posts_between:flags.0?int start_delay:flags.1?int between_delay:flags.2?int messages:Vector<SponsoredMessage> chats:Vector<Chat> users:Vector<User> = messages.SponsoredMessages; monoForumDialog#64407ea7 flags:# unread_mark:flags.3?true nopaid_messages_exception:flags.4?true peer:Peer top_message:int read_inbox_max_id:int read_outbox_max_id:int unread_count:int unread_reactions_count:int draft:flags.1?DraftMessage = SavedDialog; todoItem#cba9a52f id:int title:TextWithEntities = TodoItem; todoList#49b92a26 flags:# others_can_append:flags.0?true others_can_complete:flags.1?true title:TextWithEntities list:Vector<TodoItem> = TodoList; todoCompletion#4cc120b7 id:int completed_by:long date:int = TodoCompletion; inputMediaTodo#9fc55fde todo:TodoList = InputMedia; messageMediaToDo#8a53b014 flags:# todo:TodoList completions:flags.0?Vector<TodoCompletion> = MessageMedia; messageActionTodoCompletions#cc7c5c89 completed:Vector<int> incompleted:Vector<int> = MessageAction; messageActionTodoAppendTasks#c7edbc83 list:Vector<TodoItem> = MessageAction; updateMonoForumNoPaidException#9f812b08 flags:# exception:flags.0?true channel_id:long saved_peer_id:Peer = Update; ---functions--- messages.getSponsoredMessages#3d6ce850 flags:# peer:InputPeer msg_id:flags.0?int = messages.SponsoredMessages; account.getPaidMessagesRevenue#19ba4a67 flags:# parent_peer:flags.0?InputPeer user_id:InputUser = account.PaidMessagesRevenue; messages.toggleTodoCompleted#d3e03124 peer:InputPeer msg_id:int completed:Vector<int> incompleted:Vector<int> = Updates; messages.appendTodoList#21a61057 peer:InputPeer msg_id:int list:Vector<TodoItem> = Updates; account.toggleNoPaidMessagesException#fe2eda76 flags:# refund_charged:flags.0?true require_payment:flags.2?true parent_peer:flags.1?InputPeer user_id:InputUser = Bool;
第204层
本层引入了:
- Monoforum »
- 机器人 API 单体论坛 ID »
- 标签式论坛界面 »
- 添加到通道的所有标志(如下所列)都是有效标志,这意味着即使设置了传入通道min的标志,它们也必须应用于本地存储的版本。min
架构变更
新方法
- 添加了messages.getSavedDialogsByID - 获取有关特定已保存消息对话框 »或monoforum 主题 »的信息。
- 添加了messages.readSavedHistory- 在 monoforum 主题中将消息标记为已读»。
- 新增channels.getMessageAuthor- 只能由monoforum 的非机器人管理员调用 »,获取其他 monoforum 管理员代表与 monoforum 关联的频道向 monoforum 发送的消息的原始发送者。
改变方法
- messages.forwardMessages中添加了reply_to参数。
- messages.markDialogUnread中添加了parent_peer参数
- 在messages.getDialogUnreadMarks中添加了flags和parent_peer参数
- messages.unpinAllMessages中添加了saved_peer_id参数。
- messages.getUnreadReactions中添加了saved_peer_id参数
- messages.readReactions中添加了saved_peer_id参数。
- 在channels.toggleForum中添加了tabs参数
- messages.getSavedDialogs中添加了parent_peer参数
- 在messages.getSavedHistory中添加了flags和parent_peer参数
- messages.deleteSavedHistory中添加了parent_peer参数
- 在channels.updatePaidMessagesPrice中添加了flags和broadcast_messages_allowed参数。
新建筑商
- 添加了inputReplyToMonoForum- 用于向monoforum 主题发送消息。
- 添加了monoForumDialog- 表示一个monoforum 主题 »。
- 新增updateReadMonumInbox-已读单论坛主题中的新消息
- 添加了updateReadMonoForumOutbox-已读取单体论坛中的外发消息。
已更改的构造函数
- 在频道中添加了broadcast_messages_allowed、monoforum、forum_tabs和linked_monoforum_id参数。
- 在updateDraftMessage中添加了saved_peer_id参数。
- 在updateChannelReadMessagesContents中添加saved_peer_id参数
- 在updateDialogUnreadMark中添加saved_peer_id参数
- 在updateMessageReactions中添加saved_peer_id参数
- 在inputReplyToMessage中添加monoforum_peer_id参数
- 在messageActionPaidMessagesPrice中添加了flags和broadcast_messages_allowed参数
模式
channel#fe685355 flags:# creator:flags.0?true left:flags.2?true broadcast:flags.5?true verified:flags.7?true megagroup:flags.8?true restricted:flags.9?true signatures:flags.11?true min:flags.12?true scam:flags.19?true has_link:flags.20?true has_geo:flags.21?true slowmode_enabled:flags.22?true call_active:flags.23?true call_not_empty:flags.24?true fake:flags.25?true gigagroup:flags.26?true noforwards:flags.27?true join_to_send:flags.28?true join_request:flags.29?true forum:flags.30?true flags2:# stories_hidden:flags2.1?true stories_hidden_min:flags2.2?true stories_unavailable:flags2.3?true signature_profiles:flags2.12?true autotranslation:flags2.15?true broadcast_messages_allowed:flags2.16?true monoforum:flags2.17?true forum_tabs:flags2.19?true id:long access_hash:flags.13?long title:string username:flags.6?string photo:ChatPhoto date:int restriction_reason:flags.9?Vector<RestrictionReason> admin_rights:flags.14?ChatAdminRights banned_rights:flags.15?ChatBannedRights default_banned_rights:flags.18?ChatBannedRights participants_count:flags.17?int usernames:flags2.0?Vector<Username> stories_max_id:flags2.4?int color:flags2.7?PeerColor profile_color:flags2.8?PeerColor emoji_status:flags2.9?EmojiStatus level:flags2.10?int subscription_until_date:flags2.11?int bot_verification_icon:flags2.13?long send_paid_messages_stars:flags2.14?long linked_monoforum_id:flags2.18?long = Chat; updateDraftMessage#edfc111e flags:# peer:Peer top_msg_id:flags.0?int saved_peer_id:flags.1?Peer draft:DraftMessage = Update; updateChannelReadMessagesContents#25f324f7 flags:# channel_id:long top_msg_id:flags.0?int saved_peer_id:flags.1?Peer messages:Vector<int> = Update; updateDialogUnreadMark#b658f23e flags:# unread:flags.0?true peer:DialogPeer saved_peer_id:flags.1?Peer = Update; updateMessageReactions#1e297bfa flags:# peer:Peer msg_id:int top_msg_id:flags.0?int saved_peer_id:flags.1?Peer reactions:MessageReactions = Update; inputReplyToMessage#b07038b0 flags:# reply_to_msg_id:int top_msg_id:flags.0?int reply_to_peer_id:flags.1?InputPeer quote_text:flags.2?string quote_entities:flags.3?Vector<MessageEntity> quote_offset:flags.4?int monoforum_peer_id:flags.5?InputPeer = InputReplyTo; messageActionPaidMessagesPrice#84b88578 flags:# broadcast_messages_allowed:flags.0?true stars:long = MessageAction; inputReplyToMonoForum#69d66c45 monoforum_peer_id:InputPeer = InputReplyTo; monoForumDialog#64407ea7 flags:# unread_mark:flags.3?true peer:Peer top_message:int read_inbox_max_id:int read_outbox_max_id:int unread_count:int unread_reactions_count:int draft:flags.1?DraftMessage = SavedDialog; updateReadMonoForumInbox#77b0e372 channel_id:long saved_peer_id:Peer read_max_id:int = Update; updateReadMonoForumOutbox#a4a79376 channel_id:long saved_peer_id:Peer read_max_id:int = Update; ---functions--- messages.forwardMessages#38f0188c flags:# silent:flags.5?true background:flags.6?true with_my_score:flags.8?true drop_author:flags.11?true drop_media_captions:flags.12?true noforwards:flags.14?true allow_paid_floodskip:flags.19?true from_peer:InputPeer id:Vector<int> random_id:Vector<long> to_peer:InputPeer top_msg_id:flags.9?int reply_to:flags.22?InputReplyTo schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut video_timestamp:flags.20?int allow_paid_stars:flags.21?long = Updates; messages.markDialogUnread#8c5006f8 flags:# unread:flags.0?true parent_peer:flags.1?InputPeer peer:InputDialogPeer = Bool; messages.getDialogUnreadMarks#21202222 flags:# parent_peer:flags.0?InputPeer = Vector<DialogPeer>; messages.unpinAllMessages#062dd747 flags:# peer:InputPeer top_msg_id:flags.0?int saved_peer_id:flags.1?InputPeer = messages.AffectedHistory; messages.getUnreadReactions#bd7f90ac flags:# peer:InputPeer top_msg_id:flags.0?int saved_peer_id:flags.1?InputPeer offset_id:int add_offset:int limit:int max_id:int min_id:int = messages.Messages; messages.readReactions#9ec44f93 flags:# peer:InputPeer top_msg_id:flags.0?int saved_peer_id:flags.1?InputPeer = messages.AffectedHistory; channels.toggleForum#3ff75734 channel:InputChannel enabled:Bool tabs:Bool = Updates; messages.getSavedDialogs#1e91fc99 flags:# exclude_pinned:flags.0?true parent_peer:flags.1?InputPeer offset_date:int offset_id:int offset_peer:InputPeer limit:int hash:long = messages.SavedDialogs; messages.getSavedHistory#998ab009 flags:# parent_peer:flags.0?InputPeer peer:InputPeer offset_id:int offset_date:int add_offset:int limit:int max_id:int min_id:int hash:long = messages.Messages; messages.deleteSavedHistory#4dc5085f flags:# parent_peer:flags.0?InputPeer peer:InputPeer max_id:int min_date:flags.2?int max_date:flags.3?int = messages.AffectedHistory; channels.updatePaidMessagesPrice#4b12327b flags:# broadcast_messages_allowed:flags.0?true channel:InputChannel send_paid_messages_stars:long = Updates; messages.getSavedDialogsByID#6f6f9c96 flags:# parent_peer:flags.1?InputPeer ids:Vector<InputPeer> = messages.SavedDialogs; messages.readSavedHistory#ba4a3b5b parent_peer:InputPeer peer:InputPeer max_id:int = Bool; channels.getMessageAuthor#ece2a0e6 channel:InputChannel id:int = User;
第203层
本层引入了:
- 转售收藏礼品的方法 »
- 为频道所有用户启用自动翻译 »
- stories.canSendStory 现在返回可用活跃故事槽的数量 »
- 收藏礼品链接 »
- 自定义建议 »
- 所有建议字段已从客户端配置对象移至 help.getPromoData »
- 添加到通道的所有标志(如下所列)都是有效标志,这意味着即使设置了传入通道min的标志,它们也必须应用于本地存储的版本。min
架构变更
新方法
- 新增付款方式。getResaleStarGifts- 获取当前正在转售的特定类型的收藏礼品,点击此处»了解更多信息。
- 添加了payments.updateStarGiftPrice-我们拥有的收藏礼品 »可以通过此方法在礼品市场出售»详情请见此处 » 。
- 新增channels.toggleAutotranslation- 切换频道中所有用户的自动翻译:点击此处»了解更多信息。
改变方法
- 将stories.canSendStory的类型从Bool更改为stories.CanSendStoryCount
新建筑商
- 添加了inputSavedStarGiftSlug- 指向从收藏品链接获得的收藏品 »。
- 添加了starGiftAttributeIdModel- 收藏品礼物的模型 ID»。
- 添加了starGiftAttributeIdPattern- 收藏品图案的 ID»。
- 添加了starGiftAttributeIdBackdrop- 收藏品背景的 ID»。
- 新增starGiftAttributeCounter- 指示具有指定属性的礼物总数。
- 新增payments.resaleStarGifts- 当前正在转售的礼品列表»。
- 添加了inputInvoiceStarGiftResale- 用于购买目前正在转售的收藏礼品,请点击此处查看完整流程的更多信息。
- 添加了channelAdminLogEventActionToggleAutotranslation-频道自动翻译已切换 »。
- 添加了stories.canSendStoryCount- 包含可用活动故事槽的数量(等于story_expiring_limit_*客户端配置参数的值减去当前活动故事的数量)。
- 添加了pendingSuggestion- 表示自定义的待处理建议 »。
已更改的构造函数
- 频道中新增了自动翻译参数
- 添加了pending_suggestions、dismissed_suggestions和custom_pending_suggestions参数,并将help.promoData中的peer类型从Peer更改为flags.3?Peer。
- 在starGift中添加了availability_resale、resell_min_stars和title参数
- 在starGiftAttributeBackdrop中添加了backdrop_id参数
- 在starGiftUnique中添加resell_stars参数
- 在messageActionStarGiftUnique中添加了resale_stars、can_transfer_at和can_resell_at参数
- 在savedStarGift中添加了can_transfer_at和can_resell_at参数
模式
channel#7482147e flags:# creator:flags.0?true left:flags.2?true broadcast:flags.5?true verified:flags.7?true megagroup:flags.8?true restricted:flags.9?true signatures:flags.11?true min:flags.12?true scam:flags.19?true has_link:flags.20?true has_geo:flags.21?true slowmode_enabled:flags.22?true call_active:flags.23?true call_not_empty:flags.24?true fake:flags.25?true gigagroup:flags.26?true noforwards:flags.27?true join_to_send:flags.28?true join_request:flags.29?true forum:flags.30?true flags2:# stories_hidden:flags2.1?true stories_hidden_min:flags2.2?true stories_unavailable:flags2.3?true signature_profiles:flags2.12?true autotranslation:flags2.15?true id:long access_hash:flags.13?long title:string username:flags.6?string photo:ChatPhoto date:int restriction_reason:flags.9?Vector<RestrictionReason> admin_rights:flags.14?ChatAdminRights banned_rights:flags.15?ChatBannedRights default_banned_rights:flags.18?ChatBannedRights participants_count:flags.17?int usernames:flags2.0?Vector<Username> stories_max_id:flags2.4?int color:flags2.7?PeerColor profile_color:flags2.8?PeerColor emoji_status:flags2.9?EmojiStatus level:flags2.10?int subscription_until_date:flags2.11?int bot_verification_icon:flags2.13?long send_paid_messages_stars:flags2.14?long = Chat; help.promoData#08a4d87a flags:# proxy:flags.0?true expires:int peer:flags.3?Peer psa_type:flags.1?string psa_message:flags.2?string pending_suggestions:Vector<string> dismissed_suggestions:Vector<string> custom_pending_suggestion:flags.4?PendingSuggestion chats:Vector<Chat> users:Vector<User> = help.PromoData; starGift#c62aca28 flags:# limited:flags.0?true sold_out:flags.1?true birthday:flags.2?true id:long sticker:Document stars:long availability_remains:flags.0?int availability_total:flags.0?int availability_resale:flags.4?long convert_stars:long first_sale_date:flags.1?int last_sale_date:flags.1?int upgrade_stars:flags.3?long resell_min_stars:flags.4?long title:flags.5?string = StarGift; starGiftAttributeBackdrop#d93d859c name:string backdrop_id:int center_color:int edge_color:int pattern_color:int text_color:int rarity_permille:int = StarGiftAttribute; starGiftUnique#6411db89 flags:# id:long title:string slug:string num:int owner_id:flags.0?Peer owner_name:flags.1?string owner_address:flags.2?string attributes:Vector<StarGiftAttribute> availability_issued:int availability_total:int gift_address:flags.3?string resell_stars:flags.4?long = StarGift; messageActionStarGiftUnique#2e3ae60e flags:# upgrade:flags.0?true transferred:flags.1?true saved:flags.2?true refunded:flags.5?true gift:StarGift can_export_at:flags.3?int transfer_stars:flags.4?long from_id:flags.6?Peer peer:flags.7?Peer saved_id:flags.7?long resale_stars:flags.8?long can_transfer_at:flags.9?int can_resell_at:flags.10?int = MessageAction; savedStarGift#dfda0499 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 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 = SavedStarGift; inputSavedStarGiftSlug#2085c238 slug:string = InputSavedStarGift; starGiftAttributeIdModel#48aaae3c document_id:long = StarGiftAttributeId; starGiftAttributeIdPattern#4a162433 document_id:long = StarGiftAttributeId; starGiftAttributeIdBackdrop#1f01c757 backdrop_id:int = StarGiftAttributeId; starGiftAttributeCounter#2eb1b658 attribute:StarGiftAttributeId count:int = StarGiftAttributeCounter; payments.resaleStarGifts#947a12df flags:# count:int gifts:Vector<StarGift> next_offset:flags.0?string attributes:flags.1?Vector<StarGiftAttribute> attributes_hash:flags.1?long chats:Vector<Chat> counters:flags.2?Vector<StarGiftAttributeCounter> users:Vector<User> = payments.ResaleStarGifts; inputInvoiceStarGiftResale#63cbc38c slug:string to_id:InputPeer = InputInvoice; channelAdminLogEventActionToggleAutotranslation#c517f77e new_value:Bool = ChannelAdminLogEventAction; stories.canSendStoryCount#c387c04e count_remains:int = stories.CanSendStoryCount; pendingSuggestion#e7e82e12 suggestion:string title:TextWithEntities description:TextWithEntities url:string = PendingSuggestion; ---functions--- stories.canSendStory#30eb63f0 peer:InputPeer = stories.CanSendStoryCount; payments.getResaleStarGifts#7a5fa236 flags:# sort_by_price:flags.1?true sort_by_num:flags.2?true attributes_hash:flags.0?long gift_id:long attributes:flags.3?Vector<StarGiftAttributeId> offset:string limit:int = payments.ResaleStarGifts; payments.updateStarGiftPrice#3baea4e1 stargift:InputSavedStarGift resell_stars:long = Updates; channels.toggleAutotranslation#167fc0a1 channel:InputChannel enabled:Bool = Updates;
第202层
本层引入了:
-
端到端群组通话 »
- 会议深度链接 »
- 付费消息退款服务信息 »
- 付费消息价格变更服务消息 »
-
礼物隐私设置:
- globalPrivacySettings.disallowed_gifts/userFull.disallowed_gifts:禁止接收特定类型的礼物 »
- globalPrivacySettings.display_gifts_button/userFull.display_gifts_button: 在私聊的文本字段中显示或隐藏礼物按钮。
- 将星星从企业账户转移到企业机器人 »
- 赞助同行搜索结果 »
- 商业机器人权限 »
- 赞助消息投放方式现在不再需要指定peer赞助消息的可见位置 »
- 重命名了官方应用程序用于检查是否可以进行店内购买的方法 »
- 官方应用的付费授权码
架构变更
新方法
- 新增payments.canPurchaseStore- 检查是否可以进行购买。必须在店内购买前调用,仅限官方应用程序。
- 新增contacts.getSponsoredPeers- 获取给定查询的赞助同行搜索结果列表
- 添加了phone.deleteConferenceCallParticipants- 从电话会议中移除参与者。
- 新增phone.sendConferenceCallBroadcast- 向电话会议的所有成员广播区块链区块,详情请参见此处 » 。
- 添加了phone.inviteConferenceCallParticipant- 邀请用户参加电话会议。
- 添加了phone.declineConferenceCallInvite- 拒绝电话会议邀请。
- 添加了phone.getGroupCallChainBlocks- 获取会议区块链的区块»。
改变方法
- 移除了phone.requestCall中的conference_call参数
- 在phone.joinGroupCall中添加了public_key和block参数,移除了key_fingerprint参数。
- 在account.updateConnectedBot中添加了rights参数,移除了can_reply参数。
- 已移除messages.viewSponsoredMessage中的peer参数。
- 已移除messages.clickSponsoredMessage中的peer参数。
- 已移除messages.reportSponsoredMessage中的peer参数。
- 将phone.createConferenceCall的类型从phone.PhoneCall更改为Updates。
- 在phone.createConferenceCall中添加了flags、muted、video_stopped、join、random_id、public_key、block和params参数,并移除了peer和key_fingerprint参数。
已删除的方法
- 已移除付款。canPurchasePremium
新建筑商
- 添加了auth.sentCodePaymentRequired- 官方应用程序可能会收到此构造函数,表示由于用户所在国家/地区的短信验证码成本较高,用户必须购买Telegram Premium订阅才能继续登录/注册。
- 新增inputStorePaymentAuthCode- 表示登录码的付款。
- 新增updateSentPhoneCode- 已成功发送付费登录短信验证码。
- 添加了businessBotRights-企业机器人权限。
- 添加了messageActionPaidMessagesRefunded- 由 A 发送至 B,表示 A 已退还B 之前支付给 A 的所有用于向 A 发送消息的星星,请点击此处 »了解有关付费消息的更多信息。
- 添加消息操作付费消息价格 - 此聊天中付费消息的价格已更改。
- 新增disallowedGiftsSettings- 禁止接收特定类型的礼物。
- 新增受赞助的同伴- 一位受赞助的同伴。
- 已添加contacts.sponsoredPeersEmpty- 此查询没有赞助同行。
- 已添加联系人。受赞助的同行- 受赞助的同行。
- 添加了inputInvoiceBusinessBotTransferStars -将连接到企业机器人的用户帐户余额中的星星转移到企业机器人的余额,请参阅此处 »以了解有关完整流程的更多信息。
- 添加了inputGroupCallSlug- 通过邀请链接加入电话会议»。
- 添加了inputGroupCallInviteMessage - 通过messageActionConferenceCall邀请消息加入群组通话。
- 新增updateGroupCallChainBlocks- 包含对电话会议区块链的更新,请点击此处»了解更多信息。
- 添加了messageActionConferenceCall- 表示电话会议(或者表示电话会议邀请,如果未设置missednor标志)。active
- 添加phoneCallDiscardReasonMigrateConferenceCall- 此电话呼叫已迁移到电话会议。
已更改的构造函数
- 在userFull中添加了display_gifts_button和disallowed_gifts参数
- 移除了phoneCallWaiting中的conference_call参数
- 移除了phoneCallRequested中的conference_call参数
- 移除了phoneCallAccepted中的conference_call参数
- 在phoneCall中添加了conference_supported参数,移除了conference_call参数。
- 移除phoneCallDiscarded中的conference_call参数
- 在globalPrivacySettings中添加了display_gifts_button和disallowed_gifts参数。
- 在groupCall中添加了conference、creator和invite_link参数,移除了conference_from_call参数。
- 在connectedBot中添加了rights参数,移除了can_reply参数。
- 在botBusinessConnection中添加了rights参数,移除了can_reply参数。
推送通知变更
新的推送通知
- 添加了CONF_CALL_MISSED-You missed a call from {1}
模式
userFull#99e78045 flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true voice_messages_forbidden:flags.20?true translations_disabled:flags.23?true stories_pinned_available:flags.26?true blocked_my_stories_from:flags.27?true wallpaper_overridden:flags.28?true contact_require_premium:flags.29?true read_dates_private:flags.30?true flags2:# sponsored_enabled:flags2.7?true can_view_revenue:flags2.9?true bot_can_manage_emoji_status:flags2.10?true display_gifts_button:flags2.16?true id:long about:flags.1?string settings:PeerSettings personal_photo:flags.21?Photo profile_photo:flags.2?Photo fallback_photo:flags.22?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int theme_emoticon:flags.15?string private_forward_name:flags.16?string bot_group_admin_rights:flags.17?ChatAdminRights bot_broadcast_admin_rights:flags.18?ChatAdminRights wallpaper:flags.24?WallPaper stories:flags.25?PeerStories business_work_hours:flags2.0?BusinessWorkHours business_location:flags2.1?BusinessLocation business_greeting_message:flags2.2?BusinessGreetingMessage business_away_message:flags2.3?BusinessAwayMessage business_intro:flags2.4?BusinessIntro birthday:flags2.5?Birthday personal_channel_id:flags2.6?long personal_channel_message:flags2.6?int stargifts_count:flags2.8?int starref_program:flags2.11?StarRefProgram bot_verification:flags2.12?BotVerification send_paid_messages_stars:flags2.14?long disallowed_gifts:flags2.15?DisallowedGiftsSettings = UserFull; phoneCallWaiting#c5226f17 flags:# video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long protocol:PhoneCallProtocol receive_date:flags.0?int = PhoneCall; phoneCallRequested#14b0ed0c flags:# video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long g_a_hash:bytes protocol:PhoneCallProtocol = PhoneCall; phoneCallAccepted#3660c311 flags:# video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long g_b:bytes protocol:PhoneCallProtocol = PhoneCall; phoneCall#30535af5 flags:# p2p_allowed:flags.5?true video:flags.6?true conference_supported:flags.8?true id:long access_hash:long date:int admin_id:long participant_id:long g_a_or_b:bytes key_fingerprint:long protocol:PhoneCallProtocol connections:Vector<PhoneConnection> start_date:int custom_parameters:flags.7?DataJSON = PhoneCall; phoneCallDiscarded#50ca4de1 flags:# need_rating:flags.2?true need_debug:flags.3?true video:flags.6?true id:long reason:flags.0?PhoneCallDiscardReason duration:flags.1?int = PhoneCall; globalPrivacySettings#fe41b34f flags:# archive_and_mute_new_noncontact_peers:flags.0?true keep_archived_unmuted:flags.1?true keep_archived_folders:flags.2?true hide_read_marks:flags.3?true new_noncontact_peers_require_premium:flags.4?true display_gifts_button:flags.7?true noncontact_peers_paid_stars:flags.5?long disallowed_gifts:flags.6?DisallowedGiftsSettings = GlobalPrivacySettings; groupCall#553b0ba1 flags:# join_muted:flags.1?true can_change_join_muted:flags.2?true join_date_asc:flags.6?true schedule_start_subscribed:flags.8?true can_start_video:flags.9?true record_video_active:flags.11?true rtmp_stream:flags.12?true listeners_hidden:flags.13?true conference:flags.14?true creator:flags.15?true id:long access_hash:long participants_count:int title:flags.3?string stream_dc_id:flags.4?int record_start_date:flags.5?int schedule_date:flags.7?int unmuted_video_count:flags.10?int unmuted_video_limit:int version:int invite_link:flags.16?string = GroupCall; connectedBot#cd64636c flags:# bot_id:long recipients:BusinessBotRecipients rights:BusinessBotRights = ConnectedBot; botBusinessConnection#8f34b2f5 flags:# disabled:flags.1?true connection_id:string user_id:long dc_id:int date:int rights:flags.2?BusinessBotRights = BotBusinessConnection; auth.sentCodePaymentRequired#d7cef980 store_product:string phone_code_hash:string = auth.SentCode; inputStorePaymentAuthCode#9bb2636d flags:# restore:flags.0?true phone_number:string phone_code_hash:string currency:string amount:long = InputStorePaymentPurpose; updateSentPhoneCode#504aa18f sent_code:auth.SentCode = Update; businessBotRights#a0624cf7 flags:# reply:flags.0?true read_messages:flags.1?true delete_sent_messages:flags.2?true delete_received_messages:flags.3?true edit_name:flags.4?true edit_bio:flags.5?true edit_profile_photo:flags.6?true edit_username:flags.7?true view_gifts:flags.8?true sell_gifts:flags.9?true change_gift_settings:flags.10?true transfer_and_upgrade_gifts:flags.11?true transfer_stars:flags.12?true manage_stories:flags.13?true = BusinessBotRights; messageActionPaidMessagesRefunded#ac1f1fcd count:int stars:long = MessageAction; messageActionPaidMessagesPrice#bcd71419 stars:long = MessageAction; disallowedGiftsSettings#71f276c4 flags:# disallow_unlimited_stargifts:flags.0?true disallow_limited_stargifts:flags.1?true disallow_unique_stargifts:flags.2?true disallow_premium_gifts:flags.3?true = DisallowedGiftsSettings; sponsoredPeer#c69708d3 flags:# random_id:bytes peer:Peer sponsor_info:flags.0?string additional_info:flags.1?string = SponsoredPeer; contacts.sponsoredPeersEmpty#ea32b4b1 = contacts.SponsoredPeers; contacts.sponsoredPeers#eb032884 peers:Vector<SponsoredPeer> chats:Vector<Chat> users:Vector<User> = contacts.SponsoredPeers; inputInvoiceBusinessBotTransferStars#f4997e42 bot:InputUser stars:long = InputInvoice; inputGroupCallSlug#fe06823f slug:string = InputGroupCall; inputGroupCallInviteMessage#8c10603f msg_id:int = InputGroupCall; updateGroupCallChainBlocks#a477288f call:InputGroupCall sub_chain_id:int blocks:Vector<bytes> next_offset:int = Update; messageActionConferenceCall#2ffe2f7a flags:# missed:flags.0?true active:flags.1?true video:flags.4?true call_id:long duration:flags.2?int other_participants:flags.3?Vector<Peer> = MessageAction; phoneCallDiscardReasonMigrateConferenceCall#9fbbf1f7 slug:string = PhoneCallDiscardReason; ---functions--- phone.requestCall#42ff96ed flags:# video:flags.0?true user_id:InputUser random_id:int g_a_hash:bytes protocol:PhoneCallProtocol = phone.PhoneCall; phone.joinGroupCall#8fb53057 flags:# muted:flags.0?true video_stopped:flags.2?true call:InputGroupCall join_as:InputPeer invite_hash:flags.1?string public_key:flags.3?int256 block:flags.3?bytes params:DataJSON = Updates; account.updateConnectedBot#66a08c7e flags:# deleted:flags.1?true rights:flags.0?BusinessBotRights bot:InputUser recipients:InputBusinessBotRecipients = Updates; messages.viewSponsoredMessage#269e3643 random_id:bytes = Bool; messages.clickSponsoredMessage#8235057e flags:# media:flags.0?true fullscreen:flags.1?true random_id:bytes = Bool; messages.reportSponsoredMessage#12cbf0c4 random_id:bytes option:bytes = channels.SponsoredMessageReportResult; phone.createConferenceCall#7d0444bb flags:# muted:flags.0?true video_stopped:flags.2?true join:flags.3?true random_id:int public_key:flags.3?int256 block:flags.3?bytes params:flags.3?DataJSON = Updates; payments.canPurchaseStore#4fdc5ea7 purpose:InputStorePaymentPurpose = Bool; contacts.getSponsoredPeers#b6c8c393 q:string = contacts.SponsoredPeers; phone.deleteConferenceCallParticipants#8ca60525 flags:# only_left:flags.0?true kick:flags.1?true call:InputGroupCall ids:Vector<long> block:bytes = Updates; phone.sendConferenceCallBroadcast#c6701900 call:InputGroupCall block:bytes = Updates; phone.inviteConferenceCallParticipant#bcf22685 flags:# video:flags.0?true call:InputGroupCall user_id:InputUser = Updates; phone.declineConferenceCallInvite#3c479971 msg_id:int = Updates; phone.getGroupCallChainBlocks#ee9f88a6 call:InputGroupCall sub_chain_id:int offset:int limit:int = Updates;
第200层
本层引入了:
- 新私聊的详细账户信息 »
- 付费信息 »
- 将收到的特定礼物置顶到个人资料 »
- 将付费互动作为渠道发送 »
- 向 channelFull添加了一个paid_messages_available标志,用于指示是否可以在此超级组中启用付费消息。
-
使用 Telegram Stars 支付,赠送 Telegram Premium 订阅 »
此更改还简化了 Telegram Premium 赠送流程,完全用payments.getPremiumGiftCodeOptions替换了userFull.premium_gifts标志。 - 收藏品的区块链地址已作为 NFT 迁移到 TON 区块链 »
- 添加到通道的所有标志(如下所列)都是有效标志,这意味着即使设置了传入通道min的标志,它们也必须应用于本地存储的版本。min
- 添加到用户的所有标志(如下所列)都是有效标志,这意味着即使设置了传入用户min的标志,它们也必须应用于本地存储的版本。min
架构变更
新方法
- 新增invokeWithReCaptcha- 仅限官方客户端:通过 重新执行需要 reCAPTCHA 验证的方法调用RECAPTCHA_CHECK_%s__%s,其中第一个占位符是action,第二个占位符是 reCAPTCHA 密钥 ID。
- 添加帐户.addNoPaidMessagesException
- 添加了account.getPaidMessagesRevenue - 获取我们通过付费消息从指定用户收到的星星数量»;收到的金额将等于发送的金额乘以stars_paid_message_commission_permille再除以 1000。
- 添加频道。updatePaidMessagesPrice-在此超级群组或单论坛中启用或禁用付费消息。
- 添加了users.getRequirementsToContact- 检查我们是否可以向指定的用户写入消息,用于实现仅限高级用户的消息和付费消息的批量检查。
- 添加了payments.toggleStarGiftsPinnedToTop - 使用payments.toggleStarGiftsPinnedToTop将收到的礼物置顶在用户或拥有频道的个人资料顶部。
改变方法
- messages.sendMessage中添加了allow_paid_stars参数。
- messages.sendMedia中添加了allow_paid_stars参数
- messages.forwardMessages中添加了allow_paid_stars参数
- 在messages.sendInlineBotResult中添加了allow_paid_stars参数
- messages.sendMultiMedia中添加了allow_paid_stars参数
- 在channels.getSendAs中添加了flags和for_paid_reactions参数。
- 在messages.sendPaidReaction中,将private类型从flags.0?Bool更改为flags.0?PaidReactionPrivacy。
- messages.togglePaidReactionPrivacy中的private类型从Bool更改为PaidReactionPrivacy 。
已删除的方法
- 已移除用户。getIsPremiumRequiredToContact
新建筑商
- 添加了paidReactionPrivacyDefault- 使用默认的反应隐私设置,可通过messages.togglePaidReactionPrivacy设置。
- 新增paidReactionPrivacyAnonymous- 匿名发送付费表情。
- 添加paidReactionPrivacyPeer- 以指定对等方的身份发送付费反应,使用channels.getSendAs获取。
- 添加inputPrivacyKeyNoPaidMessages - 如果启用了付费消息功能,谁可以向您发送无需付费的消息。
- 添加了privacyKeyNoPaidMessages - 如果启用了付费消息功能,谁可以向您发送无需付费的消息。
- 新增account.paidMessagesRevenue-用户直接或通过频道向我们发送消息所花费的未退款Telegram 星星总数,点击此处 »了解更多关于付费消息的信息。
- 新增需求ToContactEmpty- 可以自由联系此用户。
- 新增要求ToContactPremium- 该用户要求我们购买高级订阅才能联系他们。
- 新增需求ToContactPaidMessages- 此用户要求我们支付指定数量的Telegram Stars才能向其发送消息,请点击此处»查看完整流程。
- 添加inputInvoicePremiumGiftStars- 用于向其他用户赠送Telegram Premium订阅,使用Telegram Stars支付。
已更改的构造函数
- 在消息中添加了paid_message_stars参数
- 在peerSettings中添加了charge_paid_message_stars、registration_month、phone_country、name_change_date、photo_change_date参数。
- 在userFull中添加了send_paid_messages_stars参数,移除了premium_gifts参数。
- 在用户中添加了send_paid_messages_stars参数
- 在频道中添加了send_paid_messages_stars参数
- 在channelFull中添加了paid_messages_available参数
- 在全局隐私设置中添加了noncontact_peers_paid_stars参数
- 在starsTransaction中添加了business_transfer、stargift_resale、paid_messages和premium_gift_months参数。
- 在updatePaidReactionPrivacy中将private类型从Bool更改为PaidReactionPrivacy 。
- starGiftUnique中添加了gift_address参数
已删除的构造函数
- 已移除高级礼品选项
模式
message#eabcdd4d flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true post:flags.14?true from_scheduled:flags.18?true legacy:flags.19?true edit_hide:flags.21?true pinned:flags.24?true noforwards:flags.26?true invert_media:flags.27?true flags2:# offline:flags2.1?true video_processing_pending:flags2.4?true id:int from_id:flags.8?Peer from_boosts_applied:flags.29?int peer_id:Peer saved_peer_id:flags.28?Peer fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long via_business_bot_id:flags2.0?long reply_to:flags.3?MessageReplyHeader date:int message:string media:flags.9?MessageMedia reply_markup:flags.6?ReplyMarkup entities:flags.7?Vector<MessageEntity> views:flags.10?int forwards:flags.10?int replies:flags.23?MessageReplies edit_date:flags.15?int post_author:flags.16?string grouped_id:flags.17?long reactions:flags.20?MessageReactions restriction_reason:flags.22?Vector<RestrictionReason> ttl_period:flags.25?int quick_reply_shortcut_id:flags.30?int effect:flags2.2?long factcheck:flags2.3?FactCheck report_delivery_until_date:flags2.5?int paid_message_stars:flags2.6?long = Message; peerSettings#f47741f7 flags:# report_spam:flags.0?true add_contact:flags.1?true block_contact:flags.2?true share_contact:flags.3?true need_contacts_exception:flags.4?true report_geo:flags.5?true autoarchived:flags.7?true invite_members:flags.8?true request_chat_broadcast:flags.10?true business_bot_paused:flags.11?true business_bot_can_reply:flags.12?true geo_distance:flags.6?int request_chat_title:flags.9?string request_chat_date:flags.9?int business_bot_id:flags.13?long business_bot_manage_url:flags.13?string charge_paid_message_stars:flags.14?long registration_month:flags.15?string phone_country:flags.16?string name_change_date:flags.17?int photo_change_date:flags.18?int = PeerSettings; userFull#d2234ea0 flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true voice_messages_forbidden:flags.20?true translations_disabled:flags.23?true stories_pinned_available:flags.26?true blocked_my_stories_from:flags.27?true wallpaper_overridden:flags.28?true contact_require_premium:flags.29?true read_dates_private:flags.30?true flags2:# sponsored_enabled:flags2.7?true can_view_revenue:flags2.9?true bot_can_manage_emoji_status:flags2.10?true id:long about:flags.1?string settings:PeerSettings personal_photo:flags.21?Photo profile_photo:flags.2?Photo fallback_photo:flags.22?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int theme_emoticon:flags.15?string private_forward_name:flags.16?string bot_group_admin_rights:flags.17?ChatAdminRights bot_broadcast_admin_rights:flags.18?ChatAdminRights wallpaper:flags.24?WallPaper stories:flags.25?PeerStories business_work_hours:flags2.0?BusinessWorkHours business_location:flags2.1?BusinessLocation business_greeting_message:flags2.2?BusinessGreetingMessage business_away_message:flags2.3?BusinessAwayMessage business_intro:flags2.4?BusinessIntro birthday:flags2.5?Birthday personal_channel_id:flags2.6?long personal_channel_message:flags2.6?int stargifts_count:flags2.8?int starref_program:flags2.11?StarRefProgram bot_verification:flags2.12?BotVerification send_paid_messages_stars:flags2.14?long = UserFull; user#020b1422 flags:# self:flags.10?true contact:flags.11?true mutual_contact:flags.12?true deleted:flags.13?true bot:flags.14?true bot_chat_history:flags.15?true bot_nochats:flags.16?true verified:flags.17?true restricted:flags.18?true min:flags.20?true bot_inline_geo:flags.21?true support:flags.23?true scam:flags.24?true apply_min_photo:flags.25?true fake:flags.26?true bot_attach_menu:flags.27?true premium:flags.28?true attach_menu_enabled:flags.29?true flags2:# bot_can_edit:flags2.1?true close_friend:flags2.2?true stories_hidden:flags2.3?true stories_unavailable:flags2.4?true contact_require_premium:flags2.10?true bot_business:flags2.11?true bot_has_main_app:flags2.13?true id:long access_hash:flags.0?long first_name:flags.1?string last_name:flags.2?string username:flags.3?string phone:flags.4?string photo:flags.5?UserProfilePhoto status:flags.6?UserStatus bot_info_version:flags.14?int restriction_reason:flags.18?Vector<RestrictionReason> bot_inline_placeholder:flags.19?string lang_code:flags.22?string emoji_status:flags.30?EmojiStatus usernames:flags2.0?Vector<Username> stories_max_id:flags2.5?int color:flags2.8?PeerColor profile_color:flags2.9?PeerColor bot_active_users:flags2.12?int bot_verification_icon:flags2.14?long send_paid_messages_stars:flags2.15?long = User; channel#7482147e flags:# creator:flags.0?true left:flags.2?true broadcast:flags.5?true verified:flags.7?true megagroup:flags.8?true restricted:flags.9?true signatures:flags.11?true min:flags.12?true scam:flags.19?true has_link:flags.20?true has_geo:flags.21?true slowmode_enabled:flags.22?true call_active:flags.23?true call_not_empty:flags.24?true fake:flags.25?true gigagroup:flags.26?true noforwards:flags.27?true join_to_send:flags.28?true join_request:flags.29?true forum:flags.30?true flags2:# stories_hidden:flags2.1?true stories_hidden_min:flags2.2?true stories_unavailable:flags2.3?true signature_profiles:flags2.12?true id:long access_hash:flags.13?long title:string username:flags.6?string photo:ChatPhoto date:int restriction_reason:flags.9?Vector<RestrictionReason> admin_rights:flags.14?ChatAdminRights banned_rights:flags.15?ChatBannedRights default_banned_rights:flags.18?ChatBannedRights participants_count:flags.17?int usernames:flags2.0?Vector<Username> stories_max_id:flags2.4?int color:flags2.7?PeerColor profile_color:flags2.8?PeerColor emoji_status:flags2.9?EmojiStatus level:flags2.10?int subscription_until_date:flags2.11?int bot_verification_icon:flags2.13?long send_paid_messages_stars:flags2.14?long = Chat; channelFull#52d6806b flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true flags2:# can_delete_channel:flags2.0?true antispam:flags2.1?true participants_hidden:flags2.2?true translations_disabled:flags2.3?true stories_pinned_available:flags2.5?true view_forum_as_messages:flags2.6?true restricted_sponsored:flags2.11?true can_view_revenue:flags2.12?true paid_media_allowed:flags2.14?true can_view_stars_revenue:flags2.15?true paid_reactions_available:flags2.16?true stargifts_available:flags2.19?true paid_messages_available:flags2.20?true id:long about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:flags.23?ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?long migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?long location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int call:flags.21?InputGroupCall ttl_period:flags.24?int pending_suggestions:flags.25?Vector<string> groupcall_default_join_as:flags.26?Peer theme_emoticon:flags.27?string requests_pending:flags.28?int recent_requesters:flags.28?Vector<long> default_send_as:flags.29?Peer available_reactions:flags.30?ChatReactions reactions_limit:flags2.13?int stories:flags2.4?PeerStories wallpaper:flags2.7?WallPaper boosts_applied:flags2.8?int boosts_unrestrict:flags2.9?int emojiset:flags2.10?StickerSet bot_verification:flags2.17?BotVerification stargifts_count:flags2.18?int = ChatFull; globalPrivacySettings#c9d8df1c flags:# archive_and_mute_new_noncontact_peers:flags.0?true keep_archived_unmuted:flags.1?true keep_archived_folders:flags.2?true hide_read_marks:flags.3?true new_noncontact_peers_require_premium:flags.4?true noncontact_peers_paid_stars:flags.5?long = GlobalPrivacySettings; starsTransaction#a39fd94a flags:# refund:flags.3?true pending:flags.4?true failed:flags.6?true gift:flags.10?true reaction:flags.11?true stargift_upgrade:flags.18?true business_transfer:flags.21?true stargift_resale:flags.22?true id:string stars:StarsAmount date:int peer:StarsTransactionPeer title:flags.0?string description:flags.1?string photo:flags.2?WebDocument transaction_date:flags.5?int transaction_url:flags.5?string bot_payload:flags.7?bytes msg_id:flags.8?int extended_media:flags.9?Vector<MessageMedia> subscription_period:flags.12?int giveaway_post_id:flags.13?int stargift:flags.14?StarGift floodskip_number:flags.15?int starref_commission_permille:flags.16?int starref_peer:flags.17?Peer starref_amount:flags.17?StarsAmount paid_messages:flags.19?int premium_gift_months:flags.20?int = StarsTransaction; updatePaidReactionPrivacy#8b725fce private:PaidReactionPrivacy = Update; starGiftUnique#5c62d151 flags:# id:long title:string slug:string num:int owner_id:flags.0?Peer owner_name:flags.1?string owner_address:flags.2?string attributes:Vector<StarGiftAttribute> availability_issued:int availability_total:int gift_address:flags.3?string = StarGift; paidReactionPrivacyDefault#206ad49e = PaidReactionPrivacy; paidReactionPrivacyAnonymous#1f0c1ad9 = PaidReactionPrivacy; paidReactionPrivacyPeer#dc6cfcf0 peer:InputPeer = PaidReactionPrivacy; inputPrivacyKeyNoPaidMessages#bdc597b4 = InputPrivacyKey; privacyKeyNoPaidMessages#17d348d2 = PrivacyKey; account.paidMessagesRevenue#1e109708 stars_amount:long = account.PaidMessagesRevenue; requirementToContactEmpty#050a9839 = RequirementToContact; requirementToContactPremium#e581e4e9 = RequirementToContact; requirementToContactPaidMessages#b4f67e93 stars_amount:long = RequirementToContact; inputInvoicePremiumGiftStars#dabab2ef flags:# user_id:InputUser months:int message:flags.0?TextWithEntities = InputInvoice; ---functions--- messages.sendMessage#fbf2340a flags:# no_webpage:flags.1?true silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true invert_media:flags.16?true allow_paid_floodskip:flags.19?true peer:InputPeer reply_to:flags.0?InputReplyTo message:string random_id:long reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut effect:flags.18?long allow_paid_stars:flags.21?long = Updates; messages.sendMedia#a550cd78 flags:# silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true invert_media:flags.16?true allow_paid_floodskip:flags.19?true peer:InputPeer reply_to:flags.0?InputReplyTo media:InputMedia message:string random_id:long reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut effect:flags.18?long allow_paid_stars:flags.21?long = Updates; messages.forwardMessages#bb9fa475 flags:# silent:flags.5?true background:flags.6?true with_my_score:flags.8?true drop_author:flags.11?true drop_media_captions:flags.12?true noforwards:flags.14?true allow_paid_floodskip:flags.19?true from_peer:InputPeer id:Vector<int> random_id:Vector<long> to_peer:InputPeer top_msg_id:flags.9?int schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut video_timestamp:flags.20?int allow_paid_stars:flags.21?long = Updates; messages.sendInlineBotResult#c0cf7646 flags:# silent:flags.5?true background:flags.6?true clear_draft:flags.7?true hide_via:flags.11?true peer:InputPeer reply_to:flags.0?InputReplyTo random_id:long query_id:long id:string schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut allow_paid_stars:flags.21?long = Updates; messages.sendMultiMedia#1bf89d74 flags:# silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true invert_media:flags.16?true allow_paid_floodskip:flags.19?true peer:InputPeer reply_to:flags.0?InputReplyTo multi_media:Vector<InputSingleMedia> schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut effect:flags.18?long allow_paid_stars:flags.21?long = Updates; channels.getSendAs#e785a43f flags:# for_paid_reactions:flags.0?true peer:InputPeer = channels.SendAsPeers; messages.sendPaidReaction#58bbcb50 flags:# peer:InputPeer msg_id:int count:int random_id:long private:flags.0?PaidReactionPrivacy = Updates; messages.togglePaidReactionPrivacy#435885b5 peer:InputPeer msg_id:int private:PaidReactionPrivacy = Bool; invokeWithReCaptcha#adbb0f94 {X:Type} token:string query:!X = X; account.addNoPaidMessagesException#6f688aa7 flags:# refund_charged:flags.0?true user_id:InputUser = Bool; account.getPaidMessagesRevenue#f1266f38 user_id:InputUser = account.PaidMessagesRevenue; channels.updatePaidMessagesPrice#fc84653f channel:InputChannel send_paid_messages_stars:long = Updates; users.getRequirementsToContact#d89a83a3 id:Vector<InputUser> = Vector<RequirementToContact>; payments.toggleStarGiftsPinnedToTop#1513e7b0 peer:InputPeer stargift:Vector<InputSavedStarGift> = Bool;
第198层
本层引入了:
- 将收藏品作为表情符号状态(以及对表情符号状态 API 的一些细微调整)»
- 向频道赠送礼物
- 频道收到礼物的通知 »
- 查看同伴收到的所有礼物 »
- 获取我们控制的节点所拥有的特定礼物信息 »
- 将收藏品礼品提取到 TON 区块链 »
- 自定义视频封面 »
- 自定义视频起始时间戳 »
架构变更
新方法
- 添加account.getCollectibleEmojiStatuses- 获取已拥有收藏品的表情符号状态列表»
- 添加payments.getSavedStarGifts- 获取同伴拥有的所有礼物的完整列表。
- 添加payments.getSavedStarGift- 获取我们控制的同伴拥有的特定礼物的信息。
- 添加了payments.getStarGiftWithdrawalUrl- 将收藏品礼品转换为 TON 区块链上的 NFT。
- 添加了payments.toggleChatStarGiftNotifications- 启用或禁用每次指定频道收到礼物时接收通知的功能,只有具有post_messages管理员权限的管理员才能调用此功能。
改变方法
- messages.forwardMessages中添加了video_timestamp参数
- 在payments.saveStarGift中添加了stargift参数,移除了msg_id参数。
- 在payments.convertStarGift中添加了stargift参数,移除了msg_id参数。
- 在payments.upgradeStarGift中添加了stargift参数,移除了msg_id参数。
- 在payments.transferStarGift中,添加了stargift参数,移除了msg_id参数,并将to_id的类型从InputUser更改为InputPeer。
已删除的方法
- 已移除 payments.getUserStarGifts
- 已移除 payments.getUserStarGift
新建筑商
- 添加emojiStatusCollectible-已拥有的收藏品礼物 »作为表情符号状态。
- 添加inputEmojiStatusCollectible-已拥有的收藏品礼物 »作为表情符号状态:只能在account.updateEmojiStatus中使用,API 永远不会返回此值。
- 新增savedStarGift- 代表由同伴拥有的礼物。
- 已添加付款。已保存的星光礼物 - 表示礼物列表。
- 新增输入 SavedStarGiftUser- 在与其他用户的私聊中收到的礼物。
- 新增输入 SavedStarGiftChat- 我们拥有的频道收到的礼物。
- 添加了payments.starGiftWithdrawalUrl- 可用于在 Fragment 上导入导出的 NFT 的 URL。
已更改的构造函数
- 在inputMediaUploadedDocument中添加video_cover和video_timestamp参数
- 在inputMediaDocument中添加video_cover和video_timestamp参数
- 在messageMediaDocument中添加video_cover和video_timestamp参数
- 在channelFull中添加stargifts_available和stargifts_count参数
- 在inputMediaDocumentExternal中添加video_cover和video_timestamp参数
- 添加标志,直到emojiStatus中的参数
- 在inputInvoiceStarGift中添加了peer参数,移除了user_id参数。
- 在messageActionStarGift中添加了from_id、peer和saved_id参数
- 在starGiftAttributeOriginalDetails中,将sender_id的类型从flags.0?long更改为flags.0?Peer,将 recipient_id 的类型从long更改为Peer。
- starGiftUnique中添加了owner_address参数,并将owner_id的类型从flags.0?long更改为flags.0?Peer。
- 在messageActionStarGiftUnique中添加了from_id、peer和saved_id参数
- 在inputInvoiceStarGiftUpgrade中添加了stargift参数,移除了msg_id参数。
- 在inputInvoiceStarGiftTransfer中,添加了stargift参数,移除了msg_id参数,并将to_id的类型从InputUser更改为InputPeer。
已删除的构造函数
- 已移除 emojiStatusUntil
- 已移除 userStarGift
- 已移除 payments.userStarGifts
模式
inputMediaUploadedDocument#037c9330 flags:# nosound_video:flags.3?true force_file:flags.4?true spoiler:flags.5?true file:InputFile thumb:flags.2?InputFile mime_type:string attributes:Vector<DocumentAttribute> stickers:flags.0?Vector<InputDocument> video_cover:flags.6?InputPhoto video_timestamp:flags.7?int ttl_seconds:flags.1?int = InputMedia; inputMediaDocument#a8763ab5 flags:# spoiler:flags.2?true id:InputDocument video_cover:flags.3?InputPhoto video_timestamp:flags.4?int ttl_seconds:flags.0?int query:flags.1?string = InputMedia; messageMediaDocument#52d8ccd9 flags:# nopremium:flags.3?true spoiler:flags.4?true video:flags.6?true round:flags.7?true voice:flags.8?true document:flags.0?Document alt_documents:flags.5?Vector<Document> video_cover:flags.9?Photo video_timestamp:flags.10?int ttl_seconds:flags.2?int = MessageMedia; channelFull#52d6806b flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true flags2:# can_delete_channel:flags2.0?true antispam:flags2.1?true participants_hidden:flags2.2?true translations_disabled:flags2.3?true stories_pinned_available:flags2.5?true view_forum_as_messages:flags2.6?true restricted_sponsored:flags2.11?true can_view_revenue:flags2.12?true paid_media_allowed:flags2.14?true can_view_stars_revenue:flags2.15?true paid_reactions_available:flags2.16?true stargifts_available:flags2.19?true id:long about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:flags.23?ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?long migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?long location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int call:flags.21?InputGroupCall ttl_period:flags.24?int pending_suggestions:flags.25?Vector<string> groupcall_default_join_as:flags.26?Peer theme_emoticon:flags.27?string requests_pending:flags.28?int recent_requesters:flags.28?Vector<long> default_send_as:flags.29?Peer available_reactions:flags.30?ChatReactions reactions_limit:flags2.13?int stories:flags2.4?PeerStories wallpaper:flags2.7?WallPaper boosts_applied:flags2.8?int boosts_unrestrict:flags2.9?int emojiset:flags2.10?StickerSet bot_verification:flags2.17?BotVerification stargifts_count:flags2.18?int = ChatFull; inputMediaDocumentExternal#779600f9 flags:# spoiler:flags.1?true url:string ttl_seconds:flags.0?int video_cover:flags.2?InputPhoto video_timestamp:flags.3?int = InputMedia; emojiStatus#e7ff068a flags:# document_id:long until:flags.0?int = EmojiStatus; inputInvoiceStarGift#e8625e92 flags:# hide_name:flags.0?true include_upgrade:flags.2?true peer:InputPeer gift_id:long message:flags.1?TextWithEntities = InputInvoice; messageActionStarGift#4717e8a4 flags:# name_hidden:flags.0?true saved:flags.2?true converted:flags.3?true upgraded:flags.5?true refunded:flags.9?true can_upgrade:flags.10?true gift:StarGift message:flags.1?TextWithEntities convert_stars:flags.4?long upgrade_msg_id:flags.5?int upgrade_stars:flags.8?long from_id:flags.11?Peer peer:flags.12?Peer saved_id:flags.12?long = MessageAction; starGiftAttributeOriginalDetails#e0bff26c flags:# sender_id:flags.0?Peer recipient_id:Peer date:int message:flags.1?TextWithEntities = StarGiftAttribute; starGiftUnique#f2fe7e4a flags:# id:long title:string slug:string num:int owner_id:flags.0?Peer owner_name:flags.1?string owner_address:flags.2?string attributes:Vector<StarGiftAttribute> availability_issued:int availability_total:int = StarGift; messageActionStarGiftUnique#acdfcb81 flags:# upgrade:flags.0?true transferred:flags.1?true saved:flags.2?true refunded:flags.5?true gift:StarGift can_export_at:flags.3?int transfer_stars:flags.4?long from_id:flags.6?Peer peer:flags.7?Peer saved_id:flags.7?long = MessageAction; inputInvoiceStarGiftUpgrade#4d818d5d flags:# keep_original_details:flags.0?true stargift:InputSavedStarGift = InputInvoice; inputInvoiceStarGiftTransfer#4a5f5bd9 stargift:InputSavedStarGift to_id:InputPeer = InputInvoice; emojiStatusCollectible#7184603b flags:# collectible_id:long document_id:long title:string slug:string pattern_document_id:long center_color:int edge_color:int pattern_color:int text_color:int until:flags.0?int = EmojiStatus; inputEmojiStatusCollectible#07141dbf flags:# collectible_id:long until:flags.0?int = EmojiStatus; savedStarGift#6056dba5 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 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 = SavedStarGift; payments.savedStarGifts#95f389b1 flags:# count:int chat_notifications_enabled:flags.1?Bool gifts:Vector<SavedStarGift> next_offset:flags.0?string chats:Vector<Chat> users:Vector<User> = payments.SavedStarGifts; inputSavedStarGiftUser#69279795 msg_id:int = InputSavedStarGift; inputSavedStarGiftChat#f101aa7f peer:InputPeer saved_id:long = InputSavedStarGift; payments.starGiftWithdrawalUrl#84aa3a9c url:string = payments.StarGiftWithdrawalUrl; ---functions--- messages.forwardMessages#6d74da08 flags:# silent:flags.5?true background:flags.6?true with_my_score:flags.8?true drop_author:flags.11?true drop_media_captions:flags.12?true noforwards:flags.14?true allow_paid_floodskip:flags.19?true from_peer:InputPeer id:Vector<int> random_id:Vector<long> to_peer:InputPeer top_msg_id:flags.9?int schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut video_timestamp:flags.20?int = Updates; payments.saveStarGift#2a2a697c flags:# unsave:flags.0?true stargift:InputSavedStarGift = Bool; payments.convertStarGift#74bf076b stargift:InputSavedStarGift = Bool; payments.upgradeStarGift#aed6e4f5 flags:# keep_original_details:flags.0?true stargift:InputSavedStarGift = Updates; payments.transferStarGift#7f18176a stargift:InputSavedStarGift to_id:InputPeer = Updates; account.getCollectibleEmojiStatuses#2e7b4543 hash:long = account.EmojiStatuses; payments.getSavedStarGifts#23830de9 flags:# exclude_unsaved:flags.0?true exclude_saved:flags.1?true exclude_unlimited:flags.2?true exclude_limited:flags.3?true exclude_unique:flags.4?true sort_by_value:flags.5?true peer:InputPeer offset:string limit:int = payments.SavedStarGifts; payments.getSavedStarGift#b455a106 stargift:Vector<InputSavedStarGift> = payments.SavedStarGifts; payments.getStarGiftWithdrawalUrl#d06e93a8 stargift:InputSavedStarGift password:InputCheckPasswordSRP = payments.StarGiftWithdrawalUrl; payments.toggleChatStarGiftNotifications#60eaefa1 flags:# enabled:flags.0?true peer:InputPeer = Bool;
第197层
本层引入了:
- 收藏礼品链接 »
- 收藏礼品故事媒体领域 »
- 收藏品网页预览 »
- 类似的机器人推荐 »
架构变更
新方法
- 新增bots.getBotRecommendations- 获取主题相似的机器人列表,这些机器人是根据其订阅者群体的相似性选择的,请点击此处»了解更多信息。
- 添加了payments.getUniqueStarGift- 获取有关收藏品礼物的信息»使用从收藏品礼物链接获得的 slug »。
改变方法
- 将messages.getWebPagePreview的类型从MessageMedia更改为messages.WebPagePreview
新建筑商
- 添加了users.users- 描述用户(或机器人)列表。
- 添加了users.usersSlice- 描述部分用户列表。
- 新增付款。uniqueStarGift- 代表收藏礼品 »。
- 添加了webPageAttributeUniqueStarGift- 包含有关收藏品礼物的信息 »用于收藏品礼物的网页预览»(该网页将有一个type)telegram_nft。
- 添加了mediaAreaStarGift- 代表收藏品 »。
- 新增messages.webPagePreview- 表示网页预览。
已更改的构造函数
- 在starGiftUnique中添加了flags、slug和owner_name参数,并将owner_id的类型从long更改为flags.0?long。
模式
starGiftUnique#3482f322 flags:# id:long title:string slug:string num:int owner_id:flags.0?long owner_name:flags.1?string attributes:Vector<StarGiftAttribute> availability_issued:int availability_total:int = StarGift; users.users#62d706b8 users:Vector<User> = users.Users; users.usersSlice#315a4974 count:int users:Vector<User> = users.Users; payments.uniqueStarGift#caa2f60b gift:StarGift users:Vector<User> = payments.UniqueStarGift; webPageAttributeUniqueStarGift#cf6f6db8 gift:StarGift = WebPageAttribute; mediaAreaStarGift#5787686d coordinates:MediaAreaCoordinates slug:string = MediaArea; messages.webPagePreview#b53e8b21 media:MessageMedia users:Vector<User> = messages.WebPagePreview; ---functions--- messages.getWebPagePreview#570d6f6f flags:# message:string entities:flags.3?Vector<MessageEntity> = messages.WebPagePreview; bots.getBotRecommendations#a1b70815 bot:InputUser = users.Users; payments.getUniqueStarGift#a1974d72 slug:string = payments.UniqueStarGift;
第196层
本层引入了:
- 更安全的群组通话 »
- Telegram 网关验证消息的明确送达确认»
- 第三方验证 »
- 对服务消息的响应 »
- 收藏礼品 »
- 添加对文件夹标题中实体的支持,并新增一个title_noanimate标志,可选择冻结标题中的动画表情符号实体。
- 添加到通道的所有标志(如下所列)都是有效标志,这意味着即使设置了传入通道min的标志,它们也必须应用于本地存储的版本。min
- 添加到用户的所有标志(如下所列)都是有效标志,这意味着即使设置了传入用户min的标志,它们也必须应用于本地存储的版本。min
架构变更
新方法
- 新增phone.createConferenceCall- 创建并可选择加入新的电话会议。
- 添加了messages.reportMessagesDelivery- 用于Telegram 网关验证消息 » :如果消息中指定了report_delivery_until_date标志或推送通知中的等效标志,则向服务器指示客户端已收到一条或多条消息。
- 添加了bots.setCustomVerification -代表组织验证用户或聊天»。
- 添加了payments.getStarGiftUpgradePreview - 获取礼物升级为收藏品后可能获得的属性预览(随机选择),详情请参见此处。
- 新增付款方式。升级星礼- 将礼物升级为收藏品礼物:仅当礼物赠送者已支付升级费用时才能使用;请参阅此处»了解完整流程的更多信息(包括礼物赠送者未支付升级费用时使用的不同流程)。
- 新增payments.transferStarGift- 将收藏品礼物转移给其他用户或频道:仅当转移免费时才能使用(即messageActionStarGiftUniquetransfer_stars未设置);请参阅此处»以了解有关完整流程的更多信息(包括转移不免费时要使用的不同流程)。
- 已添加付款.getUserStarGift
改变方法
- 在phone.requestCall中添加了conference_call参数
- 在phone.joinGroupCall中添加key_fingerprint参数
- 已移除payments.saveStarGift中的user_id参数
- 已移除payments.convertStarGift中的user_id参数
新建筑商
- 添加了botVerifierSettings- 关于当前验证机器人的信息 »。
- 添加了机器人验证- 描述机器人验证图标 »。
- 添加了starGiftAttributeModel- 收藏品礼品的模型»。
- 添加了starGiftAttributePattern- 一个贴在收藏礼品背景上的贴纸»使用重复图案。
- 添加了starGiftAttributeBackdrop- 收藏品的背景»。
- 添加starGiftAttributeOriginalDetails- 关于原始礼物(升级为收藏品礼物之前)的发送者、接收者和附加消息的信息 » 。
- 新增starGiftUnique- 代表可收藏的星星礼物,点击此处 »了解更多信息。
- 添加消息 ActionStarGiftUnique-礼物 »已升级为收藏品 »。
- 添加了inputInvoiceStarGiftUpgrade- 用于支付将礼物升级为收藏品礼物的费用,有关完整流程的更多信息,请参阅收藏品礼物 »文档。
- 添加了inputInvoiceStarGiftTransfer- 用于支付将收藏品礼物转移给其他用户的费用,请参阅礼物 »文档以获取更多信息。
- 新增payments.starGiftUpgradePreview- 预览礼物升级为收藏品后可能获得的属性(随机选择) ,详情请见此处。
已更改的构造函数
- 在消息中添加了report_delivery_until_date参数
- 在messageService中添加了reactions_are_possible和reactions参数。
- 在userFull中添加bot_verification参数
- 在网页中添加了video_cover_photo参数
- chatInvite中添加了bot_verification参数
- 用户中添加了bot_verification_icon参数
- 在botInfo中添加了verifier_settings参数
- 在频道中添加了bot_verification_icon参数
- 在channelFull中添加了bot_verification参数
- 在phoneCallWaiting中添加conference_call参数
- 在phoneCallRequested中添加conference_call参数
- 在phoneCallAccepted中添加conference_call参数
- 在phoneCall中添加conference_call参数
- 在phoneCallDiscarded中添加conference_call参数
- 添加了title_noanimate参数,并将dialogFilter中的title类型从string更改为TextWithEntities。
- 在groupCall中添加conference_from_call参数
- 添加了flags参数,并将updateGroupCall中的chat_id类型从long更改为flags.0?long
- 添加了title_noanimate参数,并将dialogFilterChatlist中的title类型从string更改为TextWithEntities
- 在chatlists.chatlistInvite中添加了title_noanimate参数,并将title的类型从string更改为TextWithEntities 。
- 在messageActionGiftCode中,将未认领物品的类型从flags.2?true更改为flags.5?true。
- 在starsTransaction中添加stargift_upgrade参数。
- starGift中添加了upgrade_stars参数
- 在inputInvoiceStarGift中添加include_upgrade参数
- 在messageActionStarGift中添加了upgraded、refunded、can_upgrade、upgrade_msg_id和upgrade_stars参数
- 在userStarGift中添加refunded、can_upgrade、upgrade_stars、can_export_at和transfer_stars参数
推送通知变更
新的推送通知
- 添加了MESSAGE_STARGIFT_UPGRADE-{1} upgraded your Gift
- 添加了MESSAGE_UNIQUE_STARGIFT-{1} transferred you a Gift!
模式
message#96fdbbe9 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true post:flags.14?true from_scheduled:flags.18?true legacy:flags.19?true edit_hide:flags.21?true pinned:flags.24?true noforwards:flags.26?true invert_media:flags.27?true flags2:# offline:flags2.1?true video_processing_pending:flags2.4?true id:int from_id:flags.8?Peer from_boosts_applied:flags.29?int peer_id:Peer saved_peer_id:flags.28?Peer fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long via_business_bot_id:flags2.0?long reply_to:flags.3?MessageReplyHeader date:int message:string media:flags.9?MessageMedia reply_markup:flags.6?ReplyMarkup entities:flags.7?Vector<MessageEntity> views:flags.10?int forwards:flags.10?int replies:flags.23?MessageReplies edit_date:flags.15?int post_author:flags.16?string grouped_id:flags.17?long reactions:flags.20?MessageReactions restriction_reason:flags.22?Vector<RestrictionReason> ttl_period:flags.25?int quick_reply_shortcut_id:flags.30?int effect:flags2.2?long factcheck:flags2.3?FactCheck report_delivery_until_date:flags2.5?int = Message; messageService#d3d28540 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true reactions_are_possible:flags.9?true silent:flags.13?true post:flags.14?true legacy:flags.19?true id:int from_id:flags.8?Peer peer_id:Peer reply_to:flags.3?MessageReplyHeader date:int action:MessageAction reactions:flags.20?MessageReactions ttl_period:flags.25?int = Message; userFull#4d975bbc flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true voice_messages_forbidden:flags.20?true translations_disabled:flags.23?true stories_pinned_available:flags.26?true blocked_my_stories_from:flags.27?true wallpaper_overridden:flags.28?true contact_require_premium:flags.29?true read_dates_private:flags.30?true flags2:# sponsored_enabled:flags2.7?true can_view_revenue:flags2.9?true bot_can_manage_emoji_status:flags2.10?true id:long about:flags.1?string settings:PeerSettings personal_photo:flags.21?Photo profile_photo:flags.2?Photo fallback_photo:flags.22?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int theme_emoticon:flags.15?string private_forward_name:flags.16?string bot_group_admin_rights:flags.17?ChatAdminRights bot_broadcast_admin_rights:flags.18?ChatAdminRights premium_gifts:flags.19?Vector<PremiumGiftOption> wallpaper:flags.24?WallPaper stories:flags.25?PeerStories business_work_hours:flags2.0?BusinessWorkHours business_location:flags2.1?BusinessLocation business_greeting_message:flags2.2?BusinessGreetingMessage business_away_message:flags2.3?BusinessAwayMessage business_intro:flags2.4?BusinessIntro birthday:flags2.5?Birthday personal_channel_id:flags2.6?long personal_channel_message:flags2.6?int stargifts_count:flags2.8?int starref_program:flags2.11?StarRefProgram bot_verification:flags2.12?BotVerification = UserFull; webPage#e89c45b2 flags:# has_large_media:flags.13?true video_cover_photo:flags.14?true id:long url:string display_url:string hash:int type:flags.0?string site_name:flags.1?string title:flags.2?string description:flags.3?string photo:flags.4?Photo embed_url:flags.5?string embed_type:flags.5?string embed_width:flags.6?int embed_height:flags.6?int duration:flags.7?int author:flags.8?string document:flags.9?Document cached_page:flags.10?Page attributes:flags.12?Vector<WebPageAttribute> = WebPage; chatInvite#5c9d3702 flags:# channel:flags.0?true broadcast:flags.1?true public:flags.2?true megagroup:flags.3?true request_needed:flags.6?true verified:flags.7?true scam:flags.8?true fake:flags.9?true can_refulfill_subscription:flags.11?true title:string about:flags.5?string photo:Photo participants_count:int participants:flags.4?Vector<User> color:int subscription_pricing:flags.10?StarsSubscriptionPricing subscription_form_id:flags.12?long bot_verification:flags.13?BotVerification = ChatInvite; user#4b46c37e flags:# self:flags.10?true contact:flags.11?true mutual_contact:flags.12?true deleted:flags.13?true bot:flags.14?true bot_chat_history:flags.15?true bot_nochats:flags.16?true verified:flags.17?true restricted:flags.18?true min:flags.20?true bot_inline_geo:flags.21?true support:flags.23?true scam:flags.24?true apply_min_photo:flags.25?true fake:flags.26?true bot_attach_menu:flags.27?true premium:flags.28?true attach_menu_enabled:flags.29?true flags2:# bot_can_edit:flags2.1?true close_friend:flags2.2?true stories_hidden:flags2.3?true stories_unavailable:flags2.4?true contact_require_premium:flags2.10?true bot_business:flags2.11?true bot_has_main_app:flags2.13?true id:long access_hash:flags.0?long first_name:flags.1?string last_name:flags.2?string username:flags.3?string phone:flags.4?string photo:flags.5?UserProfilePhoto status:flags.6?UserStatus bot_info_version:flags.14?int restriction_reason:flags.18?Vector<RestrictionReason> bot_inline_placeholder:flags.19?string lang_code:flags.22?string emoji_status:flags.30?EmojiStatus usernames:flags2.0?Vector<Username> stories_max_id:flags2.5?int color:flags2.8?PeerColor profile_color:flags2.9?PeerColor bot_active_users:flags2.12?int bot_verification_icon:flags2.14?long = User; botInfo#4d8a0299 flags:# has_preview_medias:flags.6?true user_id:flags.0?long description:flags.1?string description_photo:flags.4?Photo description_document:flags.5?Document commands:flags.2?Vector<BotCommand> menu_button:flags.3?BotMenuButton privacy_policy_url:flags.7?string app_settings:flags.8?BotAppSettings verifier_settings:flags.9?BotVerifierSettings = BotInfo; channel#e00998b7 flags:# creator:flags.0?true left:flags.2?true broadcast:flags.5?true verified:flags.7?true megagroup:flags.8?true restricted:flags.9?true signatures:flags.11?true min:flags.12?true scam:flags.19?true has_link:flags.20?true has_geo:flags.21?true slowmode_enabled:flags.22?true call_active:flags.23?true call_not_empty:flags.24?true fake:flags.25?true gigagroup:flags.26?true noforwards:flags.27?true join_to_send:flags.28?true join_request:flags.29?true forum:flags.30?true flags2:# stories_hidden:flags2.1?true stories_hidden_min:flags2.2?true stories_unavailable:flags2.3?true signature_profiles:flags2.12?true id:long access_hash:flags.13?long title:string username:flags.6?string photo:ChatPhoto date:int restriction_reason:flags.9?Vector<RestrictionReason> admin_rights:flags.14?ChatAdminRights banned_rights:flags.15?ChatBannedRights default_banned_rights:flags.18?ChatBannedRights participants_count:flags.17?int usernames:flags2.0?Vector<Username> stories_max_id:flags2.4?int color:flags2.7?PeerColor profile_color:flags2.8?PeerColor emoji_status:flags2.9?EmojiStatus level:flags2.10?int subscription_until_date:flags2.11?int bot_verification_icon:flags2.13?long = Chat; channelFull#9ff3b858 flags:# can_view_participants:flags.3?true can_set_username:flags.6?true can_set_stickers:flags.7?true hidden_prehistory:flags.10?true can_set_location:flags.16?true has_scheduled:flags.19?true can_view_stats:flags.20?true blocked:flags.22?true flags2:# can_delete_channel:flags2.0?true antispam:flags2.1?true participants_hidden:flags2.2?true translations_disabled:flags2.3?true stories_pinned_available:flags2.5?true view_forum_as_messages:flags2.6?true restricted_sponsored:flags2.11?true can_view_revenue:flags2.12?true paid_media_allowed:flags2.14?true can_view_stars_revenue:flags2.15?true paid_reactions_available:flags2.16?true id:long about:string participants_count:flags.0?int admins_count:flags.1?int kicked_count:flags.2?int banned_count:flags.2?int online_count:flags.13?int read_inbox_max_id:int read_outbox_max_id:int unread_count:int chat_photo:Photo notify_settings:PeerNotifySettings exported_invite:flags.23?ExportedChatInvite bot_info:Vector<BotInfo> migrated_from_chat_id:flags.4?long migrated_from_max_id:flags.4?int pinned_msg_id:flags.5?int stickerset:flags.8?StickerSet available_min_id:flags.9?int folder_id:flags.11?int linked_chat_id:flags.14?long location:flags.15?ChannelLocation slowmode_seconds:flags.17?int slowmode_next_send_date:flags.18?int stats_dc:flags.12?int pts:int call:flags.21?InputGroupCall ttl_period:flags.24?int pending_suggestions:flags.25?Vector<string> groupcall_default_join_as:flags.26?Peer theme_emoticon:flags.27?string requests_pending:flags.28?int recent_requesters:flags.28?Vector<long> default_send_as:flags.29?Peer available_reactions:flags.30?ChatReactions reactions_limit:flags2.13?int stories:flags2.4?PeerStories wallpaper:flags2.7?WallPaper boosts_applied:flags2.8?int boosts_unrestrict:flags2.9?int emojiset:flags2.10?StickerSet bot_verification:flags2.17?BotVerification = ChatFull; phoneCallWaiting#eed42858 flags:# video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long protocol:PhoneCallProtocol receive_date:flags.0?int conference_call:flags.8?InputGroupCall = PhoneCall; phoneCallRequested#45361c63 flags:# video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long g_a_hash:bytes protocol:PhoneCallProtocol conference_call:flags.8?InputGroupCall = PhoneCall; phoneCallAccepted#22fd7181 flags:# video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long g_b:bytes protocol:PhoneCallProtocol conference_call:flags.8?InputGroupCall = PhoneCall; phoneCall#3ba5940c flags:# p2p_allowed:flags.5?true video:flags.6?true id:long access_hash:long date:int admin_id:long participant_id:long g_a_or_b:bytes key_fingerprint:long protocol:PhoneCallProtocol connections:Vector<PhoneConnection> start_date:int custom_parameters:flags.7?DataJSON conference_call:flags.8?InputGroupCall = PhoneCall; phoneCallDiscarded#f9d25503 flags:# need_rating:flags.2?true need_debug:flags.3?true video:flags.6?true id:long reason:flags.0?PhoneCallDiscardReason duration:flags.1?int conference_call:flags.8?InputGroupCall = PhoneCall; dialogFilter#aa472651 flags:# contacts:flags.0?true non_contacts:flags.1?true groups:flags.2?true broadcasts:flags.3?true bots:flags.4?true exclude_muted:flags.11?true exclude_read:flags.12?true exclude_archived:flags.13?true title_noanimate:flags.28?true id:int title:TextWithEntities emoticon:flags.25?string color:flags.27?int pinned_peers:Vector<InputPeer> include_peers:Vector<InputPeer> exclude_peers:Vector<InputPeer> = DialogFilter; groupCall#cdf8d3e3 flags:# join_muted:flags.1?true can_change_join_muted:flags.2?true join_date_asc:flags.6?true schedule_start_subscribed:flags.8?true can_start_video:flags.9?true record_video_active:flags.11?true rtmp_stream:flags.12?true listeners_hidden:flags.13?true id:long access_hash:long participants_count:int title:flags.3?string stream_dc_id:flags.4?int record_start_date:flags.5?int schedule_date:flags.7?int unmuted_video_count:flags.10?int unmuted_video_limit:int version:int conference_from_call:flags.14?long = GroupCall; updateGroupCall#97d64341 flags:# chat_id:flags.0?long call:GroupCall = Update; dialogFilterChatlist#96537bd7 flags:# has_my_invites:flags.26?true title_noanimate:flags.28?true id:int title:TextWithEntities emoticon:flags.25?string color:flags.27?int pinned_peers:Vector<InputPeer> include_peers:Vector<InputPeer> = DialogFilter; chatlists.chatlistInvite#f10ece2f flags:# title_noanimate:flags.1?true title:TextWithEntities emoticon:flags.0?string peers:Vector<Peer> chats:Vector<Chat> users:Vector<User> = chatlists.ChatlistInvite; messageActionGiftCode#56d03994 flags:# via_giveaway:flags.0?true unclaimed:flags.5?true boost_peer:flags.1?Peer months:int slug:string currency:flags.2?string amount:flags.2?long crypto_currency:flags.3?string crypto_amount:flags.3?long message:flags.4?TextWithEntities = MessageAction; starsTransaction#64dfc926 flags:# refund:flags.3?true pending:flags.4?true failed:flags.6?true gift:flags.10?true reaction:flags.11?true stargift_upgrade:flags.18?true id:string stars:StarsAmount date:int peer:StarsTransactionPeer title:flags.0?string description:flags.1?string photo:flags.2?WebDocument transaction_date:flags.5?int transaction_url:flags.5?string bot_payload:flags.7?bytes msg_id:flags.8?int extended_media:flags.9?Vector<MessageMedia> subscription_period:flags.12?int giveaway_post_id:flags.13?int stargift:flags.14?StarGift floodskip_number:flags.15?int starref_commission_permille:flags.16?int starref_peer:flags.17?Peer starref_amount:flags.17?StarsAmount = StarsTransaction; starGift#02cc73c8 flags:# limited:flags.0?true sold_out:flags.1?true birthday:flags.2?true id:long sticker:Document stars:long availability_remains:flags.0?int availability_total:flags.0?int convert_stars:long first_sale_date:flags.1?int last_sale_date:flags.1?int upgrade_stars:flags.3?long = StarGift; inputInvoiceStarGift#25d8c1d8 flags:# hide_name:flags.0?true include_upgrade:flags.2?true user_id:InputUser gift_id:long message:flags.1?TextWithEntities = InputInvoice; messageActionStarGift#d8f4f0a7 flags:# name_hidden:flags.0?true saved:flags.2?true converted:flags.3?true upgraded:flags.5?true refunded:flags.9?true can_upgrade:flags.10?true gift:StarGift message:flags.1?TextWithEntities convert_stars:flags.4?long upgrade_msg_id:flags.5?int upgrade_stars:flags.8?long = MessageAction; userStarGift#325835e1 flags:# name_hidden:flags.0?true unsaved:flags.5?true refunded:flags.9?true can_upgrade:flags.10?true from_id:flags.1?long date:int gift:StarGift message:flags.2?TextWithEntities msg_id:flags.3?int convert_stars:flags.4?long upgrade_stars:flags.6?long can_export_at:flags.7?int transfer_stars:flags.8?long = UserStarGift; botVerifierSettings#b0cd6617 flags:# can_modify_custom_description:flags.1?true icon:long company:string custom_description:flags.0?string = BotVerifierSettings; botVerification#f93cd45c bot_id:long icon:long description:string = BotVerification; starGiftAttributeModel#39d99013 name:string document:Document rarity_permille:int = StarGiftAttribute; starGiftAttributePattern#13acff19 name:string document:Document rarity_permille:int = StarGiftAttribute; starGiftAttributeBackdrop#94271762 name:string center_color:int edge_color:int pattern_color:int text_color:int rarity_permille:int = StarGiftAttribute; starGiftAttributeOriginalDetails#c02c4f4b flags:# sender_id:flags.0?long recipient_id:long date:int message:flags.1?TextWithEntities = StarGiftAttribute; starGiftUnique#6a1407cd id:long title:string num:int owner_id:long attributes:Vector<StarGiftAttribute> availability_issued:int availability_total:int = StarGift; messageActionStarGiftUnique#26077b99 flags:# upgrade:flags.0?true transferred:flags.1?true saved:flags.2?true refunded:flags.5?true gift:StarGift can_export_at:flags.3?int transfer_stars:flags.4?long = MessageAction; inputInvoiceStarGiftUpgrade#5ebe7262 flags:# keep_original_details:flags.0?true msg_id:int = InputInvoice; inputInvoiceStarGiftTransfer#ae3ba9ed msg_id:int to_id:InputUser = InputInvoice; payments.starGiftUpgradePreview#167bd90b sample_attributes:Vector<StarGiftAttribute> = payments.StarGiftUpgradePreview; ---functions--- phone.requestCall#a6c4600c flags:# video:flags.0?true user_id:InputUser conference_call:flags.1?InputGroupCall random_id:int g_a_hash:bytes protocol:PhoneCallProtocol = phone.PhoneCall; phone.joinGroupCall#d61e1df3 flags:# muted:flags.0?true video_stopped:flags.2?true call:InputGroupCall join_as:InputPeer invite_hash:flags.1?string key_fingerprint:flags.3?long params:DataJSON = Updates; payments.saveStarGift#92fd2aae flags:# unsave:flags.0?true msg_id:int = Bool; payments.convertStarGift#72770c83 msg_id:int = Bool; phone.createConferenceCall#dfc909ab peer:InputPhoneCall key_fingerprint:long = phone.PhoneCall; messages.reportMessagesDelivery#5a6d7395 flags:# push:flags.0?true peer:InputPeer id:Vector<int> = Bool; bots.setCustomVerification#8b89dfbd flags:# enabled:flags.1?true bot:flags.0?InputUser peer:InputPeer custom_description:flags.2?string = Bool; payments.getStarGiftUpgradePreview#9c9abcb1 gift_id:long = payments.StarGiftUpgradePreview; payments.upgradeStarGift#cf4f0781 flags:# keep_original_details:flags.0?true msg_id:int = Updates; payments.transferStarGift#333fb526 msg_id:int to_id:InputUser = Updates; payments.getUserStarGift#b502e4a5 msg_id:Vector<int> = payments.UserStarGifts;
第195层
从第 186 层开始阅读变更日志,以查看自上次文档更新以来的所有更改。
此层引入了以下新功能:
-
机器人联盟计划 »
这包括以下新的客户端配置项 »
- starref_start_param_prefixes »
- starref_program_allowed »
- starref_connect_allowed »
- starref_min_commission_permille »
- starref_max_commission_permille »
以下是一些新的深度链接:
- 推荐链接 »
-
人工智能驱动的贴纸搜索 »
-
新增了一条USERPIC_SETUP 建议 » 。
-
RPC错误数据库已更新 »
以下文档是为已有功能添加的:
-
已为以下预先存在的客户端配置项添加了文档 »:
- 应用内更新检查延迟 »
- premium_manage_subscription_url »
- 忽略限制原因 »
- 限制添加平台 »
- new_noncontact_peers_require_premium_without_ownpremium »
- 客户端配置页面 »现在包含 JSON 格式的所有配置键的准确完整的默认值列表(以前,JSON 转储仅包含示例值,这些值不能全部用作有效的默认值)。
- 新增了关于Telegram Premium 故事功能标识符的文档 »
- 新增了关于Telegram Premium 功能限制标识符的文档 »
- 更新了网页类型列表»
- 添加了有关在绑定身份验证密钥时如何处理 ENCRYPTED_MESSAGE_INVALID 错误的信息。
架构变更
新方法
- 新增了bots.getAdminedBots 函数- 获取当前用户拥有的机器人列表
- 新增bots.updateStarRefProgram- 创建、编辑或删除我们拥有的机器人的联盟计划
- 新增payments.getConnectedStarRefBots- 获取我们为特定用户创建的所有关联关系
- 新增payments.getConnectedStarRefBot- 获取特定机器人关联信息»
- 新增payments.getSuggestedStarRefBots- 获取包含可用联盟计划的推荐小程序列表
- 新增payments.connectStarRefBot- 加入机器人的联盟计划,成为联盟会员 »
- 已添加payments.editConnectedStarRefBot- 退出机器人的联盟计划 »
- 新增messages.searchStickers- 使用 AI 驱动的关键词搜索查找贴纸
改变方法
- 在contacts.resolveUsername中添加了标志和引用参数
新建筑商
- 新增starRefProgram- Indo,介绍一个由机器人提供的联盟营销计划。
- 新增connectedBotStarRef- 关于我们与 Mini App 合作开展的活跃联盟计划的信息
- 已添加付款。connectedStarRefBots- 活跃联盟
- 新增付款方式。推荐的 StarRefBots -提供可用联盟计划的推荐小程序列表
- 已添加starsAmount - 描述Telegram Stars的实际数量(即可能为小数)。
- 已添加messages.foundStickersNotModified- 未找到与指定查询匹配的新贴纸
- 已添加messages.foundStickers- 找到贴纸
已更改的构造函数
- 在userFull中添加starref_program参数
- 添加了starref_commission_permille、starref_peer和starref_amount参数,并将starsTransaction中的stars类型从long更改为StarsAmount。
- 已将payments.starsStatus中的余额类型从long更改为StarsAmount 。
- 在updateStarsBalance中,将余额类型从long更改为StarsAmount。
- 在starsRevenueStatus中,将current_balance、available_balance和overall_revenue的类型从long更改为StarsAmount。
模式
userFull#979d2376 flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true voice_messages_forbidden:flags.20?true translations_disabled:flags.23?true stories_pinned_available:flags.26?true blocked_my_stories_from:flags.27?true wallpaper_overridden:flags.28?true contact_require_premium:flags.29?true read_dates_private:flags.30?true flags2:# sponsored_enabled:flags2.7?true can_view_revenue:flags2.9?true bot_can_manage_emoji_status:flags2.10?true id:long about:flags.1?string settings:PeerSettings personal_photo:flags.21?Photo profile_photo:flags.2?Photo fallback_photo:flags.22?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int theme_emoticon:flags.15?string private_forward_name:flags.16?string bot_group_admin_rights:flags.17?ChatAdminRights bot_broadcast_admin_rights:flags.18?ChatAdminRights premium_gifts:flags.19?Vector<PremiumGiftOption> wallpaper:flags.24?WallPaper stories:flags.25?PeerStories business_work_hours:flags2.0?BusinessWorkHours business_location:flags2.1?BusinessLocation business_greeting_message:flags2.2?BusinessGreetingMessage business_away_message:flags2.3?BusinessAwayMessage business_intro:flags2.4?BusinessIntro birthday:flags2.5?Birthday personal_channel_id:flags2.6?long personal_channel_message:flags2.6?int stargifts_count:flags2.8?int starref_program:flags2.11?StarRefProgram = UserFull; starsTransaction#64dfc926 flags:# refund:flags.3?true pending:flags.4?true failed:flags.6?true gift:flags.10?true reaction:flags.11?true id:string stars:StarsAmount date:int peer:StarsTransactionPeer title:flags.0?string description:flags.1?string photo:flags.2?WebDocument transaction_date:flags.5?int transaction_url:flags.5?string bot_payload:flags.7?bytes msg_id:flags.8?int extended_media:flags.9?Vector<MessageMedia> subscription_period:flags.12?int giveaway_post_id:flags.13?int stargift:flags.14?StarGift floodskip_number:flags.15?int starref_commission_permille:flags.16?int starref_peer:flags.17?Peer starref_amount:flags.17?StarsAmount = StarsTransaction; payments.starsStatus#6c9ce8ed flags:# balance:StarsAmount subscriptions:flags.1?Vector<StarsSubscription> subscriptions_next_offset:flags.2?string subscriptions_missing_balance:flags.4?long history:flags.3?Vector<StarsTransaction> next_offset:flags.0?string chats:Vector<Chat> users:Vector<User> = payments.StarsStatus; updateStarsBalance#4e80a379 balance:StarsAmount = Update; starsRevenueStatus#febe5491 flags:# withdrawal_enabled:flags.0?true current_balance:StarsAmount available_balance:StarsAmount overall_revenue:StarsAmount next_withdrawal_at:flags.1?int = StarsRevenueStatus; starRefProgram#dd0c66f2 flags:# bot_id:long commission_permille:int duration_months:flags.0?int end_date:flags.1?int daily_revenue_per_user:flags.2?StarsAmount = StarRefProgram; connectedBotStarRef#19a13f71 flags:# revoked:flags.1?true url:string date:int bot_id:long commission_permille:int duration_months:flags.0?int participants:long revenue:long = ConnectedBotStarRef; payments.connectedStarRefBots#98d5ea1d count:int connected_bots:Vector<ConnectedBotStarRef> users:Vector<User> = payments.ConnectedStarRefBots; payments.suggestedStarRefBots#b4d5d859 flags:# count:int suggested_bots:Vector<StarRefProgram> users:Vector<User> next_offset:flags.0?string = payments.SuggestedStarRefBots; starsAmount#bbb6b4a3 amount:long nanos:int = StarsAmount; messages.foundStickersNotModified#6010c534 flags:# next_offset:flags.0?int = messages.FoundStickers; messages.foundStickers#82c9e290 flags:# next_offset:flags.0?int hash:long stickers:Vector<Document> = messages.FoundStickers; ---functions--- contacts.resolveUsername#725afbbc flags:# username:string referer:flags.0?string = contacts.ResolvedPeer; bots.getAdminedBots#b0711d83 = Vector<User>; bots.updateStarRefProgram#778b5ab3 flags:# bot:InputUser commission_permille:int duration_months:flags.0?int = StarRefProgram; payments.getConnectedStarRefBots#5869a553 flags:# peer:InputPeer offset_date:flags.2?int offset_link:flags.2?string limit:int = payments.ConnectedStarRefBots; payments.getConnectedStarRefBot#b7d998f0 peer:InputPeer bot:InputUser = payments.ConnectedStarRefBots; payments.getSuggestedStarRefBots#0d6b48f7 flags:# order_by_revenue:flags.0?true order_by_date:flags.1?true peer:InputPeer offset:string limit:int = payments.SuggestedStarRefBots; payments.connectStarRefBot#7ed5348a peer:InputPeer bot:InputUser = payments.ConnectedStarRefBots; payments.editConnectedStarRefBot#e4fca4a3 flags:# revoked:flags.0?true peer:InputPeer link:string = payments.ConnectedStarRefBots; messages.searchStickers#29b1c66a flags:# emojis:flags.0?true q:string emoticon:string lang_code:Vector<string> offset:int limit:int hash:long = messages.FoundStickers;
第194层
- 机器人订阅功能改进 »
- 搜索功能改进 »
架构变更
改变方法
- messages.searchGlobal中添加了groups_only和users_only参数
- 移除invoice_slug参数,并将payments.botCancelStarsSubscription中的charge_id类型从flags.2?string更改为string
已更改的构造函数
- 在messageActionPaymentSentMe中添加subscription_until_date参数
- 在messageActionPaymentSent中添加了subscription_until_date参数
模式
messageActionPaymentSentMe#ffa00ccc flags:# recurring_init:flags.2?true recurring_used:flags.3?true currency:string total_amount:long payload:bytes info:flags.0?PaymentRequestedInfo shipping_option_id:flags.1?string charge:PaymentCharge subscription_until_date:flags.4?int = MessageAction; messageActionPaymentSent#c624b16e flags:# recurring_init:flags.2?true recurring_used:flags.3?true currency:string total_amount:long invoice_slug:flags.0?string subscription_until_date:flags.4?int = MessageAction; ---functions--- messages.searchGlobal#4bc6589a flags:# broadcasts_only:flags.1?true groups_only:flags.2?true users_only:flags.3?true folder_id:flags.0?int q:string filter:MessagesFilter min_date:int max_date:int offset_rate:int offset_peer:InputPeer offset_id:int limit:int = messages.Messages; payments.botCancelStarsSubscription#6dfa0622 flags:# restore:flags.0?true user_id:InputUser charge_id:string = Bool;
第193层
本层引入了以下新功能,主要与小程序 2.0相关:
- 来自小程序的预置内联消息 »
- 通过机器人/小程序设置用户的表情符号状态
- 小程序文件下载 »
- 通过小程序分享故事 »
-
机器人订阅 »
- 现在可以通过业务连接调用payments.exportInvoice来为业务机器人生成订阅发票链接。
-
全屏小应用
- fullscreen已向webViewResultUrl添加参数,允许默认以全屏模式打开应用程序(可通过 botfather 编辑,也可通过fullscreen在 requestWebView 方法中设置标志来启用)。
- 主小程序链接和直接小程序链接mode的参数现在支持模式,该模式会强制在 requestWebView 方法中设置标志。fullscreenfullscreen
- 添加了web_app_request_fullscreen方法,用于在小程序中请求全屏模式
- 来自机器人的礼物、礼物隐私设置和生日主题礼物 »
- 自定义迷你应用加载界面 »
- 为小程序添加加速计追踪功能 »
- 陀螺仪追踪在小程序中的应用 »
- 迷你应用设备方向跟踪 »
- 小程序方向锁定 »
- 为小程序提供地理位置支持 »
- 小程序可见性追踪 »
- 将小程序添加到主屏幕 »
- 微型应用可用于获取当前内容定义和系统定义安全区域的方法
- 允许自定义小程序中的垂直滑动行为 »
- 小程序辅助按钮 »
- 为迷你应用的主按钮添加闪耀效果支持,新增 has_shine_effect 标志 »
- 更多迷你应用主题选项,包括自定义底部栏颜色 »
-
force_request为web_app_open_tg_link 方法添加了一个参数»:如果设置且为 true,客户端必须忽略深度链接的任何本地缓存信息(主要用于刷新贴纸集链接的缓存信息 »)。
此外,现在调用该方法时不得关闭 Web 应用程序(无论该参数的值如何force_request)。
新增以下网络活动:
- web_app_setup_swipe_behavior »
- web_app_set_bottom_bar_color »
- web_app_setup_secondary_button »
- web_app_share_to_story »
- web_app_request_fullscreen »
- web_app_exit_fullscreen »
- web_app_start_gyroscope »
- web_app_停止陀螺仪 »
- web_app_start_device_orientation »
- web_app_stop_device_orientation »
- web_app_add_to_home_screen »
- web_app_check_home_screen »
- web_app_set_emoji_status »
- web_app_request_emoji_status_access »
- web_app_request_safe_area »
- web_app_request_content_safe_area »
- web_app_check_location »
- web_app_request_location »
- web_app_open_location_settings »
- web_app_request_file_download »
- web_app_send_prepared_message »
- web_app_toggle_orientation_lock »
新增以下小程序活动:
- 可见性已更改 »
- secondary_button_pressed »
- 全屏已更改 »
- 全屏失败 »
- 加速度计已启动 »
- 加速度计故障 »
- 加速度计已停止 »
- 加速度计已更改 »
- 陀螺仪已启动 »
- 陀螺仪故障 »
- 陀螺仪已停止 »
- 陀螺仪已更改 »
- 设备方向已启动 »
- 设备方向失败 »
- 设备方向已停止 »
- 设备方向已更改 »
- 主屏幕已添加 »
- 主屏幕故障 »
- 主屏幕已选中 »
- emoji_status_failed »
- emoji_status_set »
- emoji_status_access_requested »
- 文件下载请求 »
- 准备消息失败 »
- 已准备好的消息已发送 »
- 安全区域已更改 »
- 内容安全区域已更改 »
- 请求位置 »
- 位置已检查 »
架构变更
新方法
- 新增messages.savePreparedInlineMessage- 保存预先准备好的内联消息,以便小程序用户通过web_app_send_prepared_message 事件分享该消息。
- 新增messages.getPreparedInlineMessage- 获取由小程序生成的预置内联消息:在处理web_app_send_prepared_message 事件时调用
- 新增bots.updateUserEmojiStatus- 更改用户的表情符号状态(由机器人调用,点击此处»查看完整流程的更多信息)
- 新增bots.toggleUserEmojiStatusPermission- 允许或阻止机器人更改我们的表情符号状态 »
- 新增bots.checkDownloadFileParams- 检查小程序是否可以请求下载特定文件:在处理web_app_request_file_download 事件时调用 »
- 新增payments.botCancelStarsSubscription- 取消机器人订阅
改变方法
- messages.requestWebView中添加了全屏参数
- messages.requestSimpleWebView中添加了全屏参数
- messages.requestAppWebView中添加了全屏参数
- messages.requestMainWebView中添加了全屏参数
新建筑商
- 新增输入项 PrivacyKeyStarGiftsAutoSave- 是否将收到的礼物自动显示在我们的个人资料中
- 新增隐私设置KeyStarGiftsAutoSave- 是否将收到的礼物自动显示在我们的个人资料中
- 新增输入 PrivacyValueAllowBots- 允许机器人和小程序
- 新增输入 PrivacyValueDisallowBots- 禁止机器人和小程序
- 新增privacyValueAllowBots- 允许机器人和小程序
- 新增privacyValueDisallowBots- 禁止机器人和小程序
- 新增messages.botPreparedInlineMessage- 表示机器人已准备好的内联消息,该消息将通过 Web 应用发送给用户 »
- 新增messages.preparedInlineMessage- 表示通过机器人小程序接收的已准备好的内联消息,可以发送到某些聊天窗口 »
- 新增botAppSettings-小程序 »设置
已更改的构造函数
- 将messageActionStarGift中的 convert_stars类型从long更改为flags.4?long
- 在userFull中添加bot_can_manage_emoji_status参数
- 在botInfo中添加app_settings参数
- 在发票中添加了subscription_period参数
- 在webViewResultUrl中添加了全屏参数
- 在starsSubscription中添加了bot_canceled、title、photo和invoice_slug参数
- starGift中添加了生日参数
模式
messageActionStarGift#08557637 flags:# name_hidden:flags.0?true saved:flags.2?true converted:flags.3?true gift:StarGift message:flags.1?TextWithEntities convert_stars:flags.4?long = MessageAction; userFull#1f58e369 flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true voice_messages_forbidden:flags.20?true translations_disabled:flags.23?true stories_pinned_available:flags.26?true blocked_my_stories_from:flags.27?true wallpaper_overridden:flags.28?true contact_require_premium:flags.29?true read_dates_private:flags.30?true flags2:# sponsored_enabled:flags2.7?true can_view_revenue:flags2.9?true bot_can_manage_emoji_status:flags2.10?true id:long about:flags.1?string settings:PeerSettings personal_photo:flags.21?Photo profile_photo:flags.2?Photo fallback_photo:flags.22?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int theme_emoticon:flags.15?string private_forward_name:flags.16?string bot_group_admin_rights:flags.17?ChatAdminRights bot_broadcast_admin_rights:flags.18?ChatAdminRights premium_gifts:flags.19?Vector<PremiumGiftOption> wallpaper:flags.24?WallPaper stories:flags.25?PeerStories business_work_hours:flags2.0?BusinessWorkHours business_location:flags2.1?BusinessLocation business_greeting_message:flags2.2?BusinessGreetingMessage business_away_message:flags2.3?BusinessAwayMessage business_intro:flags2.4?BusinessIntro birthday:flags2.5?Birthday personal_channel_id:flags2.6?long personal_channel_message:flags2.6?int stargifts_count:flags2.8?int = UserFull; inputPrivacyKeyStarGiftsAutoSave#e1732341 = InputPrivacyKey; privacyKeyStarGiftsAutoSave#2ca4fdf8 = PrivacyKey; inputPrivacyValueAllowBots#5a4fcce5 = InputPrivacyRule; inputPrivacyValueDisallowBots#c4e57915 = InputPrivacyRule; privacyValueAllowBots#21461b5d = PrivacyRule; privacyValueDisallowBots#f6a5f82f = PrivacyRule; botInfo#36607333 flags:# has_preview_medias:flags.6?true user_id:flags.0?long description:flags.1?string description_photo:flags.4?Photo description_document:flags.5?Document commands:flags.2?Vector<BotCommand> menu_button:flags.3?BotMenuButton privacy_policy_url:flags.7?string app_settings:flags.8?BotAppSettings = BotInfo; invoice#049ee584 flags:# test:flags.0?true name_requested:flags.1?true phone_requested:flags.2?true email_requested:flags.3?true shipping_address_requested:flags.4?true flexible:flags.5?true phone_to_provider:flags.6?true email_to_provider:flags.7?true recurring:flags.9?true currency:string prices:Vector<LabeledPrice> max_tip_amount:flags.8?long suggested_tip_amounts:flags.8?Vector<long> terms_url:flags.10?string subscription_period:flags.11?int = Invoice; webViewResultUrl#4d22ff98 flags:# fullsize:flags.1?true fullscreen:flags.2?true query_id:flags.0?long url:string = WebViewResult; starsSubscription#2e6eab1a flags:# canceled:flags.0?true can_refulfill:flags.1?true missing_balance:flags.2?true bot_canceled:flags.7?true id:string peer:Peer until_date:int pricing:StarsSubscriptionPricing chat_invite_hash:flags.3?string title:flags.4?string photo:flags.5?WebDocument invoice_slug:flags.6?string = StarsSubscription; starGift#49c577cd flags:# limited:flags.0?true sold_out:flags.1?true birthday:flags.2?true id:long sticker:Document stars:long availability_remains:flags.0?int availability_total:flags.0?int convert_stars:long first_sale_date:flags.1?int last_sale_date:flags.1?int = StarGift; messages.botPreparedInlineMessage#8ecf0511 id:string expire_date:int = messages.BotPreparedInlineMessage; messages.preparedInlineMessage#ff57708d query_id:long result:BotInlineResult peer_types:Vector<InlineQueryPeerType> cache_time:int users:Vector<User> = messages.PreparedInlineMessage; botAppSettings#c99b1950 flags:# placeholder_path:flags.0?bytes background_color:flags.1?int background_dark_color:flags.2?int header_color:flags.3?int header_dark_color:flags.4?int = BotAppSettings; ---functions--- messages.requestWebView#269dc2c1 flags:# from_bot_menu:flags.4?true silent:flags.5?true compact:flags.7?true fullscreen:flags.8?true peer:InputPeer bot:InputUser url:flags.1?string start_param:flags.3?string theme_params:flags.2?DataJSON platform:string reply_to:flags.0?InputReplyTo send_as:flags.13?InputPeer = WebViewResult; messages.requestSimpleWebView#413a3e73 flags:# from_switch_webview:flags.1?true from_side_menu:flags.2?true compact:flags.7?true fullscreen:flags.8?true bot:InputUser url:flags.3?string start_param:flags.4?string theme_params:flags.0?DataJSON platform:string = WebViewResult; messages.requestAppWebView#53618bce flags:# write_allowed:flags.0?true compact:flags.7?true fullscreen:flags.8?true peer:InputPeer app:InputBotApp start_param:flags.1?string theme_params:flags.2?DataJSON platform:string = WebViewResult; messages.requestMainWebView#c9e01e7b flags:# compact:flags.7?true fullscreen:flags.8?true peer:InputPeer bot:InputUser start_param:flags.1?string theme_params:flags.0?DataJSON platform:string = WebViewResult; messages.savePreparedInlineMessage#f21f7f2f flags:# result:InputBotInlineResult user_id:InputUser peer_types:flags.0?Vector<InlineQueryPeerType> = messages.BotPreparedInlineMessage; messages.getPreparedInlineMessage#857ebdb8 bot:InputUser id:string = messages.PreparedInlineMessage; bots.updateUserEmojiStatus#ed9f30c5 user_id:InputUser emoji_status:EmojiStatus = Bool; bots.toggleUserEmojiStatusPermission#06de6392 bot:InputUser enabled:Bool = Bool; bots.checkDownloadFileParams#50077589 bot:InputUser file_name:string url:string = Bool; payments.botCancelStarsSubscription#57f9ece6 flags:# restore:flags.0?true user_id:InputUser invoice_slug:flags.1?string charge_id:flags.2?string = Bool;
第 192 层
此层引入了以下新功能:
- 通过新标志支持机器人付费广播allow_paid_floodskip。
- 机器人广告
- 使用stories.searchPosts时,允许筛选出仅由特定用户发送的故事。
- 礼物附言及其他礼物改进
- 由于使用了updateDeleteScheduledMessages标志,已发送的定时消息(包括从转换队列发送的视频)的更新得以实现。sent_messages
架构变更
新方法
- 新增messages.viewSponsoredMessage- 将特定赞助消息标记为已读
- 添加了messages.clickSponsoredMessage- 通知服务器用户已通过此处列出的方式之一与赞助消息进行了交互 »。
- 新增messages.reportSponsoredMessage- 举报赞助消息 »,请点击此处 »查看完整流程的更多信息。
- 新增messages.getSponsoredMessages - 获取同伴的赞助消息列表,点击此处»了解更多信息。
改变方法
- messages.sendMessage中添加了allow_paid_floodskip参数。
- messages.sendMedia中添加了allow_paid_floodskip参数
- messages.forwardMessages中添加了allow_paid_floodskip参数。
- messages.sendMultiMedia中添加了allow_paid_floodskip参数
- 在stats.getBroadcastRevenueStats中添加了peer参数,移除了channel参数。
- 在stats.getBroadcastRevenueWithdrawalUrl中添加了peer参数,移除了channel参数。
- 在stats.getBroadcastRevenueTransactions中添加了peer参数,移除了channel参数。
- 在stories.searchPosts中添加了peer参数。
已删除的方法
- 已移除频道。查看赞助消息
- 已移除频道.getSponsoredMessages
- 已移除频道。点击赞助消息
- 已移除频道。举报赞助消息
新建筑商
- 添加了starsTransactionPeerAPI- 描述了Telegram Star交易,用于支付付费 API 使用费用,例如付费机器人广播。
已更改的构造函数
- 在userFull中添加了can_view_revenue参数
- 在updateDeleteScheduledMessages中添加了flags和sent_messages参数
- 在messageActionGiftPremium中添加了message参数
- 在inputStorePaymentPremiumGiftCode中添加了message参数
- 在messageActionGiftCode中添加了message参数
- 在starsTransaction中添加floodskip_number参数
- starGift中添加了sold_out、first_sale_date和last_sale_date参数
模式
userFull#1f58e369 flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true voice_messages_forbidden:flags.20?true translations_disabled:flags.23?true stories_pinned_available:flags.26?true blocked_my_stories_from:flags.27?true wallpaper_overridden:flags.28?true contact_require_premium:flags.29?true read_dates_private:flags.30?true flags2:# sponsored_enabled:flags2.7?true can_view_revenue:flags2.9?true id:long about:flags.1?string settings:PeerSettings personal_photo:flags.21?Photo profile_photo:flags.2?Photo fallback_photo:flags.22?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int theme_emoticon:flags.15?string private_forward_name:flags.16?string bot_group_admin_rights:flags.17?ChatAdminRights bot_broadcast_admin_rights:flags.18?ChatAdminRights premium_gifts:flags.19?Vector<PremiumGiftOption> wallpaper:flags.24?WallPaper stories:flags.25?PeerStories business_work_hours:flags2.0?BusinessWorkHours business_location:flags2.1?BusinessLocation business_greeting_message:flags2.2?BusinessGreetingMessage business_away_message:flags2.3?BusinessAwayMessage business_intro:flags2.4?BusinessIntro birthday:flags2.5?Birthday personal_channel_id:flags2.6?long personal_channel_message:flags2.6?int stargifts_count:flags2.8?int = UserFull; updateDeleteScheduledMessages#f2a71983 flags:# peer:Peer messages:Vector<int> sent_messages:flags.0?Vector<int> = Update; messageActionGiftPremium#6c6274fa flags:# currency:string amount:long months:int crypto_currency:flags.0?string crypto_amount:flags.0?long message:flags.1?TextWithEntities = MessageAction; inputStorePaymentPremiumGiftCode#fb790393 flags:# users:Vector<InputUser> boost_peer:flags.0?InputPeer currency:string amount:long message:flags.1?TextWithEntities = InputStorePaymentPurpose; messageActionGiftCode#56d03994 flags:# via_giveaway:flags.0?true unclaimed:flags.2?true boost_peer:flags.1?Peer months:int slug:string currency:flags.2?string amount:flags.2?long crypto_currency:flags.3?string crypto_amount:flags.3?long message:flags.4?TextWithEntities = MessageAction; starsTransaction#35d4f276 flags:# refund:flags.3?true pending:flags.4?true failed:flags.6?true gift:flags.10?true reaction:flags.11?true id:string stars:long date:int peer:StarsTransactionPeer title:flags.0?string description:flags.1?string photo:flags.2?WebDocument transaction_date:flags.5?int transaction_url:flags.5?string bot_payload:flags.7?bytes msg_id:flags.8?int extended_media:flags.9?Vector<MessageMedia> subscription_period:flags.12?int giveaway_post_id:flags.13?int stargift:flags.14?StarGift floodskip_number:flags.15?int = StarsTransaction; starGift#49c577cd flags:# limited:flags.0?true sold_out:flags.1?true id:long sticker:Document stars:long availability_remains:flags.0?int availability_total:flags.0?int convert_stars:long first_sale_date:flags.1?int last_sale_date:flags.1?int = StarGift; starsTransactionPeerAPI#f9677aad = StarsTransactionPeer; ---functions--- messages.sendMessage#983f9745 flags:# no_webpage:flags.1?true silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true invert_media:flags.16?true allow_paid_floodskip:flags.19?true peer:InputPeer reply_to:flags.0?InputReplyTo message:string random_id:long reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut effect:flags.18?long = Updates; messages.sendMedia#7852834e flags:# silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true invert_media:flags.16?true allow_paid_floodskip:flags.19?true peer:InputPeer reply_to:flags.0?InputReplyTo media:InputMedia message:string random_id:long reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut effect:flags.18?long = Updates; messages.forwardMessages#d5039208 flags:# silent:flags.5?true background:flags.6?true with_my_score:flags.8?true drop_author:flags.11?true drop_media_captions:flags.12?true noforwards:flags.14?true allow_paid_floodskip:flags.19?true from_peer:InputPeer id:Vector<int> random_id:Vector<long> to_peer:InputPeer top_msg_id:flags.9?int schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut = Updates; messages.sendMultiMedia#37b74355 flags:# silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true invert_media:flags.16?true allow_paid_floodskip:flags.19?true peer:InputPeer reply_to:flags.0?InputReplyTo multi_media:Vector<InputSingleMedia> schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut effect:flags.18?long = Updates; stats.getBroadcastRevenueStats#f788ee19 flags:# dark:flags.0?true peer:InputPeer = stats.BroadcastRevenueStats; stats.getBroadcastRevenueWithdrawalUrl#9df4faad peer:InputPeer password:InputCheckPasswordSRP = stats.BroadcastRevenueWithdrawalUrl; stats.getBroadcastRevenueTransactions#70990b6d peer:InputPeer offset:int limit:int = stats.BroadcastRevenueTransactions; stories.searchPosts#d1810907 flags:# hashtag:flags.0?string area:flags.1?MediaArea peer:flags.2?InputPeer offset:string limit:int = stories.FoundStories; messages.viewSponsoredMessage#673ad8f1 peer:InputPeer random_id:bytes = Bool; messages.clickSponsoredMessage#0f093465 flags:# media:flags.0?true fullscreen:flags.1?true peer:InputPeer random_id:bytes = Bool; messages.reportSponsoredMessage#1af3dbb8 peer:InputPeer random_id:bytes option:bytes = channels.SponsoredMessageReportResult; messages.getSponsoredMessages#9bd2f439 peer:InputPeer = messages.SponsoredMessages;
第189层
此层增加了对以下功能的支持:
- 自动转换上传的视频 »
- 礼物 ”
- 剪贴板按钮 »
- 赞助商信息改进 »
- 改进报告流程 »
新增了以下配置项:
- stargifts_message_length_max »
- stargifts_blocked »
- stargifts_convert_period_max »
- video_ignore_alt_documents »
- sponsored_links_inapp_allow »
架构变更
新方法
- 新增付款方式。getStarGifts- 获取可用礼品列表,点击此处»了解更多信息。
- 已添加payments.getUserStarGifts
- 添加了payments.saveStarGift- 显示或从我们的个人资料中移除已收到的礼物 »
- 新增payments.convertStarGift -将收到的礼物转换为 Telegram Stars:此操作将永久销毁礼物,并将其转换为starGift。Telegramconvert_starsStars将添加到用户的余额中。
改变方法
- 将messages.report的类型从Bool更改为ReportResult
- messages.report中新增了option参数,移除了reason参数。
- 在channels.clickSponsoredMessage中添加了flags、media和fullscreen参数。
- 已将stories.report的类型从Bool更改为ReportResult。
- stories.report中新增了option参数,移除了reason参数。
- 已移除payments.sendStarsForm中的flags参数
新建筑商
- 添加了keyboardButtonCopy- 剪贴板按钮:单击时,必须将附加的文本复制到剪贴板。
- 新增starGift- 代表一份星光礼物,点击此处 »了解更多信息。
- 已添加payments.starGiftsNotModified - 可用礼物列表»未更改。
- 新增付款方式。starGifts- 可用礼品 »。
- 添加了inputInvoiceStarGift- 用于购买Telegram 星星礼物,点击此处 »查看更多信息。
- 添加了payments.paymentFormStarGift- 表示礼品的付款表单,请点击此处»了解更多信息。
- 添加消息 ActionStarGift- 您收到了一份礼物,请点击此处 »查看更多信息。
- 添加用户StarGift
- 已添加付款方式。userStarGifts
- 新增messageReportOption- 报表菜单选项
- 添加了reportResultChooseOption-用户必须选择以下选项之一,然后必须重新调用messages.reportoption,并将该选项的标识符传递给messages.report。option
- 添加了reportResultAddComment- 用户应输入给版主的附加评论,然后必须重新调用messages.report ,并将评论传递给messages.report。message
- 添加了reportResultReported- 报告已成功发送,无需进行其他操作。
已更改的构造函数
- 在消息中添加video_processing_pending参数
- 在userFull中添加stargifts_count参数
- 在messageMediaDocument中添加了alt_documents参数,移除了alt_document参数。
- 在documentAttributeVideo中添加了video_codec参数
- 在starsTransaction中添加stargift参数
推送通知变更
新的推送通知
- 添加了MESSAGE_STARGIFT-{1} sent you a Gift worth {2} Stars
模式
message#94345242 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true post:flags.14?true from_scheduled:flags.18?true legacy:flags.19?true edit_hide:flags.21?true pinned:flags.24?true noforwards:flags.26?true invert_media:flags.27?true flags2:# offline:flags2.1?true video_processing_pending:flags2.4?true id:int from_id:flags.8?Peer from_boosts_applied:flags.29?int peer_id:Peer saved_peer_id:flags.28?Peer fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long via_business_bot_id:flags2.0?long reply_to:flags.3?MessageReplyHeader date:int message:string media:flags.9?MessageMedia reply_markup:flags.6?ReplyMarkup entities:flags.7?Vector<MessageEntity> views:flags.10?int forwards:flags.10?int replies:flags.23?MessageReplies edit_date:flags.15?int post_author:flags.16?string grouped_id:flags.17?long reactions:flags.20?MessageReactions restriction_reason:flags.22?Vector<RestrictionReason> ttl_period:flags.25?int quick_reply_shortcut_id:flags.30?int effect:flags2.2?long factcheck:flags2.3?FactCheck = Message; userFull#1f58e369 flags:# blocked:flags.0?true phone_calls_available:flags.4?true phone_calls_private:flags.5?true can_pin_message:flags.7?true has_scheduled:flags.12?true video_calls_available:flags.13?true voice_messages_forbidden:flags.20?true translations_disabled:flags.23?true stories_pinned_available:flags.26?true blocked_my_stories_from:flags.27?true wallpaper_overridden:flags.28?true contact_require_premium:flags.29?true read_dates_private:flags.30?true flags2:# sponsored_enabled:flags2.7?true id:long about:flags.1?string settings:PeerSettings personal_photo:flags.21?Photo profile_photo:flags.2?Photo fallback_photo:flags.22?Photo notify_settings:PeerNotifySettings bot_info:flags.3?BotInfo pinned_msg_id:flags.6?int common_chats_count:int folder_id:flags.11?int ttl_period:flags.14?int theme_emoticon:flags.15?string private_forward_name:flags.16?string bot_group_admin_rights:flags.17?ChatAdminRights bot_broadcast_admin_rights:flags.18?ChatAdminRights premium_gifts:flags.19?Vector<PremiumGiftOption> wallpaper:flags.24?WallPaper stories:flags.25?PeerStories business_work_hours:flags2.0?BusinessWorkHours business_location:flags2.1?BusinessLocation business_greeting_message:flags2.2?BusinessGreetingMessage business_away_message:flags2.3?BusinessAwayMessage business_intro:flags2.4?BusinessIntro birthday:flags2.5?Birthday personal_channel_id:flags2.6?long personal_channel_message:flags2.6?int stargifts_count:flags2.8?int = UserFull; messageMediaDocument#dd570bd5 flags:# nopremium:flags.3?true spoiler:flags.4?true video:flags.6?true round:flags.7?true voice:flags.8?true document:flags.0?Document alt_documents:flags.5?Vector<Document> ttl_seconds:flags.2?int = MessageMedia; documentAttributeVideo#43c57c48 flags:# round_message:flags.0?true supports_streaming:flags.1?true nosound:flags.3?true duration:double w:int h:int preload_prefix_size:flags.2?int video_start_ts:flags.4?double video_codec:flags.5?string = DocumentAttribute; starsTransaction#0a9ee4c2 flags:# refund:flags.3?true pending:flags.4?true failed:flags.6?true gift:flags.10?true reaction:flags.11?true id:string stars:long date:int peer:StarsTransactionPeer title:flags.0?string description:flags.1?string photo:flags.2?WebDocument transaction_date:flags.5?int transaction_url:flags.5?string bot_payload:flags.7?bytes msg_id:flags.8?int extended_media:flags.9?Vector<MessageMedia> subscription_period:flags.12?int giveaway_post_id:flags.13?int stargift:flags.14?StarGift = StarsTransaction; keyboardButtonCopy#75d2698e text:string copy_text:string = KeyboardButton; starGift#aea174ee flags:# limited:flags.0?true id:long sticker:Document stars:long availability_remains:flags.0?int availability_total:flags.0?int convert_stars:long = StarGift; payments.starGiftsNotModified#a388a368 = payments.StarGifts; payments.starGifts#901689ea hash:int gifts:Vector<StarGift> = payments.StarGifts; inputInvoiceStarGift#25d8c1d8 flags:# hide_name:flags.0?true user_id:InputUser gift_id:long message:flags.1?TextWithEntities = InputInvoice; payments.paymentFormStarGift#b425cfe1 form_id:long invoice:Invoice = payments.PaymentForm; messageActionStarGift#9bb3ef44 flags:# name_hidden:flags.0?true saved:flags.2?true converted:flags.3?true gift:StarGift message:flags.1?TextWithEntities convert_stars:long = MessageAction; userStarGift#eea49a6e flags:# name_hidden:flags.0?true unsaved:flags.5?true from_id:flags.1?long date:int gift:StarGift message:flags.2?TextWithEntities msg_id:flags.3?int convert_stars:flags.4?long = UserStarGift; payments.userStarGifts#6b65b517 flags:# count:int gifts:Vector<UserStarGift> next_offset:flags.0?string users:Vector<User> = payments.UserStarGifts; messageReportOption#7903e3d9 text:string option:bytes = MessageReportOption; reportResultChooseOption#f0e4e0b6 title:string options:Vector<MessageReportOption> = ReportResult; reportResultAddComment#6f09ac31 flags:# optional:flags.0?true option:bytes = ReportResult; reportResultReported#8db33c4b = ReportResult; ---functions--- messages.report#fc78af9b peer:InputPeer id:Vector<int> option:bytes message:string = ReportResult; channels.clickSponsoredMessage#01445d75 flags:# media:flags.0?true fullscreen:flags.1?true channel:InputChannel random_id:bytes = Bool; stories.report#19d8eb45 peer:InputPeer id:Vector<int> option:bytes message:string = ReportResult; payments.sendStarsForm#7998c914 form_id:long invoice:InputInvoice = payments.PaymentResult; payments.getStarGifts#c4563590 hash:int = payments.StarGifts; payments.getUserStarGifts#5e72c7e1 user_id:InputUser offset:string limit:int = payments.UserStarGifts; payments.saveStarGift#87acf08e flags:# unsave:flags.0?true user_id:InputUser msg_id:int = Bool; payments.convertStarGift#0421e027 user_id:InputUser msg_id:int = Bool;第187层
此层增加了对以下功能的支持:
- 明星赠品 »
- 付费反应隐私设置 »
- 面向机器人的付费媒体 »
- 改进星级订阅服务 »
架构变更
新方法
- 添加了payments.getStarsGiveawayOptions - 获取星星赠送选项列表»。
- 添加了messages.getPaidReactionPrivacy- 获取包含当前默认付费反应隐私设置的updatePaidReactionPrivacy更新,请点击此处 »了解更多信息。
改变方法
- 在messages.sendPaidReaction中,将private类型从flags.0?true更改为flags.0?Bool。
新建筑商
- 添加了updateBotPurchasedPaidMedia- 仅限机器人:用户已购买付费媒体。
- 添加了channelAdminLogEventActionParticipantSubExtend- 付费订阅者已延长其Telegram Star 订阅 »。
- 添加了inputStorePaymentStarsGiveaway- 用于支付星星赠送活动的费用,请点击此处»了解更多信息。
- 添加消息 ActionPrizeStars- 您在Telegram Star 赠送活动中赢得了一些Telegram Star» 。
- 添加了updatePaidReactionPrivacy- 包含当前默认的付费表情隐私设置,点击此处»了解更多信息。
- 新增starsGiveawayOption- 包含有关Telegram 星星赠送选项的信息。
- 添加了starsGiveawayWinnersOption- 允许设置赠品获奖者人数的选项。
- 新增prepaidStarsGiveaway - 包含有关预付费 Telegram 星星赠送活动的信息»。
已更改的构造函数
- 在channelAdminLogEventsFilter中添加了sub_extend参数
- 添加了stars参数,并将messageMediaGiveaway中的months类型从int更改为flags.4?int
- 在messageActionGiveawayLaunch中添加了flags和stars参数
- 在payments.giveawayInfoResults中添加了stars_prize参数,将gift_code_slug的类型从flags.0?string更改为flags.3?string,将 activated_count 的类型从int更改为flags.2?int。
- 在boost中添加了stars参数
- 在messageActionGiveawayResults中添加了flags和stars参数
- 添加了stars参数,并将messageMediaGiveawayResults中的months类型从int更改为flags.4?int
- 在broadcastRevenueBalances中添加了flags和withdraw_enabled参数
- 在starsTransaction中添加了giveaway_post_id参数。
- 在inputMediaPaidMedia中添加了标志和有效负载参数
推送通知变更
新的推送通知
- 添加了CHANNEL_MESSAGE_GIVEAWAY_STARS-{1} posted a giveaway of {3} stars {2}
- 添加了CHAT_MESSAGE_GIVEAWAY_STARS-{1} sent a giveaway of {4} stars {3} to the group {2}
- 添加了MESSAGE_GIVEAWAY_STARS-{1} sent you a giveaway of {3} stars {2}
模式
channelAdminLogEventsFilter#ea107ae4 flags:# join:flags.0?true leave:flags.1?true invite:flags.2?true ban:flags.3?true unban:flags.4?true kick:flags.5?true unkick:flags.6?true promote:flags.7?true demote:flags.8?true info:flags.9?true settings:flags.10?true pinned:flags.11?true edit:flags.12?true delete:flags.13?true group_call:flags.14?true invites:flags.15?true send:flags.16?true forums:flags.17?true sub_extend:flags.18?true = ChannelAdminLogEventsFilter; messageMediaGiveaway#aa073beb flags:# only_new_subscribers:flags.0?true winners_are_visible:flags.2?true channels:Vector<long> countries_iso2:flags.1?Vector<string> prize_description:flags.3?string quantity:int months:flags.4?int stars:flags.5?long until_date:int = MessageMedia; messageActionGiveawayLaunch#a80f51e4 flags:# stars:flags.0?long = MessageAction; payments.giveawayInfoResults#e175e66f flags:# winner:flags.0?true refunded:flags.1?true start_date:int gift_code_slug:flags.3?string stars_prize:flags.4?long finish_date:int winners_count:int activated_count:flags.2?int = payments.GiveawayInfo; boost#4b3e14d6 flags:# gift:flags.1?true giveaway:flags.2?true unclaimed:flags.3?true id:string user_id:flags.0?long giveaway_msg_id:flags.2?int date:int expires:int used_gift_slug:flags.4?string multiplier:flags.5?int stars:flags.6?long = Boost; messageActionGiveawayResults#87e2f155 flags:# stars:flags.0?true winners_count:int unclaimed_count:int = MessageAction; messageMediaGiveawayResults#ceaa3ea1 flags:# only_new_subscribers:flags.0?true refunded:flags.2?true channel_id:long additional_peers_count:flags.3?int launch_msg_id:int winners_count:int unclaimed_count:int winners:Vector<long> months:flags.4?int stars:flags.5?long prize_description:flags.1?string until_date:int = MessageMedia; broadcastRevenueBalances#c3ff71e7 flags:# withdrawal_enabled:flags.0?true current_balance:long available_balance:long overall_revenue:long = BroadcastRevenueBalances; starsTransaction#ee7522d5 flags:# refund:flags.3?true pending:flags.4?true failed:flags.6?true gift:flags.10?true reaction:flags.11?true id:string stars:long date:int peer:StarsTransactionPeer title:flags.0?string description:flags.1?string photo:flags.2?WebDocument transaction_date:flags.5?int transaction_url:flags.5?string bot_payload:flags.7?bytes msg_id:flags.8?int extended_media:flags.9?Vector<MessageMedia> subscription_period:flags.12?int giveaway_post_id:flags.13?int = StarsTransaction; inputMediaPaidMedia#c4103386 flags:# stars_amount:long extended_media:Vector<InputMedia> payload:flags.0?string = InputMedia; updateBotPurchasedPaidMedia#283bd312 user_id:long payload:string qts:int = Update; channelAdminLogEventActionParticipantSubExtend#64642db3 prev_participant:ChannelParticipant new_participant:ChannelParticipant = ChannelAdminLogEventAction; inputStorePaymentStarsGiveaway#751f08fa flags:# only_new_subscribers:flags.0?true winners_are_visible:flags.3?true stars:long 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 users:int = InputStorePaymentPurpose; messageActionPrizeStars#b00c47a2 flags:# unclaimed:flags.0?true stars:long transaction_id:string boost_peer:Peer giveaway_msg_id:int = MessageAction; updatePaidReactionPrivacy#51ca7aec private:Bool = Update; starsGiveawayOption#94ce852a flags:# extended:flags.0?true default:flags.1?true stars:long yearly_boosts:int store_product:flags.2?string currency:string amount:long winners:Vector<StarsGiveawayWinnersOption> = StarsGiveawayOption; starsGiveawayWinnersOption#54236209 flags:# default:flags.0?true users:int per_user_stars:long = StarsGiveawayWinnersOption; prepaidStarsGiveaway#9a9d77e0 id:long stars:long quantity:int boosts:int date:int = PrepaidGiveaway; ---functions--- messages.sendPaidReaction#9dd6a67b flags:# peer:InputPeer msg_id:int count:int random_id:long private:flags.0?Bool = Updates; payments.getStarsGiveawayOptions#bd1efd3e = Vector<StarsGiveawayOption>; messages.getPaidReactionPrivacy#472455aa = Updates;
第186层
此层增加了对以下功能的支持:
- Telegram Star 订阅 »
- 付费评论 »
-
超级频道 »
现在您可以发送与群组消息完全相同的频道消息,其中包含完整的发送者信息(以及与群组消息相同的用户界面):要切换此功能,请调用channels.toggleSignatures并signatures_enabled进行profiles_enabled设置。启用此模式后,管理员可以使用messages.sendMessage标志和其他消息发送方法,
以他们控制的任何配置文件(包括其他频道,以及用于匿名消息的频道本身,就像默认模式一样)向频道发布消息。新的频道标志是一个有效的最小字段。send_as
signature_profiles - 赞助信息中的媒体
- 通过botInfoprivacy_policy_url参数设置机器人的隐私政策。
新增了以下建议:
- STARS_SUBSCRIPTION_LOW_BALANCE »
新增了以下配置项:
- stars_subscription_amount_max »
- stars_usd_sell_rate_x1000 »
- stars_usd_withdraw_rate_x1000 »
- stars_paid_reaction_amount_max »
新增了以下深度链接:
- 星星充值链接 »