اطلاعات و دریافت چت

get_guid

این متد برای دریافت شناسه (GUID) یک کاربر، گروه، کانال یا بات از روی نام‌کاربری یا لینک است. این متد پایه‌ای و پرکاربرد است و بسیاری از متدهای دیگر از آن استفاده می‌کنند.

پارامتر:

chat: نام‌کاربری، لینک گروه (joing)، لینک کانال (joinc) یا خود GUID.

نکته: تفاوتی ندارد که نام‌کاربری با @ نوشته شود یا بدون آن.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        guid = app.get_guid("@Online_User")
        print(guid)

    except Exception as e:
        print(e)

get_my_guid

این متد برای دریافت شناسه (GUID) اکانت خود کاربر استفاده می‌شود.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        my_guid = app.get_my_guid()
        print(my_guid)

    except Exception as e:
        print(e)

get_info_by_username

این متد برای دریافت اطلاعات اولیه یک چت (کاربر، بات یا کانال) از طریق نام‌کاربری است.

پارامتر:

username: نام‌کاربری مورد نظر. (حداقل ۳ و حداکثر ۳۲ کاراکتر)

نکته: تفاوتی ندارد که نام‌کاربری با @ نوشته شود یا بدون آن.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        info = app.get_info_by_username("Online_User")
        print(info)

    except Exception as e:
        print(e)

get_info_by_link

این متد برای دریافت پیش‌نمایش اطلاعات گروه یا کانال از طریق لینک دعوت است.

پارامتر:

link: لینک دعوت. باید با https://rubika.ir/joing/ یا https://rubika.ir/joinc/ شروع شود.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        info = app.get_info_by_link("https://rubika.ir/joing/ABC123")
        print(info)

    except Exception as e:
        print(e)

get_chat_info

این متد جامع برای دریافت اطلاعات کامل یک چت (کاربر، گروه، کانال، بات یا سرویس) است. با تشخیص خودکار نوع چت، متد مناسب را فراخوانی می‌کند.

پارامتر:

chat: GUID، لینک یا نام‌کاربری چت.

نکته: این متد هوشمند است و بر اساس ورودی، به صورت خودکار از متدهای get_user_info، get_bot_info، get_channel_info، get_group_info یا get_service_info استفاده می‌کند.

مثال‌ها:

دریافت اطلاعات کاربر:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        info = app.get_chat_info("@Online_User")
        print(info)

    except Exception as e:
        print(e)

دریافت اطلاعات گروه از لینک:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        info = app.get_chat_info("https://rubika.ir/joing/ABC123")
        print(info)

    except Exception as e:
        print(e)

get_chats_info

این متد برای دریافت اطلاعات چند چت به صورت هم‌زمان با استفاده از GUID آنها است.

پارامتر:

chats: یک GUID یا لیستی از GUIDهای چت‌ها.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        info = app.get_chats_info(["u0abc123...", "g0xyz789...", "c0def456..."])
        print(info)

    except Exception as e:
        print(e)

get_chats

این متد برای دریافت لیست تمام چت‌های حساب کاربری است. به صورت خودکار تمام صفحات را پیمایش می‌کند.

پارامتر:

show_chat_guids: در صورت True بودن، GUID چت‌ها در خروجی نمایش داده می‌شود. (پیش‌فرض: False)

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        chats = app.get_chats()
        print(chats)

    except Exception as e:
        print(e)

get_chats_updates

این متد برای دریافت به‌روزرسانی‌های چت‌ها (مانند پیام‌های جدید، تغییرات و...) است.

پارامتر:

state: وضعیت زمانی برای دریافت به‌روزرسانی‌ها. (پیش‌فرض: ۱۵۰ ثانیه قبل از زمان فعلی)

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        updates = app.get_chats_updates()
        print(updates)

    except Exception as e:
        print(e)

get_related_chats

این متد برای دریافت چت‌های مرتبط با یک چت خاص (مانند گروه‌ها و کانال‌های مرتبط) است.

پارامتر:

chat: GUID، لینک یا نام‌کاربری چت.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        related = app.get_related_chats("g0abc123...")
        print(related)

    except Exception as e:
        print(e)

get_profile_link_items

این متد برای دریافت آیتم‌های لینک پروفایل یک چت است.

پارامتر:

chat: GUID، لینک یا نام‌کاربری چت.

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        items = app.get_profile_link_items("u0abc123...")
        print(items)

    except Exception as e:
        print(e)

get_chat_ads

این متد برای دریافت اطلاعات تبلیغاتی چت‌ها است.

پارامتر:

state: وضعیت زمانی برای فیلتر. (پیش‌فرض: ۱۵۰ ثانیه قبل از زمان فعلی)

مثال:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        ads = app.get_chat_ads()
        print(ads)

    except Exception as e:
        print(e)

search_global_chats

این متد برای جستجوی سراسری در میان چت‌ها (کاربران، کانال‌ها و...) بر اساس متن است.

پارامترها:

text: متن مورد جستجو.
filter_type: فیلتر نتایج بر اساس نوع. مقادیر قابل قبول: User، Channel، Bot یا لیستی از آن‌ها. (پیش‌فرض: None)
start_id: شناسه شروع برای صفحه‌بندی. (پیش‌فرض: None)

مثال‌ها:

جستجوی ساده:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        results = app.search_global_chats("برنامه‌نویس")
        print(results)

    except Exception as e:
        print(e)

جستجو با فیلتر نوع:

Python

from maxrubika import Messenger

with Messenger("mySession") as app:
    try:
        results = app.search_global_chats(
            "برنامه‌نویس",
            filter_type=["Channel", "Bot"]
        )
        print(results)

    except Exception as e:
        print(e)

بازگشت به صفحه قبل