setGameScore
امتیاز بازی کاربر را تنظیم میکند.
مقدار بازگشتی: در صورت موفقیت، Message or True برمیگرداند.
پارامترها
| پارامتر | نوع | الزامی | توضیحات |
|---|---|---|---|
user_id | Integer | بله | شناسه کاربر |
score | Integer | بله | امتیاز جدید |
force | Boolean | اختیاری | جایگزینی امتیاز حتی اگر کمتر باشد |
disable_edit_message | Boolean | اختیاری | پیام ویرایش نشود، پیام جدید ارسال شود |
chat_id | Integer | اختیاری | شناسه چت (برای پیامهای غیراینلاین) |
message_id | Integer | اختیاری | شناسه پیام (برای پیامهای غیراینلاین) |
inline_message_id | String | اختیاری | شناسه پیام اینلاین |
نمونه درخواست
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/setGameScore" \
-H "Content-Type: application/json" \
-d '{"user_id":123456789,"score":100}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/setGameScore",
json={
"user_id": 123456789,
"score": 100
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/setGameScore`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"user_id": 123456789,
"score": 100
}),
});
console.log(await res.json());
راهنمای گامبهگام: ساخت ربات تلگرام: آموزش قدمبهقدم از BotFather تا اولین پیام با Python
متدهای مرتبط
sendGameبازی ارسال میکند.getGameHighScoresبالاترین امتیازهای بازی را برمیگرداند.