getBusinessAccountGifts
هدیههای حساب تجاری را برمیگرداند.
مقدار بازگشتی: در صورت موفقیت، OwnedGifts برمیگرداند.
پارامترها
| پارامتر | نوع | الزامی | توضیحات |
|---|---|---|---|
business_connection_id | String | بله | شناسه اتصال تجاری |
exclude_unsaved | Boolean | اختیاری | مستثنا کردن هدیههایی که در صفحه پروفایل ذخیره نشدهاند |
exclude_saved | Boolean | اختیاری | مستثنا کردن هدیههایی که در صفحه پروفایل ذخیره شدهاند |
exclude_unlimited | Boolean | اختیاری | مستثنا کردن هدیههایی که تعداد خریدشان نامحدود است |
exclude_limited_upgradable | Boolean | اختیاری | مستثنا کردن هدیههای محدودی که قابل ارتقا به منحصربهفرد هستند |
exclude_limited_non_upgradable | Boolean | اختیاری | مستثنا کردن هدیههای محدودی که قابل ارتقا به منحصربهفرد نیستند |
exclude_unique | Boolean | اختیاری | مستثنا کردن هدیههای منحصربهفرد |
exclude_from_blockchain | Boolean | اختیاری | مستثنا کردن هدیههای منتقلشده از بلاکچین TON |
sort_by_price | Boolean | اختیاری | مرتبسازی بر اساس قیمت هدیه بهجای تاریخ ارسال |
offset | String | اختیاری | آفست صفحهبندی |
limit | Integer | اختیاری | تعداد (1-100) |
نمونه درخواست
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/getBusinessAccountGifts" \
-H "Content-Type: application/json" \
-d '{"business_connection_id":"BUSINESS_CONNECTION_ID"}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/getBusinessAccountGifts",
json={
"business_connection_id": "BUSINESS_CONNECTION_ID"
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/getBusinessAccountGifts`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"business_connection_id": "BUSINESS_CONNECTION_ID"
}),
});
console.log(await res.json());
راهنمای گامبهگام: ساخت ربات تلگرام: آموزش قدمبهقدم از BotFather تا اولین پیام با Python
متدهای مرتبط
getBusinessAccountStarBalanceموجودی Stars حساب تجاری را برمیگرداند.transferBusinessAccountStarsStars را از حساب تجاری به موجودی ربات منتقل میکند.readBusinessMessageپیام دریافتی را از طرف حساب تجاری خواندهشده علامت میزند.deleteBusinessMessagesپیامها را از طرف حساب تجاری حذف میکند.setBusinessAccountNameنام حساب تجاری را تنظیم میکند.setBusinessAccountUsernameنام کاربری حساب تجاری را تنظیم میکند.setBusinessAccountBioبیوی حساب تجاری را تنظیم میکند.setBusinessAccountProfilePhotoعکس پروفایل حساب تجاری را تنظیم میکند.removeBusinessAccountProfilePhotoعکس پروفایل حساب تجاری را حذف میکند.setBusinessAccountGiftSettingsتنظیمات هدیه حساب تجاری را پیکربندی میکند.