getChatGifts
متدهدیههای متعلق به یک گفتگو را برمی‌گرداند. در صورت موفقیت OwnedGifts برمی‌گرداند.
خروجی: OwnedGifts
پارامترها
| نام | نوع | الزام | توضیحات |
|---|---|---|---|
| chat_id | Integer or String | الزامی | شناسهٔ یکتای گفتگوی هدف یا نام‌کاربری کانال هدف با قالب @username |
| exclude_unsaved | Boolean | اختیاری | برای کنار گذاشتن هدیه‌هایی که در صفحهٔ پروفایل گفتگو ذخیره نشده‌اند، True بدهید. همیشه True است، مگر اینکه ربات در کانال دسترسی ادمین can_post_messages را داشته باشد. |
| exclude_saved | Boolean | اختیاری | برای کنار گذاشتن هدیه‌هایی که در صفحهٔ پروفایل گفتگو ذخیره شده‌اند، True بدهید. همیشه False است، مگر اینکه ربات در کانال دسترسی ادمین can_post_messages را داشته باشد. |
| exclude_unlimited | Boolean | اختیاری | برای کنار گذاشتن هدیه‌هایی که بی‌نهایت بار قابل خرید هستند، True بدهید. |
| exclude_limited_upgradable | Boolean | اختیاری | برای کنار گذاشتن هدیه‌هایی که تعداد محدودی بار قابل خرید هستند و می‌توان آن‌ها را به هدیهٔ یکتا ارتقا داد، True بدهید. |
| exclude_limited_non_upgradable | Boolean | اختیاری | برای کنار گذاشتن هدیه‌هایی که تعداد محدودی بار قابل خرید هستند و نمی‌توان آن‌ها را به هدیهٔ یکتا ارتقا داد، True بدهید. |
| exclude_from_blockchain | Boolean | اختیاری | برای کنار گذاشتن هدیه‌هایی که از بلاکچین TON تخصیص یافته‌اند و در تلگرام قابل فروش مجدد یا انتقال نیستند، True بدهید. |
| exclude_unique | Boolean | اختیاری | برای کنار گذاشتن هدیه‌های یکتا، True بدهید. |
| sort_by_price | Boolean | اختیاری | برای مرتب‌سازی نتایج بر اساس قیمت هدیه به‌جای تاریخ ارسال، True بدهید. مرتب‌سازی پیش از صفحه‌بندی اعمال می‌شود. |
| offset | String | اختیاری | offset اولین موردی که باید برگردانده شود، همان‌طور که از درخواست قبلی دریافت شده؛ برای گرفتن اولین دستهٔ نتایج رشتهٔ خالی بدهید. |
| limit | Integer | اختیاری | بیشترین تعداد هدیه‌ای که برگردانده می‌شود؛ ۱ تا ۱۰۰. پیش‌فرض ۱۰۰. |