editSharedWidgetData
编辑共享小组件的公共数据 (Bot API 10.4)。
返回值: 调用成功时返回 True。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
widget_id | String | 是 | 共享小组件 ID(已发送消息中的 widget.id) |
public_data | String | 是 | 新的公共状态,0-1024 字节(空字符串 = 删除) |
cache_time | Integer | 可选 | 客户端刷新周期(秒,5-3600,默认 30) |
请求示例
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/editSharedWidgetData" \
-H "Content-Type: application/json" \
-d '{"widget_id":"WIDGET_ID","public_data":"{\"r\":1,\"votes\":[3,5]}"}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/editSharedWidgetData",
json={
"widget_id": "WIDGET_ID",
"public_data": "{\"r\":1,\"votes\":[3,5]}"
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/editSharedWidgetData`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"widget_id": "WIDGET_ID",
"public_data": "{\"r\":1,\"votes\":[3,5]}"
}),
});
console.log(await res.json());
分步教程: Telegram Widget 示例:完整的小组件 HTML 与 Python 机器人代码
相关方法
sendWidget发送带有 HTML 小组件的消息 (Bot API 10.4)。sendSharedWidget再次发送机器人创建的共享小组件 (Bot API 10.4)。answerWidgetQuery回应来自小组件的查询 (Bot API 10.4)。editMessageWidgetData编辑消息中小组件的数据 (Bot API 10.4)。