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