upgradeGift
متدهدیهٔ معمولی مشخصشده را به هدیهٔ یکتا ارتقا میدهد. نیازمند دسترسی ربات کسبوکار can_transfer_and_upgrade_gifts است. اگر ارتقا پولی باشد، علاوه بر آن نیازمند دسترسی ربات کسبوکار can_transfer_stars هم است. در صورت موفقیت True برمیگرداند.
خروجی: Boolean
پارامترها
| نام | نوع | الزام | توضیحات |
|---|---|---|---|
| business_connection_id | String | الزامی | شناسهٔ یکتای اتصال کسبوکار |
| owned_gift_id | String | الزامی | شناسهٔ یکتای هدیهٔ معمولی که باید به هدیهٔ یکتا ارتقا یابد. |
| keep_original_details | Boolean | اختیاری | برای حفظ متن اصلی هدیه، فرستنده و گیرنده در هدیهٔ ارتقایافته، True بدهید. |
| star_count | Integer | اختیاری | تعداد ستارهٔ تلگرامی که برای ارتقا از موجودی حساب کسبوکار پرداخت میشود. اگر gift.prepaid_upgrade_star_count > 0 باشد ۰ بدهید؛ در غیر این صورت دسترسی ربات کسبوکار can_transfer_stars لازم است و باید gift.upgrade_star_count داده شود. |