getUpdates
متداز این متد برای دریافت آپدیت‌های ورودی با long polling (ویکی) استفاده کنید. آرایه‌ای از اشیای Update برمی‌گرداند.
خروجی: Array of Update
پارامترها
| نام | نوع | الزام | توضیحات |
|---|---|---|---|
| offset | Integer | اختیاری | شناسهٔ اولین آپدیتی که باید برگردانده شود. باید یک واحد از بزرگ‌ترین شناسهٔ آپدیت‌های قبلاً دریافت‌شده بیشتر باشد. به‌صورت پیش‌فرض، آپدیت‌ها از قدیمی‌ترین آپدیتِ تأییدنشده برگردانده می‌شوند. هر آپدیت به‌محض اینکه getUpdates با offsetی بزرگ‌تر از update_id آن صدا زده شود، تأییدشده محسوب می‌شود. می‌توان offset منفی داد تا آپدیت‌ها از -offsetامین آپدیت از انتهای صف دریافت شوند؛ در این حالت همهٔ آپدیت‌های قبلی فراموش می‌شوند. |
| limit | Integer | اختیاری | تعداد آپدیت‌هایی که دریافت می‌شود را محدود می‌کند. مقادیر ۱ تا ۱۰۰ پذیرفته است. پیش‌فرض ۱۰۰. |
| timeout | Integer | اختیاری | زمان انتظار (ثانیه) برای long polling. پیش‌فرض ۰ است، یعنی short polling معمولی. باید مثبت باشد؛ short polling فقط برای تست استفاده شود. |
| allowed_updates | Array of String | اختیاری | فهرست JSON از انواع آپدیتی که می‌خواهید ربات دریافت کند. مثلاً ["message", "edited_channel_post", "callback_query"] را بدهید تا فقط همین انواع را بگیرید. فهرست کامل انواع آپدیت را در Update ببینید. فهرست خالی یعنی همهٔ انواع آپدیت به‌جز chat_member، message_reaction و message_reaction_count (پیش‌فرض). اگر مشخص نشود، تنظیم قبلی استفاده می‌شود. توجه کنید این پارامتر روی آپدیت‌هایی که پیش از فراخوانی getUpdates ساخته شده‌اند اثر ندارد، بنابراین ممکن است برای مدت کوتاهی آپدیت‌های ناخواسته دریافت شود. |