Skip to content

اعضا و ادمین‌ها

add_members

این متد برای افزودن یک یا چند عضو به گروه یا کانال است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • members: یک GUID/نام‌کاربری یا لیستی از GUID/نام‌کاربری اعضا.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.add_members(
        "g0abc123...",
        members=["@User1", "@User2", "u0xyz789..."]
    )
    print(result)

ban_member

این متد برای مسدود کردن یک عضو از گروه یا کانال است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • member: GUID یا نام‌کاربری عضو مورد نظر.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.ban_member("g0abc123...", member="@SpamUser")
    print(result)

ban_members

این متد برای مسدود کردن چند عضو به صورت یکجا است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • members: لیستی از GUID یا نام‌کاربری اعضا.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.ban_members("g0abc123...", members=["@User1", "@User2"])
    print(result)

unban_member

این متد برای رفع مسدودیت یک عضو از گروه یا کانال است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • member: GUID یا نام‌کاربری عضو مورد نظر.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.unban_member("g0abc123...", member="@SpamUser")
    print(result)

unban_members

این متد برای رفع مسدودیت چند عضو به صورت یکجا است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • members: لیستی از GUID یا نام‌کاربری اعضا.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.unban_members("g0abc123...", members=["@User1", "@User2"])
    print(result)

unban_all_members

این متد برای رفع مسدودیت تمام اعضای مسدود شده یک گروه یا کانال به صورت یکجا است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • exclude: GUID یا نام‌کاربری اعضایی که نباید رفع مسدود شوند. (پیش‌فرض: None)

خروجی: یک شیء Data شامل status، total_banned، excluded و unbanned.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.unban_all_members("g0abc123...")
    print(result)

get_banned_members

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

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • show_member_guids: نمایش GUID اعضا در خروجی. (پیش‌فرض: False)

خروجی: یک شیء Data شامل members، total، chat_guid و (در صورت show_member_guids=True) member_guids.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    banned = app.get_banned_members("g0abc123...")
    print(banned)

clear_black_list

این متد برای پاک‌سازی لیست سیاه (رفع مسدودیت تمام اعضا) در یک گروه یا کانال است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • exclude: GUID یا نام‌کاربری اعضایی که نباید رفع مسدود شوند. (پیش‌فرض: None)

خروجی: یک شیء Data شامل status، total_banned، excluded و unbanned.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.clear_black_list("g0abc123...")
    print(result)

set_admin

این متد برای تنظیم یک عضو به عنوان ادمین در گروه یا کانال است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • member: GUID یا نام‌کاربری عضو.
  • access: لیست دسترسی‌های مجاز، یک دسترسی تکی، یا 'All'/'all' برای اعطای همه دسترسی‌ها.
    • گروه: SetAdmin, BanMember, ChangeInfo, PinMessages, SetJoinLink, SetMemberAccess, DeleteGlobalAllMessages
    • کانال: ChangeInfo, DeleteGlobalAllMessages, PinMessages, SetAdmin, ViewAdmins, SetJoinLink, AddMember, ViewMembers, SendMessages, EditAllMessages
  • custom_title: عنوان سفارشی برای ادمین (فقط گروه). (پیش‌فرض: خالی)

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.set_admin(
        "g0abc123...",
        member="@NewAdmin",
        access=["BanMember", "PinMessages", "ChangeInfo"],
        custom_title="مدیر ارشد"
    )
    print(result)

unset_admin

این متد برای حذف ادمینی یک عضو در گروه یا کانال است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • member: GUID یا نام‌کاربری عضو.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.unset_admin("g0abc123...", member="@OldAdmin")
    print(result)

member_is_admin

این متد برای بررسی ادمین بودن یک عضو در گروه یا کانال است. مقدار بازگشتی True یا False است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • member: GUID یا نام‌کاربری عضو.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    is_admin = app.member_is_admin("g0abc123...", member="@TestUser")
    print(is_admin)

change_owner

این متد برای درخواست انتقال مالکیت یک چت (گروه یا کانال) به کاربر دیگر است.

پارامترها:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.
  • new_owner: GUID یا نام‌کاربری مالک جدید. فقط کاربران (u0) مجاز هستند؛ بات‌ها قابل قبول نیستند.

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

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.change_owner("g0abc123...", new_owner="@NewOwner")
    print(result)

accept_ownership_request

این متد برای پذیرفتن درخواست انتقال مالکیت یک چت است.

پارامتر:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.accept_ownership_request("g0abc123...")
    print(result)

reject_ownership_request

این متد برای رد کردن درخواست انتقال مالکیت یک چت است.

پارامتر:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.reject_ownership_request("g0abc123...")
    print(result)

cancel_change_owner

این متد برای لغو درخواست انتقال مالکیت توسط مالک فعلی است.

پارامتر:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    result = app.cancel_change_owner("g0abc123...")
    print(result)

get_pending_owner

این متد برای دریافت اطلاعات مالک در انتظار (کسی که درخواست انتقال مالکیت برایش ارسال شده) است.

پارامتر:

  • chat: GUID، لینک یا نام‌کاربری گروه یا کانال.

مثال:

Python
from maxrubika import Shad

with Shad("mySession") as app:
    pending = app.get_pending_owner("g0abc123...")
    print(pending)