پرش به مطلب اصلی

Update

این شیء بیانگر یک آپدیت دریافتی است. برای هر اتفاق در گفتگوها و پیام های بازو یک آپدیت مجزا ایجاد می‌شود و هر آپدیت صرفا میتواند یک نوع داده را داشته باشد. حداکثر یکی از پارامترهای اختیاری می‌تواند در هر آپدیت داده شده وجود داشته باشد. به طور مثال یک آپدیت نمی تواند همزمان message و callback_query را داشته باشد.

📝 اسکیمای داده

فیلدنوعتوضیحات
update_idIntegerشناسه منحصربه‌فرد آپدیت. شناسه‌های آپدیت از صفر آغاز شده و به ترتیب افزایش می‌یابند. این ID مخصوصا زمانی به کار می‌آید که از وب‌هوک استفاده کنید، زیرا به شما اجازه می‌دهد که آپدیت‌های تکراری را نادیده گرفته و یا اگر از ترتیب خارج شده ‌باشند، دنباله آپدیت درست را بازیابی کنید.
messageMessageاختیاری. پیام‌ دریافتی جدید از هر نوعی – متن، تصویر، استیکر و غیره
edited_messageMessageاختیاری. نسخه ویرایش شده پیامی که در گذشته برای بازو ارسال شده است.
callback_queryCallbackQueryاختیاری. callback query دریافتی جدید.هنگامی که بر روی دکمه های inline پیام ها کلیک می شود، یک آپدیت دارای این فیلد ارسال می شود. فیلد data در شئ CallBackQuery برابر با مقداری است که هنگام تعریف دکمه مشخص می شود.

⚙️ متد‌های دریافت

getUpdateId()

شناسه منحصر به فرد به‌روزرسانی را بازیابی می‌کند.

$updateId = $updateObject->getUpdateId();

getMessage()

پیام جدید ورودی را بازیابی می‌کند اگر بخشی از به‌روزرسانی باشد. در صورت وجود، یک شیء پیام برمی‌گرداند.

$message = $updateObject->getMessage();

getEditedMessage()

نسخه جدید یک پیام ویرایش‌شده را بازیابی می‌کند اگر بخشی از به‌روزرسانی باشد. در صورت وجود، یک شیء پیام برمی‌گرداند.

$editedMessage = $updateObject->getEditedMessage();

getCallbackQuery()

پرسش بازگشتی جدید ورودی را بازیابی می‌کند اگر بخشی از به‌روزرسانی باشد. در صورت وجود، یک شیء CallbackQuery برمی‌گرداند.

$callbackQuery = $updateObject->getCallbackQuery();

➕ بیشتر

نکته

برای اطلاعات بیشتر، به مستندات رسمی بله مراجعه کنید.