editSharedWidgetData
دادههای عمومی ویجت اشتراکی را ویرایش میکند (Bot API 10.4).
مقدار بازگشتی: در صورت موفقیت، True برمیگرداند.
پارامترها
| پارامتر | نوع | الزامی | توضیحات |
|---|---|---|---|
widget_id | String | بله | شناسه ویجت اشتراکی (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());
راهنمای گامبهگام: مثال ویجت تلگرام: کد کامل HTML و ربات پایتون
متدهای مرتبط
sendWidgetپیامی حاوی ویجت HTML ارسال میکند (Bot API 10.4).sendSharedWidgetویجت اشتراکی ساختهشده توسط ربات را دوباره ارسال میکند (Bot API 10.4).answerWidgetQueryبه کوئری ویجت پاسخ میدهد (Bot API 10.4).editMessageWidgetDataدادههای ویجت در پیام را ویرایش میکند (Bot API 10.4).