sendVideo
متداز این متد برای ارسال فایل‌های ویدیویی استفاده کنید؛ کلاینت‌های تلگرام از ویدیوهای MPEG4 پشتیبانی می‌کنند (سایر قالب‌ها ممکن است به‌عنوان سند فرستاده شوند). در صورت موفقیت، Message ارسال‌شده برگردانده می‌شود. در حال حاضر ربات‌ها می‌توانند فایل ویدیویی تا ۵۰ مگابایت بفرستند؛ ممکن است این محدودیت در آینده تغییر کند.
خروجی: Message
پارامترها
| نام | نوع | الزام | توضیحات |
|---|---|---|---|
| business_connection_id | String | اختیاری | شناسهٔ یکتای اتصال کسب‌وکاری که پیام از طرف آن فرستاده می‌شود. |
| chat_id | Integer or String | الزامی | شناسهٔ یکتای گفتگوی هدف یا نام‌کاربری ربات، ابرگروه یا کانال هدف با قالب @username |
| message_thread_id | Integer | اختیاری | شناسهٔ یکتای رشتهٔ پیام (تاپیک) فروم هدف؛ فقط برای ابرگروه‌های فروم و گفتگوهای خصوصی ربات‌هایی که حالت تاپیک فروم برایشان فعال است. |
| direct_messages_topic_id | Integer | اختیاری | شناسهٔ تاپیک پیام مستقیم که پیام به آن فرستاده می‌شود؛ اگر پیام به یک گفتگوی پیام مستقیم فرستاده شود الزامی است. |
| ephemeral_message_parameters | EphemeralMessageParameters | اختیاری | شیء سریالایز‌شده به JSON شامل پارامترهای پیام موقت (ephemeral) که باید فرستاده شود. |
| video | InputFile or String | الزامی | ویدیو برای ارسال. برای ارسال ویدیویی که روی سرورهای تلگرام وجود دارد، file_id را به‌صورت String بدهید (توصیه می‌شود)، برای اینکه تلگرام ویدیو را از اینترنت بگیرد آدرس HTTP را به‌صورت String بدهید، یا ویدیوی جدیدی را با multipart/form-data آپلود کنید. اطلاعات بیشتر دربارهٔ ارسال فایل: https://core.telegram.org/bots/api#sending-files |
| duration | Integer | اختیاری | مدت ویدیوی ارسالی به ثانیه |
| width | Integer | اختیاری | عرض ویدیو |
| height | Integer | اختیاری | ارتفاع ویدیو |
| thumbnail | InputFile or String | اختیاری | بندانگشتی فایل ارسالی؛ اگر سرور از تولید بندانگشتی برای فایل پشتیبانی کند می‌توان آن را نادیده گرفت. بندانگشتی باید با قالب JPEG و کمتر از ۲۰۰ کیلوبایت باشد. عرض و ارتفاع بندانگشتی نباید از ۳۲۰ بیشتر شود. اگر فایل با multipart/form-data آپلود نشود نادیده گرفته می‌شود. بندانگشتی‌ها قابل استفادهٔ دوباره نیستند و فقط به‌عنوان فایل جدید آپلود می‌شوند؛ بنابراین اگر بندانگشتی با multipart/form-data زیر نام <file_attach_name> آپلود شده، «attach://<file_attach_name>» بدهید. اطلاعات بیشتر دربارهٔ ارسال فایل: https://core.telegram.org/bots/api#sending-files |
| cover | InputFile or String | اختیاری | کاور ویدیو در پیام. برای ارسال فایلی که روی سرورهای تلگرام وجود دارد file_id بدهید (توصیه می‌شود)، برای اینکه تلگرام فایل را از اینترنت بگیرد آدرس HTTP بدهید، یا برای آپلود فایل جدید با multipart/form-data زیر نام <file_attach_name>، «attach://<file_attach_name>» بدهید. اطلاعات بیشتر دربارهٔ ارسال فایل: https://core.telegram.org/bots/api#sending-files |
| start_timestamp | Integer | اختیاری | زمان شروع ویدیو در پیام (برچسب زمانی) |
| caption | String | اختیاری | عنوان (caption) ویدیو (هنگام ارسال دوبارهٔ ویدیوها با file_id هم قابل استفاده است)؛ ۰ تا ۱۰۲۴ نویسه پس از تجزیهٔ موجودیت‌ها |
| parse_mode | String | اختیاری | حالت تجزیهٔ موجودیت‌ها در عنوان ویدیو. جزئیات بیشتر را در گزینه‌های قالب‌بندی ببینید. |
| caption_entities | Array of MessageEntity | اختیاری | فهرست JSON از موجودیت‌های ویژه‌ای که در عنوان آمده‌اند و می‌توان آن را به‌جای parse_mode داد. |
| show_caption_above_media | Boolean | اختیاری | اگر عنوان باید بالای رسانهٔ پیام نمایش داده شود، True بدهید. |
| has_spoiler | Boolean | اختیاری | اگر ویدیو باید با انیمیشن اسپویلر پوشانده شود، True بدهید. |
| supports_streaming | Boolean | اختیاری | اگر ویدیوی آپلودشده برای استریم مناسب است، True بدهید. |
| disable_notification | Boolean | اختیاری | پیام را بی‌صدا می‌فرستد. کاربران اعلانی بدون صدا دریافت می‌کنند. |
| protect_content | Boolean | اختیاری | محتوای پیام ارسالی را از فوروارد و ذخیره‌شدن محافظت می‌کند. |
| allow_paid_broadcast | Boolean | اختیاری | برای مجاز شدن ارسال تا ۱۰۰۰ پیام در ثانیه و نادیده‌گرفتن محدودیت‌های ارسال انبوه، با هزینهٔ ۰٫۱ ستارهٔ تلگرام برای هر پیام، True بدهید. ستارهٔ مربوط از موجودی ربات کسر می‌شود. |
| message_effect_id | String | اختیاری | شناسهٔ یکتای افکتی که به پیام اضافه می‌شود؛ فقط برای گفتگوهای خصوصی |
| suggested_post_parameters | SuggestedPostParameters | اختیاری | شیء سریالایز‌شده به JSON شامل پارامترهای پست پیشنهادی که باید فرستاده شود؛ فقط برای گفتگوهای پیام مستقیم. اگر پیام در پاسخ به یک پست پیشنهادی دیگر فرستاده شود، آن پست پیشنهادی به‌طور خودکار رد می‌شود. |
| reply_parameters | ReplyParameters | اختیاری | توضیحات پیامی که به آن پاسخ داده می‌شود. |
| reply_markup | InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply | اختیاری | گزینه‌های اضافی رابط. شیء سریالایز‌شده به JSON برای کیبورد اینلاین، کیبورد پاسخ سفارشی، دستور حذف کیبورد پاسخ یا اجبار به پاسخ از طرف کاربر. |