开发文档

Telegram 投票、测验与协作清单

了解投票选项身份、结果更新、清单项目和协作权限,避免将界面勾选误当作服务端已提交。

GetTGAPI 编辑团队更新于
文档解读核对日期

依据官方资料整理,由 GetTGAPI 独立维护。 文档目录与术语表 →

本页内容
  1. 投票选项有自己的标识
  2. 清单项目不能随意重新编号
  3. 交互建议

投票选项有自己的标识

投票、测验和开放答案投票有不同字段及行为。投票提交使用选项标识,不应仅传界面排序下标;后续还需处理结果更新。查看投票人和统计受匿名性及权限限制,Bot 也不拥有任意投票的全部数据。

清单项目不能随意重新编号

协作清单提供是否允许他人追加或完成项目等设置,项目 ID 在清单内必须唯一。编辑清单时保持未删除项目的身份,才能正确关联已有完成状态。创建资格和数量限制需要读取当前能力与配置。

交互建议

点击后可显示提交中,但先保留原结果,失败时恢复。多人编辑时避免用旧的整个列表覆盖新的项目。关闭投票、删除答案或清单项目等动作与“我取消自己的选择”应有明确不同的文案。